bolsai-mcp is an MCP (Model Context Protocol) server that provides Brazilian financial market data to AI assistants. It connects AI assistants that support MCP, such as Claude and Cursor, enabling them to directly query quotes and indicators from the Brazilian market.
In terms of purpose, this server is aimed at users who need information on the Brazilian stock market, covering three types of official data sources: B3 (the Brazilian stock exchange), CVM (the Brazilian Securities and Exchange Commission), and BCB (the Central Bank of Brazil).
Its main capabilities include: querying stock prices; viewing fundamental data; querying dividends; covering more than 350 B3-listed stocks and more than 400 FIIs (real estate investment funds); providing 40 years of price history since 1986 (Pro version); more than 15 years of fundamental data since 2010; including 27 indicators, such as P/L, P/VP, EV/EBITDA, ROE, ROIC, and margins; in terms of macro data, it supports SELIC, IPCA, CDI, and the USD/BRL exchange rate. Data is updated daily from official sources.
How to use it: users first need to obtain a free API key at usebolsai.com. Then add the MCP server to the AI assistant's configuration - claude_desktop_config.json for Claude Desktop, and .mcp.json for Claude Code. After configuration is complete, users can ask questions directly in the conversation, such as "What price is PETR4 trading at now?" or "Compare PETR4 and VALE3."
Use cases include individual investors, financial analysts, or developers who want to quickly obtain Brazilian market quotes, fundamentals, dividends, and macro indicators in conversations with an AI assistant.
In terms of limitations: the free version allows 200 requests per day and includes only stock quotes, current fundamentals, and company search; the Pro version costs 49 reais per month, allows 10,000 requests per day, and opens all tools (including historical data, dividends, financial statements, and macro data). Specific installation code, complete configuration file contents, and other details not provided in the official materials are not yet available.
