Bolsai

Bolsai - MCP サーバー

AI アシスタント向けのブラジル金融市場データです。Claude から直接、ブラジル市場（B3、CVM、BCB）の株価、ファンダメンタルズ、配当、FII、マクロ指標を照会できます。

クイックスタート

1. usebolsai.com で無料の API キーを取得します

2. インストールします：

pip install bolsai-mcp

3. Claude Desktop に追加します（claude_desktop_config.json）：

{
  "mcpServers": {
    "bolsai": {
      "command": "uvx",
      "args": ["bolsai-mcp"],
      "env": {
        "BOLSAI_API_KEY": "sk_your_key_here"
      }
    }
  }
}

または、Claude Code の場合（.mcp.json）：

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

ツール

ツール	説明	プロンプトの例
get_stock_quote	現在の価格、日次変動、52週のレンジ	「PETR4 の現在の取引価格は？」
get_fundamentals	27以上の指標：P/L、P/VP、ROE、利益率	「VALE3 のファンダメンタルズを表示して」
compare_stocks	最大5銘柄の並列比較	「PETR4、VALE3、ITUB4 を比較して」
get_dividends	配当利回り、年間概要、支払い	「BBDC4 はどのような配当を支払った？」
search_companies	名前またはセクターから企業を検索	「B3 に上場している銀行を検索して」
get_price_history	1986年以降の調整済み OHLCV 価格	「先月の PETR4 の株価」
get_fii_details	FII のファンダメンタルズと分配金	「HGLG11 を表示して」
get_macro_indicator	SELIC、IPCA、CDI、USD/BRL	「現在の SELIC 金利は？」
get_financial_statements	CVM の損益計算書・貸借対照表・キャッシュフローの生データ	「PETR4 の2024年の損益計算書」
screen_stocks	指標で株式を絞り込み	「DY が8％を超える株式を検索して」

会話の例

「PETR4 の現在の取引価格は？」

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%

「PETR4 と 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

データの対象範囲

• 350以上の株式が B3 に上場
• 400以上の FII（不動産投資ファンド）
• 40年分の株価履歴（1986年以降）
• 15年以上のファンダメンタルズ（2010年以降）
• P/L、P/VP、EV/EBITDA、ROE、ROIC、利益率などの27指標
• マクロデータ：SELIC、IPCA、CDI、USD/BRL
• 公式ソース（B3、CVM、BCB）から毎日更新

設定

環境変数	必須	デフォルト	説明
BOLSAI_API_KEY	はい	—	usebolsai.com の API キー
BOLSAI_BASE_URL	いいえ	https://usebolsai.com/api/v1	API のベース URL

API プラン

• Free：1日あたり200リクエスト。株価、現在のファンダメンタルズ、企業検索。
• Pro（月額 R$ 49）：1日あたり10,000リクエスト。履歴、配当、財務データ、マクロを含むすべてのツール。

開発

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

ライセンス

MIT