Bolsai Mcp

io.github.viniciuslazzari由 GitHub 帳號 viniciuslazzari 發布v0.1.4更新於 Oct 24, 2026

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

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

本機 MCP 伺服器，為 AI 助理提供巴西市場資料（B3、CVM、BCB）：行情、基本面、股利、FII 與總體指標。

可以做什麼
  • 查詢股票即時行情、自 1986 年以來的價格歷史，並依名稱或產業搜尋公司
  • 取得含 27 項以上指標的基本面資料，以及 CVM 原始財務報表
  • 最多五檔股票並列比較，並依股利殖利率等指標篩選股票
  • 查看股利紀錄與 FII 詳情，包含配息
  • 讀取 SELIC、IPCA、CDI、USD/BRL 等總體指標
適用情境
適合需要回答巴西上市公司、不動產投資基金或巴西總體資料問題的情境，例如行情查詢、估值比較、股利歷史或選股篩選。面向關注巴西市場而非全球股票的使用者。
執行需求
透過 stdio 在本機執行，從 PyPI 安裝（pip install bolsai-mcp）或以 uvx 啟動。需設定環境變數 BOLSAI_API_KEY（於供應商網站取得），可選 BOLSAI_BASE_URL 覆寫 API 位址。需要連線至供應商 API 的網路。免費額度為每日 200 次請求；歷史、股利、財報與總體工具需付費 Pro 方案。
安裝前請注意
API 金鑰以環境變數 BOLSAI_API_KEY 傳入，應避免寫入共用設定檔。查詢內容與股票代碼會傳送至供應商 API。免費額度每日僅 200 次請求，完整工具需付費訂閱（每月 49 雷亞爾）。資料僅供參考，不構成投資建議。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Bolsai Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源：README.md，提交 eadbda3

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.4最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分