English Français العربية

io.github.viniciuslazzari/bolsai-mcp

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package bolsai-mcp
Claude Code 
claude mcp add bolsai-mcp -e 'BOLSAI_API_KEY=<your bolsai_api_key>' -- uvx bolsai-mcp==0.1.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bolsai-mcp": {
            "command": "uvx",
            "args": [
                "bolsai-mcp==0.1.4"
            ],
            "env": {
                "BOLSAI_API_KEY": "<your bolsai_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • BOLSAI_API_KEY إلزامي سري Your bolsai API key (free tier available at usebolsai.com)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Bolsai - MCP Server
  2. Quick Start
  3. Tools
  4. Example Conversations
  5. Data Coverage
  6. Configuration
  7. API Tiers
  8. Development
  9. License

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
  3. 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):

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

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

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

License

MIT

الأسئلة الشائعة

ما هو io.github.viniciuslazzari/bolsai-mcp؟

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

كيف أثبّت io.github.viniciuslazzari/bolsai-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add bolsai-mcp -e 'BOLSAI_API_KEY=<your bolsai_api_key>' -- uvx bolsai-mcp==0.1.4. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.viniciuslazzari/bolsai-mcp إلى مفتاح API؟

نعم. يتطلب BOLSAI_API_KEY، وتضبطها في إعداداته.

هل io.github.viniciuslazzari/bolsai-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.viniciuslazzari/bolsai-mcp؟

ينشره viniciuslazzari. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.