{
  "markdown": "# Bolsai - MCP Server\n\n<!-- mcp-name: io.github.viniciuslazzari/bolsai-mcp -->\n\nBrazilian financial market data for AI assistants. Query stock prices, fundamentals, dividends, FIIs, and macro indicators from the Brazilian market (B3, CVM, BCB) directly from Claude.\n\n## Quick Start\n\n1. Get a free API key at [usebolsai.com](https://usebolsai.com)\n\n2. Install:\n```bash\npip install bolsai-mcp\n```\n\n3. Add to Claude Desktop (`claude_desktop_config.json`):\n```json\n{\n  \"mcpServers\": {\n    \"bolsai\": {\n      \"command\": \"uvx\",\n      \"args\": [\"bolsai-mcp\"],\n      \"env\": {\n        \"BOLSAI_API_KEY\": \"sk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nOr for Claude Code (`.mcp.json`):\n```json\n{\n  \"mcpServers\": {\n    \"bolsai\": {\n      \"command\": \"bolsai-mcp\",\n      \"env\": {\n        \"BOLSAI_API_KEY\": \"sk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | Description | Example Prompt |\n|------|-------------|----------------|\n| `get_stock_quote` | Current price, daily change, 52w range | \"What's PETR4 trading at?\" |\n| `get_fundamentals` | 27+ indicators: P/L, P/VP, ROE, margins | \"Show me VALE3 fundamentals\" |\n| `compare_stocks` | Side-by-side comparison of up to 5 stocks | \"Compare PETR4 vs VALE3 vs ITUB4\" |\n| `get_dividends` | Dividend yield, annual summary, payments | \"What dividends did BBDC4 pay?\" |\n| `search_companies` | Find companies by name or sector | \"Find banks listed on B3\" |\n| `get_price_history` | OHLCV prices since 1986 with adjustments | \"PETR4 prices last month\" |\n| `get_fii_details` | FII fundamentals + distributions | \"Show me HGLG11\" |\n| `get_macro_indicator` | SELIC, IPCA, CDI, USD/BRL | \"What's the current SELIC rate?\" |\n| `get_financial_statements` | Raw CVM income/balance/cash flow | \"PETR4 income statement 2024\" |\n| `screen_stocks` | Filter stocks by metrics | \"Find stocks with DY > 8%\" |\n\n## Example Conversations\n\n**\"What's PETR4 trading at?\"**\n```\nPETR4\nPrice: R$ 36.19\nChange: +R$ 0.53 (+1.49%)\nDate: 2024-12-30\n52-week: R$ 28.44 – R$ 42.15\nYTD: +12.34%\n```\n\n**\"Compare PETR4 vs VALE3\"**\n```\nComparison: PETR4 vs VALE3\n\nMetric              PETR4       VALE3\n─────────────────────────────────────\nP/L                  4.89        5.23\nP/VP                 1.12        1.45\nEV/EBITDA            3.21        3.87\nROE                33.20%      27.70%\nNet Margin         24.50%      23.10%\nDY                 12.30%       9.90%\nPrice           R$ 36.19    R$ 58.42\n```\n\n## Data Coverage\n\n- **350+ stocks** listed on B3\n- **400+ FIIs** (Real Estate Investment Funds)\n- **40 years** of price history (since 1986)\n- **15+ years** of fundamentals (since 2010)\n- **27 indicators** including P/L, P/VP, EV/EBITDA, ROE, ROIC, margins\n- **Macro data**: SELIC, IPCA, CDI, USD/BRL\n- **Updated daily** from official sources (B3, CVM, BCB)\n\n## Configuration\n\n| Environment Variable | Required | Default | Description |\n|---------------------|----------|---------|-------------|\n| `BOLSAI_API_KEY` | Yes | — | API key from usebolsai.com |\n| `BOLSAI_BASE_URL` | No | `https://usebolsai.com/api/v1` | API base URL |\n\n## API Tiers\n\n- **Free**: 200 requests/day. Stock quotes, current fundamentals, company search.\n- **Pro** (R$ 49/month): 10,000 requests/day. All tools including history, dividends, financials, macro.\n\n## Development\n\n```bash\ncd mcp-server\npip install -e \".[dev]\"\npytest\nruff check . && ruff format .\n```\n\n## License\n\nMIT\n",
  "bytes": 3361,
  "sha": "e2d407e88ea3542b54a7725318d9b49073256dc94f51ef64ecd1d062ef314719",
  "repo_slug": "viniciuslazzari/bolsai-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_viniciuslazzari_bolsai_mcp_d54bce9f/readme"
}