algoum-mcp

AI アシスタント向け algoum-mcp（MCP）

AI アシスタントがModel Context Protocolを通じて、SEC EDGAR の米国金融規制データ（インサイダー取引（Form 4/5）、重要なイベント（8-K）、機関投資家の保有状況（13F））を照会できるようにします。平易な言葉で尋ねれば、アシスタントがデータを調べてくれます。

質問できること

知りたいことを尋ねると、アシスタントが適切なツールを選びます。

インサイダー取引（Form 4 および 5）

役員、取締役、10％以上の株主が報告した買い付けと売却を、特定の企業または市場全体について確認できます。また、買い手の集中や企業役員の売買比率など、取引から導き出される指標も確認できます。

• 「過去7日間にNVIDIA株を買ったインサイダーは誰ですか？」
• 「過去14日間に少なくとも3人のインサイダーが買い付けた企業はどこですか？」
• 「過去90日間のTeslaの役員の買い付け・売却比率はどのくらいですか？」
• 「市場全体の最新のインサイダー売却を表示してください。」

重要なイベント（Form 8-K）

企業が開示しなければならないイベント（経営陣の交代、合併、破産、サイバーインシデント、決算発表など）を、検索可能な履歴または全企業の最新の提出書類として確認できます。

• 「サイバーインシデントに関する8-K提出書類で、今日提出されたものはありますか？」
• 「Boeingは今年、どのような重要なイベントを報告しましたか？」
• 「過去24時間に破産に関する提出書類はありましたか？」

機関投資家の保有状況（Form 13F）

機関投資家の四半期ごとのポートフォリオと、銘柄ごとの集計情報（保有するファンドの数、ポジションを新たに取得、増加、または縮小したファンドの数）を確認できます。

• 「2026-Q1にAppleを保有しているのは誰ですか？機関投資家のセンチメントはどうですか？」
• 「Bridgewaterが直近の報告四半期に保有していたポートフォリオを表示してください。」
• 「前四半期にMicrosoftのポジションを増やしたファンドはいくつありますか？」
• 「今週提出された13F開示書類はどれですか？」

企業と提出書類

ティッカーや企業の検索、各記録の元となったSEC提出書類、各データソースの最新状況を確認できます。

• 「PalantirのCIKは何ですか？」
• 「この取引の元となったSEC提出書類を教えてください。」
• 「データはどのくらい最新ですか？」

アシスタントは、必要に応じてAPIの説明も自分で参照できます。

知っておくと便利なこと

• 公開済みのSECデータを公式提出書類から直接取得する、読み取り専用のアクセスです。
• インサイダー取引と重要なイベントは、提出から数分以内に利用可能になります。
• タイムスタンプは、SECの報告どおり米国東部時間で表示されます。
• 13Fの数値はファンドが四半期について報告した保有状況です。そのため、資金の流れではなくポジションを表します。
• アシスタントには、いつでも現在のデータの最新状況を尋ねることができます。

ご質問や、今後見たいデータについてのご提案はありますか？お問い合わせください — ご意見をお待ちしています。

APIは無料で利用できます。役に立った場合は、寄付によってサービスの維持を支援できます。

セットアップ

1. APIキーを取得する

algoumポータルのダッシュボードでキーを作成します。REST APIで使うキーと同じものです。キーはアプリまたはマシンごとに作成して、それぞれを自分で管理できるようにしてください。キーはいつでも追加または無効化できます。

キーは環境変数に保存するか、アプリに入力を求めさせます。

export ALGOUM_API_KEY='<your key>'

2. 接続を確認する

curl -s https://api.algoum.de/v1/mcp \
  -H "Authorization: Bearer $ALGOUM_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

3. アシスタントにサーバーを追加する

アシスタントによっては、サーバーを自動でインストールできます。MCP Registryでalgoumを探してください。APMを使えば、2つのコマンドでアシスタントにセットアップできます。それ以外の場合は、以下の値を使用してください。

URL	https://api.algoum.de/v1/mcp
トランスポート	Streamable HTTP
認証	Authorization: Bearer <key> としてAPIキーを指定

VS Code（GitHub Copilot）

プロジェクト内に .vscode/mcp.json を作成します（または MCP: Open User Configuration を実行すると、すべてのプロジェクトで使用できます）。初回起動時に VS Code がキーを求めますが、ファイルには保存されません。

{
  "inputs": [
    { "type": "promptString", "id": "algoum-key", "description": "algoum API key", "password": true }
  ],
  "servers": {
    "algoum-mcp": {
      "type": "http",
      "url": "https://api.algoum.de/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:algoum-key}" }
    }
  }
}

チャットをエージェントモードに切り替え、ツール一覧で algoum-mcp ツールが有効になっていることを確認します。

IntelliJ IDEA およびその他の JetBrains IDE

どちらの方法も、すべての JetBrains IDE で使用できます。インストール済みのアシスタントに応じて、いずれかの方法を選んでください。

GitHub Copilot プラグイン

1. Settings → Tools → GitHub Copilot → Model Context Protocol (MCP) を開き、Configure をクリックします。mcp.json が開きます。

2. サーバーを追加します。

   {
     "servers": {
       "algoum-mcp": {
         "type": "http",
         "url": "https://api.algoum.de/v1/mcp",
         "headers": { "Authorization": "Bearer <your key>" }
       }
     }
   }
   

3. Copilot チャットを開き、エージェントモードに切り替えて、algoum-mcp ツールが一覧に表示されていることを確認します。

JetBrains AI Assistant

1. Settings → Tools → AI Assistant → Model Context Protocol (MCP) を開き、Add をクリックします。

2. As JSON を選択し、次の内容を貼り付けます。

   {
     "mcpServers": {
       "algoum-mcp": {
         "url": "https://api.algoum.de/v1/mcp",
         "headers": { "Authorization": "Bearer <your key>" }
       }
     }
   }
   

3. 保存し、サーバーが接続済みと表示されるまで待ちます。

キーは、お使いのマシン上にある IDE 独自の設定に保存されます。

Claude Code

claude mcp add --transport http algoum-mcp https://api.algoum.de/v1/mcp \
  --header "Authorization: Bearer $ALGOUM_API_KEY"

claude mcp list で確認します。

Cursor

プロジェクト内に .cursor/mcp.json を作成します（すべてのプロジェクトで使用する場合は ~/.cursor/mcp.json を作成します）。キーは手順 1 でエクスポートした環境変数から読み込まれるため、ファイルには保存されません。

{
  "mcpServers": {
    "algoum-mcp": {
      "url": "https://api.algoum.de/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:ALGOUM_API_KEY}" }
    }
  }
}

ALGOUM_API_KEY が設定されたシェルから Cursor を起動し、Settings → MCP で algoum-mcp サーバーが接続済みであることを確認します。

GitHub Copilot CLI

サーバーを ~/.copilot/mcp-config.json に追加します。

{
  "mcpServers": {
    "algoum-mcp": {
      "type": "http",
      "url": "https://api.algoum.de/v1/mcp",
      "headers": { "Authorization": "Bearer <your key>" },
      "tools": ["*"]
    }
  }
}

CLI で /mcp を実行すると、algoum-mcp が接続済みであることを確認できます。ファイルはお使いのマシンに保存されます。

APM（Agent Package Manager）

APM は、選択したアシスタント用にサーバーをインストールします。プロジェクト内で実行してください。キーは手順 1 でエクスポートした環境変数から読み込まれるため、どのファイルにも保存されません。

apm marketplace add fi4all/algoum-mcp
apm install algoum-mcp@algoum-marketplace --target vscode

vscode を、たとえば copilot、claude、cursor などのアシスタントに置き換えてください。apm targets でサポート対象をすべて確認できます。--target を指定しない場合、APM はプロジェクト内に既存のアシスタントフォルダーが必要です。

リンク

• algoum ポータル
• API リファレンス
• MCP Registry の登録情報
• Glama の掲載ページ
• お問い合わせ – ご質問、ご意見、今後追加してほしい内容など