Bolsai
@viniciuslazzari
About Bolsai
MCP server for bolsai — Brazilian stock market data (B3, CVM, BCB) for Claude, Cursor, and other AI assistants
Basic information
Category
Finance & Commerce
License
MIT
Runtime
python
Transports
stdio
Publisher
viniciuslazzari
Submitted by
Vinícius Lazzari
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"bolsai": {
"command": "uvx",
"args": [
"bolsai-mcp"
],
"env": {
"BOLSAI_API_KEY": "sk_your_key_here"
}
}
}
}Tools
10Current price, daily change, 52w range
27+ indicators: P/L, P/VP, ROE, margins
Side-by-side comparison of up to 5 stocks
Dividend yield, annual summary, payments
Find companies by name or sector
OHLCV prices since 1986 with adjustments
FII fundamentals + distributions
SELIC, IPCA, CDI, USD/BRL
Raw CVM income/balance/cash flow
Filter stocks by metrics
Overview
What is Bolsai?
Bolsai provides Brazilian financial market data for AI assistants. It allows querying stock prices, fundamentals, dividends, FIIs, and macro indicators from the Brazilian market (B3, CVM, BCB) directly from Claude.
How to use Bolsai?
Obtain a free API key at usebolsai.com, then install the package with pip install bolsai-mcp. Add the server to Claude Desktop (claude_desktop_config.json) or Claude Code (.mcp.json) with the command uvx bolsai-mcp and set the environment variable BOLSAI_API_KEY to your key.
Key features of Bolsai
- 10+ tools covering quotes, fundamentals, dividends, and FIIs
- 27 financial indicators including P/L, P/VP, ROE, and margins
- Covers 350+ stocks and 400+ FIIs listed on B3
- 40 years of price history since 1986
- 15+ years of fundamentals data since 2010
- Macro indicators: SELIC, IPCA, CDI, USD/BRL
Use cases of Bolsai
- Get a real-time stock quote with daily change and 52-week range
- Compare up to five stocks side-by-side on key metrics
- Search for companies by name or sector on B3
- Screen stocks by criteria like dividend yield above 8%
- Retrieve income statements or balance sheets for a given year
FAQ from Bolsai
Where do I get an API key?
Get a free API key at usebolsai.com. It is required to use the server.
What data sources does Bolsai use?
Data comes from official Brazilian sources: B3 (stock exchange), CVM (securities commission), and BCB (central bank). It is updated daily.
What are the rate limits and pricing tiers?
The free tier allows 200 requests per day for stock quotes, current fundamentals, and company search. Pro (R$ 49/month) permits 10,000 requests/day and unlocks all tools including history, dividends, and macro data.
Does Bolsai require any runtime dependencies?
It is a Python package. Install via pip (or uvx) and requires Python 3. The only required environment variable is BOLSAI_API_KEY.
How is authentication handled?
Authentication uses an API key passed as the BOLSAI_API_KEY environment variable in the server configuration. The key is issued at usebolsai.com.
More Finance & Commerce MCP servers
AI看线 - A股技术分析与AI预测工具
QuantML-GithubPython-based stock analysis tool that combines traditional technical analysis with AI prediction capabilities. Providing comprehensive stock analysis and forecasting using K-line charts, technical indicators, financial data, and news data. With CMD/WEB/MCP supported.
Awesome Crypto MCP Servers
badkkA collection of crypto MCP servers.
Octagon: MCP for Market Data
OctagonAIAn MCP server for public & prediction markets research. Ask natural-language questions and get structured, source-backed answers across SEC filings, earnings transcripts, company financials, stock & crypto market data, and prediction markets news & research. Built for investors,
Armor Crypto MCP
armorwalletThe MCP server for interacting with Blockchain, Swaps, Strategic Planning and more.
Financial Modeling Prep MCP (Model Context Protocol)
imbenrabiA Model Context Protocol (MCP) implementation for Financial Modeling Prep, enabling AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights.
Comments