Server data from the Official MCP Registry
Brazilian stock market data (B3, CVM, BCB) for AI assistants: quotes, fundamentals, dividends, FIIs.
About
Brazilian stock market data (B3, CVM, BCB) for AI assistants: quotes, fundamentals, dividends, FIIs.
Security Report
The bolsai MCP server is well-structured with proper authentication, clean code quality, and permissions that appropriately match its purpose as a Brazilian financial data tool. The API key is correctly managed via environment variables, and no malicious patterns or code injection vulnerabilities are present. Minor code quality observations exist but do not impact security posture. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 8 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: BOLSAI_API_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-viniciuslazzari-bolsai-mcp": {
"env": {
"BOLSAI_API_KEY": "your-bolsai-api-key-here"
},
"args": [
"bolsai-mcp"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
Bolsai - MCP Server
Brazilian 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.
Quick Start
-
Get a free API key at usebolsai.com
-
Install:
pip install bolsai-mcp
- Add to Claude Desktop (
claude_desktop_config.json):
{
"mcpServers": {
"bolsai": {
"command": "uvx",
"args": ["bolsai-mcp"],
"env": {
"BOLSAI_API_KEY": "sk_your_key_here"
}
}
}
}
Or for Claude Code (.mcp.json):
{
"mcpServers": {
"bolsai": {
"command": "bolsai-mcp",
"env": {
"BOLSAI_API_KEY": "sk_your_key_here"
}
}
}
}
Tools
| Tool | Description | Example Prompt |
|---|---|---|
get_stock_quote | Current price, daily change, 52w range | "What's PETR4 trading at?" |
get_fundamentals | 27+ indicators: P/L, P/VP, ROE, margins | "Show me VALE3 fundamentals" |
compare_stocks | Side-by-side comparison of up to 5 stocks | "Compare PETR4 vs VALE3 vs ITUB4" |
get_dividends | Dividend yield, annual summary, payments | "What dividends did BBDC4 pay?" |
search_companies | Find companies by name or sector | "Find banks listed on B3" |
get_price_history | OHLCV prices since 1986 with adjustments | "PETR4 prices last month" |
get_fii_details | FII fundamentals + distributions | "Show me HGLG11" |
get_macro_indicator | SELIC, IPCA, CDI, USD/BRL | "What's the current SELIC rate?" |
get_financial_statements | Raw CVM income/balance/cash flow | "PETR4 income statement 2024" |
screen_stocks | Filter stocks by metrics | "Find stocks with DY > 8%" |
Example Conversations
"What's PETR4 trading at?"
PETR4
Price: R$ 36.19
Change: +R$ 0.53 (+1.49%)
Date: 2024-12-30
52-week: R$ 28.44 – R$ 42.15
YTD: +12.34%
"Compare PETR4 vs VALE3"
Comparison: PETR4 vs VALE3
Metric PETR4 VALE3
─────────────────────────────────────
P/L 4.89 5.23
P/VP 1.12 1.45
EV/EBITDA 3.21 3.87
ROE 33.20% 27.70%
Net Margin 24.50% 23.10%
DY 12.30% 9.90%
Price R$ 36.19 R$ 58.42
Data Coverage
- 350+ stocks listed on B3
- 400+ FIIs (Real Estate Investment Funds)
- 40 years of price history (since 1986)
- 15+ years of fundamentals (since 2010)
- 27 indicators including P/L, P/VP, EV/EBITDA, ROE, ROIC, margins
- Macro data: SELIC, IPCA, CDI, USD/BRL
- Updated daily from official sources (B3, CVM, BCB)
Configuration
| Environment Variable | Required | Default | Description |
|---|---|---|---|
BOLSAI_API_KEY | Yes | — | API key from usebolsai.com |
BOLSAI_BASE_URL | No | https://usebolsai.com/api/v1 | API base URL |
API Tiers
- Free: 200 requests/day. Stock quotes, current fundamentals, company search.
- Pro (R$ 49/month): 10,000 requests/day. All tools including history, dividends, financials, macro.
Development
cd mcp-server
pip install -e ".[dev]"
pytest
ruff check . && ruff format .
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.