MCP.Market

Bolsai MCP server

by viniciuslazzari·io.github.viniciuslazzari/bolsai-mcp·v0.1.4·1 stars
No reviews yet

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

B78/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
New

1 stars

Reviews

Write one

Nobody has reviewed Bolsai yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Bolsai tools (11)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • compare_stocks

    Compare fundamental indicators across multiple stocks side by side.

  • get_dividends

    Get dividend history with yield, annual summary, and individual payments.

  • get_fii_details

    Get FII (Real Estate Fund) details: P/VP, dividend yield, NAV, and distributions.

  • get_financial_statements

    Get raw CVM financial statements (income, balance sheet, cash flow).

  • get_fundamentals

    Get fundamental indicators: P/L, P/VP, EV/EBITDA, ROE, margins, debt ratios, and more.

  • get_macro_indicator

    Get Brazilian macroeconomic indicator data.

  • get_price_history

    Get historical OHLCV stock prices with adjusted values for splits and dividends.

  • get_stock_quote

    Get the current stock price with daily change, 52-week range, and YTD return.

  • list_sectors

    List all available sectors with company counts.

  • screen_stocks

    Screen ALL Brazilian stocks by fundamental metrics. Scans ~264 companies in one call.

  • search_companies

    Search for Brazilian listed companies by name or sector.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan6 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 81 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Bolsai compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
78/100
higher than 62% of 1,761 Finance servers
Tools
11
the typical Finance server has 8
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 946 Finance servers

What its tools let an agent do: 11 read

Install Bolsai in Claude Code, Cursor or VS Code

claude mcp add bolsai-mcp -- uvx bolsai-mcp
Add to Cursor

What the publisher says

From the Bolsai repository's README, as published. We do not edit it. Read it on GitHub

Bolsai - MCP Server

<!-- mcp-name: io.github.viniciuslazzari/bolsai-mcp -->

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
  1. Install:
pip install bolsai-mcp
  1. Add to Claude Desktop (claudedesktopconfig.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

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

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

Nothing above is checked by us. What we check is on the safety report.

Bolsai: common questions

Is Bolsai MCP server safe?
Mostly: it is graded B (78/100). Read the Bolsai safety report
How do I install Bolsai?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Bolsai need an API key?
Yes. The registry entry asks for BOLSAI_API_KEY.
Is Bolsai maintained?
The last commit was 120 days ago (2026-07-07). The latest release is v0.1.4.
What can I use instead of Bolsai?
Servers from other publishers that do the same job: Tapetide - Indian Stock Market MCP server, TickDB Market Data MCP server and Akshare One MCP server.
How does Bolsai compare with other Finance MCP servers?
safety score 78/100 (higher than 62% of 1,761 Finance servers); tools 11 (the typical Finance server has 8); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Bolsai

Same job from other publishers: the closest match first, then the best rated.

  • Tapetide - Indian Stock Market MCP
    48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
    A
  • TickDB Market Data
    Real-time & historical market data: forex, stocks, crypto, indices, metals, K-line, quotes
    B
  • Akshare One
    MCP server that provides access to Chinese stock market data using akshare-one
    A
  • Zwldarren Akshare One
    Provide access to Chinese stock market data including historical prices, real-time data, news, and…
    More from smithery.ai →
    A
  • Alpha Vantage
    Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators
    A