Octagon MCP Server

公式

リアルタイムの投資調査を、広範なプライベートおよびパブリック市場データとともに提供します。

ドキュメント

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を使用するには、以下が必要です：

Octagonで無料アカウントにサインアップ
ログイン後、左メニューから API Keys に移動
新しいAPIキーを生成
このAPIキーを設定内で OCTAGON_API_KEY の値として使用

前提条件

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

Mac (macOS)

Homebrewをインストール (未インストールの場合):

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

Node.jsをインストール (npmとnpxを含む):
```
brew install node
```
これにより、最新バージョンのNode.js、npm、npxがインストールされます。
インストールの確認:
```
node -v
npm -v
npx -v
```

Windows

Node.jsインストーラーをダウンロード:
- https://nodejs.org/ にアクセスし、Windows用のLTSバージョンをダウンロードします。
インストーラーを実行 し、プロンプトに従います。これにより、Node.js、npm、npxがインストールされます。
インストールの確認: コマンドプロンプトを開き、以下を実行します:
```
node -v
npm -v
npx -v
```

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

インストール

Claude Desktopでの実行

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

Claude Desktopを開く
Settings > Developer > Edit Config に移動
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"
      }
    }
  }
}

変更を有効にするためにClaudeを再起動します

Cursorでの実行

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

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

Cursor Settingsを開く
Features > MCP Servers に移動
"+ Add New MCP Server" をクリック
以下を入力:
- 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クライアントセットアップガイドについては、以下を参照してください:

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

利用可能なツール

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

ドキュメントツール

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

`octagon-docs-list`

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

パラメータ

section (string, オプション): ドキュメントセクションでフィルタリング。
source (docs、site、または all、オプション): デフォルトはドキュメントコーパス。
limit (number, オプション): 返す最大エントリ数。

`octagon-docs-search`

ソースURLとオプションのスニペット付きで、Octagon API、エージェント、MCP、プラグインのドキュメントを検索します。

パラメータ

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で、1つのドキュメントページまたはセクションを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}: 1つのドキュメントページまたはセクションをMarkdownとして。

`octagon-agent`

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

パラメータ

prompt (string, 必須): 自然言語のリサーチリクエスト。
conversation (string, オプション): 以前の octagon-agent スレッドを継続するための既存のOctagon会話ID。最初のターンではこれを省略します。
newConversation (boolean, オプション): true の場合、アクティブなセッション/スレッドアンカーに対して新しいOctagonスレッドを開始します。Claude Desktopなどのトップレイヤーホストでの新しい可視チャットの最初のターンに推奨されます。

スレッド化された使用法

octagon-agent は、Octagon会話スレッディングを転送する唯一のMCPツールです。これはステートフルなツールであり、セッションの継続性を期待します。MCPは、以下の順序でセッション/スレッド状態を解決します:

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

このパッケージは現在、stdio MCPサーバーとして実行されます。stdio モードでは、サーバーは呼び出し間の継続性のためにプロセスローカルセッションを自動的に確立します。したがって、Claude DesktopやCursorなどのほとんどのローカルホストは、基本的なフォローアップ動作のために追加のスレッディングフィールドを提供することなく octagon-agent を使用できます。

トップレイヤーホストが、呼び出しが新しい可視チャットの最初のターンであることを認識している場合、newConversation: true を渡す必要があります。これにより、呼び出し前にアクティブなMCPセッションアンカーの保存されたOctagonスレッドが明示的にクリアされ、stdio ホストが複数の可視チャットにわたって同じ長期間存続するMCPプロセスを再利用する場合の古い継続性を防ぎます。

つまり、以下のいずれかのパターンを使用できます:

最初の呼び出し: prompt のみを送信
MCPホストにトランスポートセッションの継続性を保持させるか、デフォルトのstdioセッションに依存
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.

その他の例:

"2023年第4四半期のAmazonの収益と純利益の数値は？"
"過去3年間のTeslaの研究開発費の傾向を分析してください。"
"NVIDIAのCEOは最新の決算説明会でAIチップの需要に関してどのようなガイダンスを提供しましたか？"
"上位5つの半導体企業の株価収益率、株価売上高倍率、EV/EBITDA倍率を比較してください。"
"Anthropicの最新の資金調達ラウンドの規模、評価額、主要投資家は？"
"Andreessen Horowitzは過去12か月間に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年のビットコインの過去の価格データを取得し、価格変動の傾向を分析してください"
"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

トラブルシューティング

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

ライセンス

MIT

個別特化型MCPサーバー

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

リサーチツール

Octagon Deep Research MCP - 包括的なリサーチとWebスクレイピング機能

⭐ このリポジトリが役立ったらスターを付けてください！