Skip to main content
Glama
viniciuslazzari

Bolsai

by viniciuslazzari
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

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:

pip install bolsai-mcp

  1. Add to Claude Desktop (claude_desktop_config.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"
      }
    }
  }
}

Related MCP server: MCP-Server-Financial-Analyzer

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?"

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

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

cd mcp-server
pip install -e ".[dev]"
pytest
ruff check . && ruff format .

License

MIT

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
3Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • Financial Modeling Prep MCP

    vijitdaroch
    A
    license
    -
    quality
    D
    maintenance
    Provides AI assistants with access to comprehensive financial data including real-time stock quotes, company fundamentals, financial statements, market analysis, SEC filings, and economic indicators through 253+ tools across 24 categories.
    853
    Apache 2.0
  • InvestSights Indian Stock Research MCP by InvestSights

    InvestSights Indian Stockofficial

    InvestSights
    A
    license
    -
    quality
    C
    maintenance
    Enables AI assistants to perform deep Indian stock research with fundamentals, forensic scores, DCF valuation, screening, and news for 6000+ NSE/BSE stocks.
    15
    1
    MIT

  • big-mcp-b3

    danielvm-git
    A
    license
    B
    quality
    C
    maintenance
    MCP server for B3 (Brazilian stock exchange) data, offering tools for real-time quotes, historical prices, dividends, FIIs, fundamental analysis, options, and indices via natural language.
    9
    MIT

View all related MCP servers

Related MCP Connectors

  • Mercado Financeiro BR

    Brazilian financial market data (B3): quotes, fundamentals, dividends, REITs (FIIs), BDRs, crypto, F

  • Dados B3

    Brazilian stock (B3) fundamentals: ratios, multiples, dividends, scores. Public methodology.

  • Meelion MCP

    Brazilian fixed income & financial data for AI. Selic, CDI, IPCA, CDB/LCI/LCA rankings, FX rates.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/viniciuslazzari/bolsai-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server