financebrazilstocksmarket-data
MCP server for Brazilian B3, FII, company, dividend, and macroeconomic market data.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Check current B3 stock prices and daily changes
Compare company fundamentals and valuation metrics
Review dividends and FII distributions
Screen stocks by financial indicators
Query SELIC, IPCA, CDI, and USD/BRL data
Key features
Current stock quotes and 52-week ranges
27+ fundamental indicators
Dividend and FII distribution data
Historical OHLCV prices since 1986
CVM financial statements
Brazilian macroeconomic indicators
Capabilities & Tool Schemas (10)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Bolsai MCP.
get_stock_quoteCurrent price, daily change, 52w range
get_fundamentals27+ indicators: P/L, P/VP, ROE, margins
compare_stocksSide-by-side comparison of up to 5 stocks
get_dividendsDividend yield, annual summary, payments
search_companiesFind companies by name or sector
get_price_historyOHLCV prices since 1986 with adjustments
Documentation Overview
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:
- Add to Claude Desktop (
claude_desktop_config.json):
Or for Claude Code (.mcp.json):
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?"
"Compare PETR4 vs VALE3"
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
License
MIT
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
Last commit
2mo ago
Most recent push to the default branch.
Tools exposed
10
Callable tools this server registers over MCP.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Bolsai MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/viniciuslazzari-bolsai-mcp)HTML Embed
<a href="https://allmcps.com/mcp/viniciuslazzari-bolsai-mcp"><img src="https://allmcps.com/api/badge/viniciuslazzari-bolsai-mcp?style=directory" alt="Bolsai MCP on AllMCPs" /></a>Technical Specs & Signals
CategoryFinance & Fintech
PricingFreemium
53Quality signal: Good · 53/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools28/30
Adoption & activity2/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 21d ago via OSV.dev · bolsai-mcp (PyPI)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.