Bullrundata Market Intelligence

市場インテリジェンス MCP サーバー

景気後退確率、セクターローテーション、機関投資家のポジション、マクロの連鎖シナリオ分析、不動産計算ツール、リアルタイムの経済データを、Claude、ChatGPT、Cursor、その他あらゆる MCP クライアントで利用できます。

BullrunData API を利用しています。

クイックスタート（ホステッド版 — 推奨）

ホステッドエンドポイント https://bullrundata.com/api/mcp を使うのが最も手軽です。インストール不要で自動更新され、以下のすべての MCP クライアントが標準で対応しています。

Bullrundata.com で無料の API キーを取得できます。1 日あたり 100 回の呼び出しが可能で、クレジットカードは不要です。

Claude Code

claude mcp add --transport http bullrundata https://bullrundata.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor

~/.cursor/mcp.json（またはプロジェクトローカルの .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "bullrundata": {
      "url": "https://bullrundata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

.vscode/mcp.json（ワークスペース）またはユーザーの mcp.json に追加します。

{
  "servers": {
    "bullrundata": {
      "type": "http",
      "url": "https://bullrundata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "bullrundata": {
      "serverUrl": "https://bullrundata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

Claude Desktop はまだ HTTP MCP にネイティブ対応していないため、mcp-remote を介して接続します。claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "bullrundata": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://bullrundata.com/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

ヘッダーを完全に省略することもできます。初回接続時に mcp-remote がブラウザーで OAuth フローを開き、無料プランのキーを自動的に発行します。

{
  "mcpServers": {
    "market-intelligence": {
      "command": "npx",
      "args": ["-y", "@bullrundata/market-intelligence"],
      "env": {
        "BULLRUNDATA_API_KEY": "your-api-key"
      }
    }
  }
}

claude mcp add market-intelligence -- npx -y @bullrundata/market-intelligence

利用可能なツール

マクロインテリジェンス

市場・機関投資家

不動産計算ツール

経済データ

カスケードエンジン（マクロシナリオ分析）

利用可能な触媒： 石油供給ショック、ドル流動性逼迫、FRBの緊急利下げ、米国の景気後退、中国・台湾情勢の緊迫化、イールドカーブの逆転、信用市場の凍結、新興国通貨危機、貿易戦争の激化、ソブリン債務危機

会話の例

「現在の景気後退リスクはどの程度ですか？」

Claude は recession_probability を使用して、次のように返します：

現在の景気後退確率は37.9％（中程度のリスク）です。FRBの姿勢：中立。市場局面：中期。推奨事項：シグナルが入り混じっているため、慎重さが必要です。ディフェンシブ銘柄へのローテーションを始めましょう。

「45万ドルの投資用物件を購入するのによいタイミングですか？」

Claude は investment_property_analysis と interest_rates を使用して、次のように返します：

45万ドルの物件に20％の頭金を入れ、金利7％で購入した場合、月次キャッシュフローは287ドルです。キャップレート：5.3％。キャッシュオンキャッシュリターン：4.2％。DSCR：1.18（健全）。現在の30年固定住宅ローン金利：6.38％。

「市場のリスクオン／リスクオフのシグナルは何ですか？」

Claude は sectors_rotation と institutional_cftc を使用して、次のように返します：

セクターローテーションのシグナル：RISK_ON。景気敏感セクターが先行し、ディフェンシブセクターが後れを取っています。機関投資家のポジションもリスク選好と一致しています。戦略：景気敏感セクターをオーバーウェイトに保ち、ローテーションの崩れに注意しましょう。

「原油価格が120ドルになったらどうなりますか？」

Claude は cascade_analysis と sectors_rotation を使用して、次のように返します：

石油供給ショックのカスケード：ドル需要が急増（機械的）-> アジアの外貨準備が減少（可能性が高い、数週間）-> アジア株から資金流出（可能性が高い）-> アジアで強制的な利上げ（可能性あり、数か月）。現在のセクターローテーション：RISK_ONですが、エネルギーセクターが後れを取っていることから、市場はまだ供給リスクを織り込んでいないようです。戦略：インフレヘッジと現金準備。システミックリスクのシグナルとして、FRBのスワップライン利用状況を確認しましょう。

設定

ホスト型エンドポイントでは、クライアント設定でBearerヘッダーとして認証情報を渡す（上記のクイックスタートを参照）か、初回接続時にOAuthで認証します。環境変数は不要です。

ローカルの npx インストールの場合：

料金

トラブルシューティング

インストール後、Claude にツールが表示されない

1. MCP サーバーが登録されていることを確認します。Claude Desktop では 設定 → コネクター（または 開発者）で market-intelligence を確認してください。Claude Code では claude mcp list を実行します。
2. Claude Desktop を完全に再起動します（ウィンドウを閉じるだけでなく、終了します）。コネクターの変更はホットリロードされません。
3. BULLRUNDATA_API_KEY 環境変数が設定され、有効であることを確認します。設定されていない場合、ツールは最初の呼び出し時に失敗します。
4. リモートサーバー（https://market.bullrundata.com/mcp）に直接接続する場合、ブラウザーで認証を求められたらOAuthフローを完了してください。Claude がツールを呼び出すには、ベアラートークンが必要です。

ツールからの 401 Unauthorized

APIキーがないか、期限切れ、または無効です。bullrundata.com/login で新しいキーを取得してください。リモートサーバー経由の場合は、OAuth画面から再認証してください。コネクターは初回接続時に無料プランのキーを自動で発行します。

429 Too Many Requests

1日のレート制限に達しました。制限は00:00 UTCにリセットされます。

bullrundata.com/pricing でプランをアップグレードするか、UTCのリセットをお待ちください。

OAuth フローが停止する、またはタイムアウトする（リモートサーバー）

リモートサーバーでは GitHub OAuth を使用します。リダイレクトが停止する場合は、次の点を確認してください。

1. market.bullrundata.com と claude.ai の Cookie とポップアップが許可されていることを確認します
2. シークレットウィンドウで認証を試します（キャッシュされた OAuth の状態がクリアされます）
3. ブラウザーで https://market.bullrundata.com/.well-known/oauth-authorization-server が 200 を返すことを確認します

最初のリクエストが遅い（約 2～4 秒）

サーバーレス環境へのデプロイにおけるコールドスタートの遅延です。同じセッション内の後続のリクエストは、500 ミリ秒未満で応答するはずです。

cascade_analysis が「live data unavailable」を返す

cascade ツールでは、BullrunData のライブ市場データを任意で追加できます。上流 API に一時的に接続できない場合でも、カタリストツリー全体は取得でき、ライブデータの重ね合わせだけがスキップされます。ライブデータの取得を完全にスキップするには、include_live_data: false を指定してください。

ツールが古いデータを返す

経済指標は 1 日に複数回更新されます。最後に更新された時刻は、dashboard_summary の data_freshness で確認してください。

それでも解決しない場合

GitHub Issues で問題を報告するか、[email protected] に、ツール名、エラーメッセージ全文、おおよその発生時刻を添えてメールしてください。

サポート

• ウェブサイト：bullrundata.com
• ドキュメント：bullrundata.com/docs
• 問題報告：GitHub Issues

ライセンス

Elastic License 2.0 — 詳細は LICENSE をご覧ください。

このソフトウェアは使用、変更、再配布できます。ただし、ユーザーがこのソフトウェアの機能の相当部分にアクセスできるホスト型またはマネージド型サービスとして提供することはできません。