Bolsai Mcp

io.github.viniciuslazzariPublished by GitHub account viniciuslazzariv0.1.4Updated Oct 24, 2026

Brazilian stock market data (B3, CVM, BCB) for AI assistants: quotes, fundamentals, dividends, FIIs.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local MCP server giving AI assistants Brazilian market data from B3, CVM and BCB: quotes, fundamentals, dividends, FIIs and macro indicators.

What you can do
  • Look up current stock quotes, price history since 1986 and company search by name or sector
  • Retrieve fundamentals with 27+ indicators and raw CVM financial statements
  • Compare up to five stocks side by side and screen stocks by metrics such as dividend yield
  • Check dividends and FII details, including distributions
  • Read macro indicators such as SELIC, IPCA, CDI and USD/BRL
When to use it
Useful when an assistant needs to answer questions about Brazilian listed companies, real estate funds or Brazilian macro data, for example quotes, valuation comparisons, dividend history or screening. It is aimed at users working with the Brazilian market rather than global equities.
Requirements
Runs locally over stdio, installed from PyPI (pip install bolsai-mcp) or launched with uvx. Requires a BOLSAI_API_KEY environment variable from the provider's site; an optional BOLSAI_BASE_URL overrides the API endpoint. Network access to the provider's API is needed. The free tier allows 200 requests per day; history, dividends, financials and macro tools require the paid Pro tier.
Before you install
The API key is passed as the BOLSAI_API_KEY environment variable and should be kept out of shared config files. Queries and tickers are sent to the provider's API. The free tier is limited to 200 requests per day, and full tool access requires a paid subscription (R$ 49/month). Data is informational market data, not investment advice.

Installation

In SourceWeft

  1. Open Bolsai Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

  1. Get a free API key at usebolsai.com

  2. Install:

bash
pip install bolsai-mcp
  1. Add to Claude Desktop (claude_desktop_config.json):
json
{  "mcpServers": {    "bolsai": {      "command": "uvx",      "args": ["bolsai-mcp"],      "env": {        "BOLSAI_API_KEY": "sk_your_key_here"      }    }  }}

Or for Claude Code (.mcp.json):

json
{  "mcpServers": {    "bolsai": {      "command": "bolsai-mcp",      "env": {        "BOLSAI_API_KEY": "sk_your_key_here"      }    }  }}

Tools

ToolDescriptionExample Prompt
get_stock_quoteCurrent price, daily change, 52w range"What's PETR4 trading at?"
get_fundamentals27+ indicators: P/L, P/VP, ROE, margins"Show me VALE3 fundamentals"
compare_stocksSide-by-side comparison of up to 5 stocks"Compare PETR4 vs VALE3 vs ITUB4"
get_dividendsDividend yield, annual summary, payments"What dividends did BBDC4 pay?"
search_companiesFind companies by name or sector"Find banks listed on B3"
get_price_historyOHLCV prices since 1986 with adjustments"PETR4 prices last month"
get_fii_detailsFII fundamentals + distributions"Show me HGLG11"
get_macro_indicatorSELIC, IPCA, CDI, USD/BRL"What's the current SELIC rate?"
get_financial_statementsRaw CVM income/balance/cash flow"PETR4 income statement 2024"
screen_stocksFilter stocks by metrics"Find stocks with DY > 8%"

Example Conversations

"What's PETR4 trading at?"

PETR4Price: R$ 36.19Change: +R$ 0.53 (+1.49%)Date: 2024-12-3052-week: R$ 28.44 – R$ 42.15YTD: +12.34%

"Compare PETR4 vs VALE3"

Comparison: PETR4 vs VALE3
Metric              PETR4       VALE3─────────────────────────────────────P/L                  4.89        5.23P/VP                 1.12        1.45EV/EBITDA            3.21        3.87ROE                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 VariableRequiredDefaultDescription
BOLSAI_API_KEYYes—API key from usebolsai.com
BOLSAI_BASE_URLNohttps://usebolsai.com/api/v1API 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

bash
cd mcp-serverpip install -e ".[dev]"pytestruff check . && ruff format .

License

MIT

Source: README.md at commit eadbda3

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.4LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts