Octagon: MCP for Market Data

Octagon：公開市場および予測市場インテリジェンス向け MCP

Octagon MCP サーバーは、Octagon Market Intelligence API と連携し、専門的な AI 搭載の金融リサーチと分析を提供します。これにより、Claude Desktop やその他の人気の MCP クライアントで、公開書類、決算説明会、財務指標、株式・暗号資産データ、株式ニュース、予測市場のニュースやリサーチを分析し、知見を抽出できます。

ツール

✅ octagon-agent は幅広い市場インテリジェンス分析を統括します

• 公開市場のインサイト：SEC 提出書類（10-K、10-Q、20-F、8-K、S-1、13-F、DEF 14A）、決算説明会の書き起こし
• 株式・暗号資産の市場データ：株式取引、暗号資産の取引データ、ニュース、プレスリリース、所有者および保有資産

✅ 包括的な詳細リサーチ向けの octagon-deep-research-agent

• 投資リサーチの質問に対する複数ソースの統合
• 最新情報に基づく、複数ソースを横断したテーマ分析に最適です

✅ 予測市場リサーチツール

• 各予測市場の最新リサーチレポートを提供する octagon-prediction-markets-agent
• 構造化された過去の市場データを取得する prediction_markets_history

✅ Octagon のドキュメントにリアルタイムでアクセス

• octagon-docs-search、octagon-docs-read、octagon-docs-list、octagon-docs-refresh
• octagon-docs://catalog、octagon-docs://status、octagon-docs://page/{target} の MCP リソース

Octagon API キーの取得

Octagon MCP を使用するには、次の手順が必要です。

1. Octagon で無料アカウントに登録します
2. ログイン後、左側のメニューから API Keys に移動します
3. 新しい API キーを生成します
4. この API キーを設定の OCTAGON_API_KEY 値として使用します

前提条件

Octagon MCP のインストールまたは実行の前に、システムに npx（Node.js と npm に付属）がインストールされている必要があります。

Mac（macOS）

1. Homebrew をインストールします（まだインストールされていない場合）：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. Node.js（npm および npx を含む）をインストールします：

   brew install node
   

   これにより、最新バージョンの Node.js、npm、npx がインストールされます。

3. インストールを確認します：

   node -v
   npm -v
   npx -v
   

Windows

1. Node.js インストーラーをダウンロードします：
   • https://nodejs.org/ にアクセスし、Windows 用の LTS バージョンをダウンロードします。
2. インストーラーを実行し、画面の指示に従います。Node.js、npm、npx がインストールされます。
3. インストールを確認します： コマンドプロンプトを開き、次を実行します：

   node -v
   npm -v
   npx -v
   

3 つすべてのバージョン番号が表示されれば、以下のインストール手順に進む準備ができています。

インストール

Claude Desktop での実行

Claude Desktop 用に Octagon MCP を設定するには：

1. Claude Desktop を開きます
2. Settings > Developer > Edit Config に移動します
3. claude_desktop_config.json に次の内容を追加します（your-octagon-api-key を Octagon API キーに置き換えてください）：

{
  "mcpServers": {
    "octagon-mcp-server": {
      "command": "npx",
      "args": ["-y", "octagon-mcp@latest"],
      "env": {
        "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

4. 変更を反映するため、Claude を再起動します

Cursor での実行

Cursor Desktop の設定 🖥️ 注：Cursor バージョン 0.45.6 以降が必要です

Cursor で Octagon MCP を設定するには：

1. Cursor の設定を開きます
2. Features > MCP Servers に移動します
3. 「+ Add New MCP Server」をクリックします
4. 次の情報を入力します：
   • Name：「octagon-mcp」（または任意の名前）
   • Type：「command」
   • Command：env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp

Windows を使用していて問題が発生する場合は、cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp" をお試しください

your-octagon-api-key を Octagon API キーに置き換えてください。

追加後、MCP サーバーの一覧を更新すると、新しいツールが表示されます。Composer Agent は適切な場合に Octagon MCP を自動的に使用しますが、投資調査のニーズを説明して明示的にリクエストすることもできます。Command+L（Mac）で Composer にアクセスし、送信ボタンの横にある「Agent」を選択して、クエリを入力します。

npx での実行

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

手動インストール

npm install -g octagon-mcp

ドキュメント

Octagon エージェントの使用に関する包括的なドキュメントについては、公式ドキュメントをご覧ください： https://octagonai.co/docs/

ドキュメントには以下が含まれます：

• 詳細な API リファレンス
• エージェント固有のクエリガイドライン
• 例とユースケース
• 投資調査のベストプラクティス

最新のホスト型 MCP クライアント設定ガイドについては、以下をご覧ください：

• Octagon MCP サーバーガイド
• Octagon Claude プラグインガイド
• Octagon エージェントガイド

この MCP サーバーは、ライブドキュメントのコーパスを MCP クライアントに直接公開します。ドキュメントへのアクセスは、公開されている Octagon ドキュメントの LLM エントリーポイント https://octagonai.co/docs/llms.txt から取得され、OCTAGON_API_KEY は使用も送信もされません。

利用可能なツール

MCP サーバーは現在、以下のツールを公開しています：

ドキュメントツール

これらのツールは、ライブの Octagon ドキュメントを MCP セッション内に公開します。OCTAGON_API_KEY の設定前でも使用できるため、セットアップ、トラブルシューティング、適切な Octagon エージェントや API ワークフローの確認に役立ちます。

octagon-docs-list

Octagon ドキュメントのコーパスから、ライブのドキュメントセクションとページを一覧表示します。

パラメーター

• section（string、任意）：ドキュメントのセクションで絞り込みます。
• source（docs、site、または all、任意）：デフォルトではドキュメントのコーパスが対象です。
• limit（number、任意）：返すエントリーの最大数です。

octagon-docs-search

Octagon API、エージェント、MCP、プラグインのドキュメントを、ソース URL と任意のスニペットとともに検索します。

パラメーター

• query（string、必須）：検索クエリです。
• section（string、任意）：ドキュメントのセクションで絞り込みます。
• source（docs、site、または all、任意）：デフォルトではドキュメントのコーパスが対象です。
• limit（number、任意）：返す結果の最大数です。
• includeSnippets（boolean、任意）：一致したスニペットを結果に含めます。

例：

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

タイトル、URL、パス、またはカタログ ID を指定して、ドキュメントのページまたはセクションを Markdown として読み込みます。

パラメーター

• target（string、必須）：ドキュメントのタイトル、URL、パス、またはカタログ ID です。
• source（docs、site、または all、任意）：デフォルトではドキュメントのコーパスが対象です。
• maxChars（number、任意）：返す Markdown の最大文字数です。
• preferCachedContent（boolean、任意）：利用可能な場合、インデックス化されたドキュメントのコーパスを使用します。

例：

Read the Octagon MCP server guide.

octagon-docs-refresh

ライブの LLM 向けドキュメントエンドポイントから、メモリー内のドキュメントカタログを更新します。

パラメーター

• includeSite（boolean、任意）：より広範な https://octagonai.co/llms.txt のサイトインデックスも更新します。

ドキュメントリソース

MCP リソースに対応しているクライアントは、以下も参照できます：

• octagon-docs://catalog：正規化されたライブドキュメントカタログ。
• octagon-docs://status：キャッシュの状態、ソースエンドポイント、更新メタデータ。
• octagon-docs://page/{target}：ドキュメントのページまたはセクションを Markdown として取得します。

octagon-agent

公開市場と非公開市場のインテリジェンス分析を統括します。

パラメーター

• prompt（string、必須）：自然言語で記述した調査リクエスト。
• conversation（string、任意）：以前の octagon-agent スレッドを続けるための既存の Octagon 会話 ID。初回の呼び出しでは省略します。
• newConversation（boolean、任意）：true の場合、アクティブなセッション／スレッドのアンカーに対して、新しい Octagon スレッドを開始します。Claude Desktop などの上位レイヤーのホストで新しいチャットを開始するときの初回呼び出しに推奨します。

スレッドを使った利用

octagon-agent は、Octagon の会話スレッド情報を引き継ぐ唯一の MCP ツールです。状態を保持するツールであり、セッションの継続性を前提としています。MCP は次の順序でセッション／スレッドの状態を解決します。

1. トランスポートが実際に提供する場合、MCP トランスポートのセッション ID に対応して保存された会話
2. サーバーが管理するデフォルトの stdio セッションに対応して保存された会話
3. 明示的に指定した conversation は、その呼び出しのアクティブなセッションの会話を引き続き上書きできます

このパッケージは現在、stdio MCP サーバーとして動作します。stdio モードでは、サーバーが呼び出し間の継続性を保つため、プロセス内セッションを自動的に確立します。そのため、Claude Desktop や Cursor などの多くのローカルホストでは、基本的なフォローアップの動作に追加のスレッド情報を指定せずに octagon-agent を使用できます。

上位レイヤーのホストが、新しい表示中のチャットの初回呼び出しであると認識している場合は、newConversation: true を渡してください。これにより、呼び出し前にアクティブな MCP セッションアンカーに保存されている Octagon スレッドが明示的に消去されます。stdio ホストが同じ長時間稼働する MCP プロセスを複数の表示中のチャットで再利用する際に、古い会話の継続性が残るのを防げます。

次のいずれのパターンでも利用できます。

1. 初回の呼び出し：prompt のみを送信します
2. MCP ホストでトランスポートセッションの継続性を保持するか、デフォルトの stdio セッションに依存します
3. 2 回目の呼び出し：
   • 同じ MCP セッションで新しい prompt を送信する、または
   • 同じ stdio MCP プロセスを引き続き使用する、または
   • 以前の conversation を明示的に渡します

トランスポートのセッション ID は、標準に準拠したステートフルな MCP トランスポートにおける、継続性を確保するための標準的な仕組みです。ローカルの stdio 利用では、サーバーが管理するプロセスセッションがデフォルトで継続性を提供します。

セッション ID と Octagon の会話 ID は異なる概念です。

• MCP セッション ID は、ツール呼び出し間のサーバー側の継続性を制御します
• Octagon の conversation は、そのセッション内のアクティブな Octagon スレッドを制御します

MCP の結果では、回答は content に格納され、オーケストレーター向けの構造化メタデータも structuredContent で返されます。

{
  "model": "octagon-agent",
  "text": "Which stock would you like the latest price for?",
  "conversation": "conv_123",
  "responseId": "resp_123",
  "followUp": {
    "required": true,
    "inputTemplate": "<ticker or company name>",
    "instructions": "Reply with just the missing detail and reuse the conversation value from this response."
  }
}

明示的に引き継ぐ例：

{
  "prompt": "AAPL",
  "conversation": "conv_123"
}

新しい表示中のチャットの例：

{
  "prompt": "Analyze Apple",
  "newConversation": true
}

明示的に更新する例：

{
  "prompt": "Start a fresh Octagon thread for this chat",
  "newConversation": true
}

ステートフルなツールのポリシー

• octagon-agent：状態を保持し、利用可能な継続性アンカーを使用します。stdio ホストでは、conversation を明示的に指定しない限り、デフォルトでサーバーが管理するプロセスセッションを使用します
• その他の MCP ツール：ステートレスであり、セッションの継続性がなくても実行できます

例：

Compare NVIDIA and AMD on latest quarterly revenue growth, margins, and management commentary.

その他の例：

• 「Amazon の 2023 年第 4 四半期の売上高と純利益はいくらでしたか？」
• 「過去 3 年間の Tesla の研究開発費の推移を分析してください。」
• 「直近の決算説明会で、NVIDIA の CEO は AI チップ需要についてどのような見通しを示しましたか？」
• 「半導体企業の時価総額上位 5 社について、株価収益率、株価売上高倍率、EV/EBITDA 倍率を比較してください。」
• 「Anthropic の直近の資金調達ラウンドの調達額、評価額、主な投資家を教えてください。」
• 「過去 12 か月間に、Andreessen Horowitz は AI スタートアップに何件投資しましたか？」
• 「過去 1 週間に公開された NVIDIA 株に関する最新ニュース記事を教えてください。」

octagon-deep-research-agent

複数の情報源を対象に、包括的な深掘り調査と統合を実施します。

パラメーター

• prompt（string、必須）：自然言語による調査リクエスト。

例：

Research the impact of lower interest rates on late-stage private software valuations over the next 12 months.

その他の例：

• 「zillow.com/san-francisco-ca/からすべてのデータフィールドを抽出する」
• 「Appleのプライバシー変更がデジタル広告企業の売上と利益率に与える財務上の影響を調査する」
• 「2023年の過去のBitcoin価格データを取得し、価格変動の傾向を分析する」
• 「EV充電インフラ市場における競争の動向を分析する」

octagon-prediction-markets-agent

Kalshiの予測市場イベントに関する調査レポートを作成します。

パラメーター

• prompt（string、必須）：自然言語による調査リクエスト。
• cache（boolean、任意）：エージェントのバリアントルーティングを制御します。
  • 省略時：prediction-markets-agent
  • false：prediction-markets-agent:refresh
  • true：prediction-markets-agent:cache

例：

Generate a report for the Kalshi market https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

prediction_markets_history

ページネーションと時間フィルターを任意で指定して、予測市場イベントのティッカーに関する履歴データを取得します。

パラメーター

• event_ticker（string、必須）
• limit（number、任意）
• cursor（string、任意）
• captured_from（string、任意）
• captured_to（string、任意）
• include_analysis（boolean、任意。trueの場合、分析用の列をリクエストします）

例：

Fetch historical data for the Kalshi event https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

トラブルシューティング

1. APIキーの問題：Octagon APIキーが環境または設定ファイルに正しく設定されていることを確認してください。
2. 接続の問題：Octagon APIへの接続が正常に機能していることを確認してください。
3. レート制限：レート制限エラーが発生した場合は、リクエストの頻度を下げてください。

ライセンス

MIT

個別の特化型 MCP サーバー

このサーバーは、特化型エージェントをすべて組み合わせた包括的な市場インテリジェンスを提供しますが、特定の用途には個別のMCPサーバーもご利用いただけます。

調査ツール

• Octagon Deep Research MCP - 包括的な調査機能とウェブスクレイピング機能

---

役に立った場合は、このリポジトリに⭐を付けてください！