Form4API MCP — SEC Form 4 Insider Trading

form4api-mcp

MCP 対応のあらゆる AI アシスタントで利用できる、本番環境向けの SEC Form 4 インサイダー取引データ — 修正報告に対応、10b5-1 を適切に処理、Form 144 と機関投資家の 13F-HR データを重ねて表示。さらに、議会の STOCK Act 取引とインサイダー／議会の動向の一致を確認できます — 39 個のツールと、すぐに使える 6 個のリサーチ用プロンプト

ホスト型の Form4API REST API を Claude Desktop、Cursor、Windsurf、VS Code、Codex CLI、およびその他の MCP 対応クライアントに提供する MCP サーバーです。一度設定すれば、リサーチ中に LLM がインサイダー取引、機関投資家のポジション、売却意向の届出に関する質問に直接回答できます。

スクレイピングベースの代替サービスでは実現できない、データ品質に関する 4 つの特長：

• 🛡 修正報告に対応 — Form 4/A の修正報告を自動的に照合します。インサイダーが報告を訂正しても、二重にカウントされません。
• 🎯 10b5-1 を適切に処理 — すべての取引に、事前に予定された取引（10b5-1 プラン）か裁量取引かを示すフラグが付きます。クラスターシグナルでは、仕組み上、予定された取引は除外されます。
• 📜 Form 144 の売却意向 — 125K 件を超える Form 144 の届出をインデックス化しています。Form 4 に反映される約 2 日前に、インサイダーによる売却を把握できます。
• 🏛 機関投資家とインサイダーの統合 — すべての取引に、現在の 13F-HR の保有状況（上位 3 保有者、AUM の推移）が同じレスポンスに含まれます。追加の呼び出しも、クライアント側での結合も不要です。調査したセルフサービス型 SEC データ API の中で、1 回のクエリで両方を返すものはありません。sec-api.io と Kaleidoscope は、13F とインサイダーデータを別々のエンドポイントで提供しています。

---

クイックインストール

1. 無料の API キーを取得する

www.form4api.com にアクセス → サインイン → ダッシュボードを開きます。無料プランでは、クレジットカード不要で 1 日あたり 500 件のリクエストを利用できます。

2. MCP クライアントに追加する

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "form4api": {
      "command": "npx",
      "args": ["-y", "form4api-mcp"],
      "env": {
        "FORM4API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

クライアントを再起動すると、ツールが自動的に表示されます。

Claude Code（CLI）：

claude mcp add form4api -- npx -y form4api-mcp

…続いて、シェルまたは ~/.claude/mcp.json で FORM4API_KEY を設定します。

Cursor — ~/.cursor/mcp.json（ユーザーレベル）または .cursor/mcp.json（ワークスペースレベル）を編集します。

{
  "mcpServers": {
    "form4api": {
      "command": "npx",
      "args": ["-y", "form4api-mcp"],
      "env": {
        "FORM4API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor を再起動すると、ツールが自動的に表示されます。

Windsurf — ~/.codeium/windsurf/mcp_config.json を編集します。

{
  "mcpServers": {
    "form4api": {
      "command": "npx",
      "args": ["-y", "form4api-mcp"],
      "env": {
        "FORM4API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf を再起動すると、ツールが自動的に表示されます。

VS Code — .vscode/mcp.json（ワークスペースレベル）を編集します。注：VS Code では mcpServers ではなく servers キーを使用します。

{
  "servers": {
    "form4api": {
      "command": "npx",
      "args": ["-y", "form4api-mcp"],
      "env": {
        "FORM4API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code を再起動すると、ツールが自動的に表示されます。

Codex CLI — 設定ファイルは ~/.codex/config.toml にある TOML 形式です。

[mcp_servers.form4api]
command = "npx"
args = ["-y", "form4api-mcp"]
env = { FORM4API_KEY = "YOUR_API_KEY" }

動作を確認する

LLM に verify_setup ツールを実行するよう依頼します。API キーが有効で、MCP サーバーに接続できることを確認します。問題がある場合は、正確な修正手順を返します。

例：「verify_setup ツールを実行して、MCP が正しく設定されていることを確認してください。」

API キーを用意する前に試す

get_public_stats はキー不要のツールで、FORM4API_KEY を設定しなくても動作します。まず試して、サインアップ前にライブデータのカバレッジを確認できます。

FORM4API_KEY="" npx form4api-mcp

内容を確認したら、www.form4api.com で無料のキーを取得し、FORM4API_KEY を設定すると、すべてのツールを利用できます。

3. または、直接実行する

FORM4API_KEY=YOUR_API_KEY npx form4api-mcp

---

利用可能なツール（39 個）

検索

ツール	説明	プラン
search	会社名、ティッカーの一部、または人物名からティッカーまたは CIK を特定します。識別子がまだ分からない場合に、通常は最初に呼び出すツールです。順位付けされた companies と insiders のリストをそれぞれ返します	無料

Form 4 のインサイダー取引

ツール	説明	プラン
research_company	1 回の呼び出しで、1 つのティッカーに関するインサイダー調査のコンテキストをまとめて取得します。企業プロフィール、最近の取引、クラスターシグナル、センチメント、算出された買い／売り方向の概要が含まれます。4 回の個別の呼び出しを置き換え、より上位のプランが必要なセクションがある場合も適切に処理します	Free（シグナル／センチメントのセクションには Business が必要）
get_transactions	インサイダー取引を検索します。ティッカー、インサイダー、日付範囲、取引コードまたはカテゴリ全体（exclude_category=derivatives）、10b5-1 プラン取引、金額の下限（min_value）、インサイダーの役職（role：役員、取締役、10％超の所有者）、取引額順（sort=value。デフォルトは新しい順）、13F の保有傾向（inst_ownership_trend）で絞り込めます。また、significant=true を指定すると、実際の裁量による買い／売りのみを対象にできます。Pro では、残りの取引規模の絞り込み条件（max_value、min_shares、max_shares）と、取引後リターンによる絞り込み（min_return_1d…max_return_6m、has_returns）が追加されます。リターンは小数で、0.05 は +5％を表します。ページングの深度はプランによって制限されます。プランを参照してください	Free
get_recent_filings	最新の Form 4 提出書類を取得します。ティッカーでの絞り込みも可能です	Free
list_filings	Form 4 提出書類を新しい順のページ分けされたリストで取得します。ティッカー、cik、提出日の範囲で絞り込めます。提出書類を順に確認するにはこちらを使用してください。get_recent_filings は同じフィードの先頭部分を絞り込みなしで取得します	Free
get_filing	アクセッション番号で単一の提出書類を取得します	Free
get_insider_profile	インサイダープロフィール（氏名、役職、取締役／役員／10％所有者のフラグ）を取得します	Free
get_insider_transactions	特定のインサイダー（CIK で指定）のすべての取引を取得します	Free
get_company_overview	企業プロフィール（名称、CIK、SIC セクター、州、ウェブサイト、提出書類数）を取得します	Free
get_company_insiders	企業の Form 4 を提出したすべてのインサイダーを取得します	Free
get_company_peers	同じ SIC 業種の類似企業を取得します（まず 4 桁のコードで検索し、2 桁のプレフィックスから補完）。過去 12 か月の Form 4 提出数の多い順に並びます	Free
list_companies	企業を名称または提出書類数順に並べて一覧表示します	Free
get_insider_directory	姓のアルファベット順にインサイダーを閲覧します。各文字の件数を示す A〜Z の一覧と、指定した文字のインサイダー 1 ページ分が含まれます	Free
get_insider_career_summary	キャリア全体の集計情報（買い／売りの合計、上位企業、10b5-1 の内訳、リターン平均）を取得します	Pro
get_insider_scorecard	インサイダー（CIK）の買い取引実績を示すスコアカードです。裁量による公開市場での買いについて、的中率と平均／中央値のリターンを示します。成熟したサンプルが 5 件未満の場合は null になります	Pro
get_insider_leaderboard	hit_rate または avg_return で順位付けした上位インサイダーを取得します。horizon（3m／6m）、min_trades、limit で絞り込めます	Business

シグナルとセンチメント

ツール	説明	プラン
get_signals	クラスター買い／売りシグナルを取得します。同じ企業の複数のインサイダーが同じ方向に取引した場合に発生します。10b5-1 取引は自動的に除外されます	Business
get_sentiment	ティッカーごとの月次センチメントスコア（-100〜+100）を取得します。10b5-1 は除外されるため、スコアは実際のインサイダーの確信度を反映します	Business

Form 144 と機関投資家

ツール	説明	プラン
get_form144	売却予定通知の提出書類を取得します。Form 4 の売却が記録される約 2 日前の先行シグナルです	Business
get_holdings	Form 13F-HR による機関投資家の保有状況を取得します（ティッカー、CUSIP、運用会社、四半期、最低金額で絞り込み可能）	Business
get_managers	最新の AUM を含む機関投資家の運用会社一覧を取得します	Business
explain_signal	シグナルが発生した理由を説明します。集計対象となったインサイダーと取引、除外対象、判定基準を確認できます	Business
get_data_quality	公開データの品質、鮮度、カバレッジの指標を取得します	Free
list_schedule13_dg	企業の Schedule 13D／13G による 5％超の実質所有権の変動を取得します。提出者、所有割合、発生日、フォーム種別が含まれます	Business

議会取引＋コンバージェンス

ツール	説明	プラン
list_congress_trades	議会議員による STOCK Act 取引（定期取引報告書） — ティッカー、政治家、政党、議院、州、取引種別、最低金額、または日付範囲で絞り込めます。対象は米国下院のみです — 上院の eFD はデータセンターからのトラフィックをブロックするため、chamber=Senate では一致する結果がなく、レスポンスには X-Coverage-Note: chamber-not-covered が含まれます。各行には amountLow／amountHigh（開示された範囲であり、決して中間値を捏造しません）と disclosureLagDays が含まれます — STOCK Act により最大45日の遅延があるため、ここでの「リアルタイム」とは取引後数分ではなく、開示後数分を意味します	無料（開示後30日分；Starter は366日分；Pro+ は履歴無制限）
list_congress_politicians	議会取引の活動状況に基づく政治家のランキング — 取引総数／買い／売りの件数、最も新しい開示	Pro
get_congress_politician	bioguide ID による政治家1人の詳細なプロフィール — 合計、取引上位のティッカー、最も新しい取引	Pro
get_congress_ticker_rollup	特定のティッカーを取引した政治家と、買い／売りの純件数	Pro
get_convergence_signals	直近の期間内に、インサイダーのクラスター買いと議会議員の買いが発生したティッカー。strength は文書化された算術値です（異なる議会議員の買い手数 × シグナルのインサイダー数）。ブラックボックス型のスコアや予測スコアではありません。パフォーマンスやアルファに関する主張は算出も示唆もしません	Pro

ユーティリティ

ツール	説明	プラン
check_usage	API キーの使用状況と現在のプラン	無料
get_key_activity	このキーに対する最近の API リクエスト	無料
get_usage_history	直近 N 日間の日次リクエスト数	無料
search_insiders	インサイダー名の部分一致検索	無料
list_webhooks	Webhook のサブスクリプション一覧。Webhook ごとの配信状況（lastAttemptAt、lastSuccessAt、lastStatusCode、lastErrorClass）と自動無効化の状態を含みます。読み取り専用	無料
get_webhook_events	指定したタイムスタンプ以降の Webhook 配信イベントを再生します。読み取り専用	無料
verify_setup	MCP が正しく設定されているか確認します — API キーが有効で、サーバーに到達できることを検証します	無料
get_public_stats	公開コーパス全体の合計値（提出書類、取引、企業、13F-HR の AUM、取り込み遅延）— API キーは不要です	無料（キー不要）
get_status_history	公開ステータスページの直近90日間の日次稼働履歴	無料（キー不要）
health_ingestion	取り込み状況のライブヘルスチェック — Form 4 の最新度、解析キューの滞留数、価格フィードの古さ	無料（キー不要）

---

プロンプト（6）

39 個のツールに加えて、この MCP には 6 つのプロンプトが用意されています。クライアントは、すぐに使える調査レシピを一覧表示（prompts/list）して読み込む（prompts/get）ことができるため、適切なツールの呼び出し順序を自分で組み立てる必要はありません。それぞれのプロンプトは、SEC Form 4／Form 144／13F-HR のどのツールをどの順序で呼び出すか、またプランによって利用が制限される結果をどう読み取るかを、LLM に具体的に指示します。

プロンプト	引数	機能
insider_monitor	ticker	ティッカーに関する最近の SEC Form 4 インサイダー取引（10b5-1 フラグ付きの取引、クラスターシグナル、センチメント）を、取引後リターンの背景情報を添えて、買い／売りの確信度として要約します
cluster_buy_scan	days（デフォルト 7）	最近のクラスター買いシグナルを市場全体でスキャンし、10b5-1 を除外して、確信度（インサイダー数＋金額）順にランク付けします。各シグナルにはセンチメントスコアが付与されます
form144_early_warning	ticker（任意）	提出済みの Form 144 売却予定通知を最近の Form 4 売却と照合します。裁量による（10b5-1 ではない）通知を最も有力な早期警告として示し、売却の約 2 日前に知らせます
exec_conviction_check	insider（氏名または CIK）	インサイダーのキャリアを通じた実績（買い／売りの合計、裁量による買いの過去の取引後リターン、過去にその人物の買いが計画済みの 10b5-1 売りを上回る成果を上げていたか）を示します
institutional_insider_overlap	ticker	13F-HR の機関投資家保有情報と最近のインサイダー取引を組み合わせ、機関投資家とインサイダーの見解が一致する銘柄や食い違う銘柄を特定します
post_selloff_buys	min_return（デフォルト 0.05）	取引後リターンのフィルターでインサイダーの買いを絞り込み、過去に成功した押し目買いのパターンを見つけます

これらは、スクレイピングベースの Form 4 MCP では提供されないレシピ型のワークフローに対応しています。それぞれ、この MCP だけが提供するデータ（10b5-1 フラグ、Form 144、13F-HR との結合、インサイダーごとのリターンスコア）を活用します。プラン要件も正確に考慮されます。Business プランのツール（get_signals、get_sentiment、get_form144、get_holdings、get_managers）または Pro プランのツール（get_insider_career_summary、get_insider_scorecard）を使うプロンプトは、エラーを黙って無視するのではなく、構造化された upgrade_required レスポンスを表示するよう LLM に指示します。

Claude Desktop では、プロンプトは / スラッシュコマンドの選択メニューに表示されます。Claude Code やその他の MCP クライアントでは、アシスタントに「NVDA に insider_monitor プロンプトを使って」のように依頼すると、データを取得してレシピに沿って実行します。

---

プロンプトの例

設定済みですか？LLM に次のように尋ねてみてください。

品質重視（修正内容を考慮し、10b5-1 を除外したデータセットを結合しているため、これらのクエリには当社のデータセットが必要です）：

• 「今週のクラスター買いシグナルを表示して。裁量によるものだけにして、計画済みの取引は除外して」
• 「今四半期に機関投資家の保有比率が上昇している一方で、インサイダーが買いを行っている企業はどこ？」
• 「NVDA で今後の売却を示唆する Form 144 の提出はある？」
• 「10b5-1 プランを除外した場合、過去 6 か月の TSLA の月ごとのインサイダーセンチメントはどうなっている？」
• 「Berkshire Hathaway の 13F-HR 保有上位銘柄は？今四半期に何を買い増し、何を減らした？」

標準的なインサイダー調査：

• 「過去 30 日間に NVDA でどのようなインサイダー取引があった？10b5-1 プランは除外して」
• 「Tim Cook のインサイダー取引のキャリア概要は？」
• 「2026 年に Tesla で行われた 100 万ドル超の公開市場での買い付けをすべて表示して」
• 「今年、Microsoft の CFO は自社株をどう扱っている？」

---

この MCP がスクレイピングベースの代替手段より優れている理由

この分野には、Form 4 データを取得するために無料の公開サイト（例：openinsider.com）をスクレイピングする MCP もあります。手早くプロトタイプを作るには問題ありませんが、LLM に提供されるデータレイヤーには構造的な欠落があります。

	form4api-mcp	スクレイピングベースの MCP
Form 4/A の修正申告への対応	✅ 自動的に整合	❌ 二重計上
10b5-1 プランのフラグ	✅ すべての取引に表示	❌ 計画取引と裁量取引が混在
Form 144 の売却意向	✅ 125K 件以上の申告書	❌ 表示されない
機関投資家とインサイダーの結合	✅ 取引ごとの上位 3 保有者と AUM の推移	❌ インサイダーのみ
センチメント（10b5-1 を除外）	✅ MSPR 形式のスコア	❌ 計画取引がスコアに混入
データソースの耐障害性	✅ ホスト型 API の契約	❌ データソースの HTML が変更されると機能しなくなる
Webhook／本番環境への配信	✅ HMAC + 再試行 + DLQ	❌ MCP のみで、代替手段なし
SDK	✅ Python + JS	❌ MCP のみ
商用サポート	✅	❌

LLM セッションを、最終的に本番環境への配信を目指す本格的なリサーチワークフローの出発点とするなら、次の段階へ移行できる MCP を選ぶことが重要です。

---

MCP の先へ — さらに必要になったとき

Webhook ツールは読み取り専用です。 MCP でできるのは、Webhook の一覧表示（list_webhooks）と配信イベントの再実行（get_webhook_events）だけです。それ以外の Webhook の作成、削除、有効化、テスト、およびカスタム認証ヘッダーの設定は、REST API またはダッシュボードから行います。これは意図的な設計です。MCP は Webhook の書き込みツールを公開していません。

MCP は最も簡単な入口です。ワークフローが LLM を介したリサーチの範囲を超えて成長しても、Form4API プラットフォームの他の機能をすぐに利用できます。

• Webhook — HMAC 署名、指数バックオフ、デッドレターキュー、障害が継続した場合の自動無効化。LLM とのチャットだけでなく、本番環境のパイプライン向けです。
• Python SDK — pip install form4api（PyPI）
• JS / TypeScript SDK — npm install form4api（npm）
• ダッシュボード — 使用状況、セルフサービスの請求管理、キーのローテーション、Webhook の状態、請求履歴。

MCP は上記すべてと同じバックエンドを利用します。LLM が引用するすべての事実は、同じキーを使ってこれらのいずれかの方法でプログラムから再取得できます。

---

プラン

39 個のツールのうち 25 個は無料プランで利用でき、現在無料のツールは今後もすべて無料です。 新しいプレミアム機能は提供開始に合わせてプラン分けされます。すでにキーで利用できる機能が後から取り上げられることはありません。

ツール	Free	Pro	Business
search	✓	✓	✓
get_transactions、get_recent_filings、get_filing	✓	✓	✓
get_insider_profile、get_insider_transactions	✓	✓	✓
get_company_overview、get_company_insiders、get_company_peers	✓	✓	✓
get_insider_career_summary、get_insider_scorecard	—	✓	✓
get_insider_leaderboard、get_signals、get_sentiment	—	—	✓
get_form144、get_holdings、get_managers	—	—	✓
explain_signal、list_schedule13_dg	—	—	✓
list_congress_trades	✓（開示から 30 日間）	✓（履歴無制限）	✓（履歴無制限）
list_congress_politicians、get_congress_politician、get_congress_ticker_rollup、get_convergence_signals	—	✓	✓
1 日あたりのリクエスト数	500	50,000	250,000
1 分あたりのリクエスト数	60	200	500
get_transactions のページング深度	20 ページ	無制限	無制限

Starter は Free と Pro の中間のプランです。1 日あたり 7,500 リクエスト、1 分あたり 120 リクエスト、get_transactions のページング深度は 100 ページ、米国議会の取引履歴は 366 日分です。表で Pro または Business と表示されているツールには、引き続き該当するプランが必要です。Enterprise は 1 日あたりのリクエスト数が無制限で、1 分あたり 2,000 リクエストです。

過去データを一括取得する場合は、ページングではなく、REST の /v1/transactions/export エンドポイント（Business）を使用してください。フィルターに一致するデータ全体が、1 回のリクエストで CSV としてストリーミングされます。

ペイウォールに達したときにエージェントに表示される内容

制限付きの呼び出しで、HTTP エラーだけがそのまま返されることはありません。MCP は構造化された upgrade_required ペイロードを返すため、モデルは状況と解決方法を一度の応答で説明できます。

{
  "error": "upgrade_required",
  "required_plan": "business",
  "current_plan": "Free",
  "message": "This endpoint requires the Business plan or higher. Your current plan is Free.",
  "unlocks": "The Business plan includes cluster-buy signals and sentiment scores, 13F institutional holdings and managers, Form 144 notices, bulk CSV export, and 250,000 requests/day."
}

message は API 自体の説明文であり、原文のまま保持されます。呼び出しを停止させた具体的な上限やパラメーターが記載されており、通常、モデルが実行可能な代替案を提案する際に必要な情報です。同じ形式は、無料で利用できるツールで Pro 専用のパラメーターが使われた場合にも返されるため、モデルはそのフィルターを外して再試行できます。

upgrade_url は API から提供された場合にのみ含まれ、それ以外の場合は省略されます。

---

データの網羅範囲

• SEC EDGAR の Form 4 取引 138 万件以上
• 全報告企業の 提出書類 62 万件以上
• Form 144 の売却予定通知の提出書類 12 万 5,000 件以上（Business+）
• Form 13F-HR 保有明細 4,500 万件以上、提出書類 11 万 8,000 件以上、直近の完了四半期における運用資産残高は 80 兆ドル以上（Business+）
• 3.3 年以上の履歴（2023-04 以降）
• すべての取引に 10b5-1 プランのフラグ
• 訂正書類を考慮 — Form 4/A を照合
• 議会の STOCK Act 取引 — 対象は米国下院書記官の定期取引報告書のみ（上院の eFD は取り込まれていません）。list_congress_trades はすべてのプランで利用でき、履歴期間はプランによって異なります（Free は 30 日、Starter は 366 日、Pro+ は無制限）。議員別の集計と動向の一致分析には Pro+ が必要です。電子提出の書類では、金額は開示された範囲（amountLow／amountHigh）のまま常に表示され、根拠のない中間値は生成されません。また、すべての取引に disclosureLagDays が含まれます（STOCK Act に基づく開示遅延は最大 45 日）。
• リアルタイム取り込み — SEC 公開から数分以内に新しい提出書類を取得

---

Claude Desktop Extension（DXT）としてインストールする

リポジトリのルートには manifest.json が含まれており、Desktop Extensions (DXT) 形式を使ってワンクリックでインストールできます。Claude Desktop が .dxt ファイルにネイティブ対応したら、次のコマンドでパッケージ化してインストールします。

npx @anthropic-ai/dxt pack
# Produces form4api-mcp.dxt — open it in Claude Desktop to install

それまでは、上記の「クイックインストール」で説明した標準の claude_desktop_config.json 方式を使用してください。

---

ツールをバックエンドと同期させる方法

この MCP は次の 2 つのレイヤーで構成されています。

• src/tools/*.ts にある手書きのツール（transactions、signals、sentiment、form144、holdings など）— これらには LLM による判別を促す説明（訂正書類を考慮、10b5-1 を正確に処理など）が含まれており、この MCP が代替手段より適切に選ばれるようにしています。
• src/tools/_generated.ts にある自動生成ツール — npm run codegen により https://api.form4api.com/openapi/v1.json から生成されます。OpenAPI 仕様に追加されたバックエンドのエンドポイントはすべて、ここに自動的に反映されます。CI はすべての PR で npm run codegen:check を実行し、コミット済みファイルがライブ仕様から生成される内容と異なる場合はビルドを失敗させるため、MCP がバックエンドに気付かれないまま遅れをとることはありません。

生成ツールを追加するには、バックエンドにエンドポイントを追加し、再生成（npm run codegen）して、src/tools/_generated.ts をコミットし、公開します。ツールラッパーのコードは必要ありません。

6 つのレシピプロンプトは src/prompts/recipes.ts にあります。こちらも手書きで、自動生成ではありません。新しいバックエンド機能は追加せず、それぞれ既存のツールをどの順番で呼び出すかを LLM に指示する、クライアント側のテンプレートとして機能します。

---

リンク

• Form4API — API のホームページ
• ドキュメント — REST API の完全なリファレンス
• ダッシュボード — API キーの管理、使用状況の確認、Webhook の設定
• ステータス — 稼働状況、データベース、取り込みキューの健全性をリアルタイムで確認
• npm — npm パッケージ
• mcp.so — MCP サーバーのディレクトリ掲載ページ