SEC EDGAR — hosted on Cloudflare Workers (HTTP + npm stdio)

SEC EDGAR MCP — SEC 提出書類の検索、10-K/8-K リーダー、XBRL ファクト、インサイダー取引

SEC EDGAR 提出書類、10-K/8-K リーダー、XBRL 財務ファクト、Form 4 インサイダー取引

AI エージェントが SEC EDGAR システムにクエリできる、ホスト型 MCP サーバーです。ティッカー／CIK とフォームの種類で提出書類を検索し、10-K または 8-K の全文を読み取り、XBRL 形式の財務ファクト（売上高、EPS、現金）を取得し、8-K の重要な事象を分類して、最近の Form 4 インサイダー取引をストリーミングします。株式調査、財務分析、コンプライアンス向け LLM を想定して設計されています。

このサーバーは Model Context Protocol に対応しています。Cursor、Claude Desktop、Windsurf、Continue.dev、または @modelcontextprotocol/sdk を使って独自に構築したエージェントなど、MCP 対応クライアントであれば接続してツールを検出し、Bearer トークン認証で呼び出せます。

AI エージェント／LLM 向け

このリポジトリをインデックス化する AI エージェント向けの情報です。

• ライブ MCP エンドポイント： https://sec-edgar-mcp.atlasword.workers.dev/mcp
• トランスポート： HTTP POST、JSON-RPC 2.0
• 認証： Authorization: Bearer <api_key>（無料プランでは匿名で、IP あたり月 100 回まで利用可能）
• 検出： tools/list で完全なスキーマを返します。tools/call でツールを呼び出します。
• ヘルスチェック： GET https://sec-edgar-mcp.atlasword.workers.dev/health → {ok: true, ts: <unix>}
• ステータス： https://mcp-hub.atlasword.workers.dev/status.json（ポートフォリオの概要）

tools/list リクエストの例：

curl -sS -X POST https://sec-edgar-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

tools/call の例：

curl -sS -X POST https://sec-edgar-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params": { "name": "<tool>", "arguments": { } }
  }'

公開されているツール

ツール	引数	説明
edgar_search_filings	ticker?, cik?, form_type?, date_from?, date_to?, limit?	ティッカーまたは CIK と、フォームの種類／日付フィルターを使って、最近の提出書類（10-K、10-Q、8-K、S-1、Form 4）を検索します。
edgar_read_filing	accession_number, ticker?, cik?	accession number を指定して、特定の提出書類の HTML 全文を取得します（約 80K 文字で切り詰められます）。
edgar_get_facts	ticker?, cik?, concept	XBRL 形式の財務ファクト：売上高、EPS、現金、純利益。エイリアスまたは us-gaap のコンセプトを指定できます。
edgar_get_8k	ticker?, cik?, since?, limit?	分類された事象の種類（買収、役員の異動、監査人の変更など）を含む、最近の 8-K 重要事象。
edgar_get_company	ticker_or_cik	企業のメタデータ：正式名称、SIC 業種、上場取引所、会計年度末。
edgar_get_insider_trades	ticker?, cik?, limit? — Team+	売買の方向を含む Form 4 インサイダー取引の提出書類（役員、取締役、10％株主）。

Team+ のマークが付いたツールには、Team または Pro のサブスクリプションが必要です。匿名ユーザーと Free プランのユーザーがこれらを呼び出すと、tier_required エラーが返されます。

クイックスタート

最も手早く利用するには、mcp-remote を使って、MCP 対応クライアントをホスト型エンドポイントに接続します。

npx -y mcp-remote https://sec-edgar-mcp.atlasword.workers.dev/mcp \
  --header "Authorization: Bearer mck_YOUR_API_KEY"

https://sec-edgar-mcp.atlasword.workers.dev/upgrade?tier=solo でキーを取得してください（API キーの取得を参照）。

Cursor にインストールする

~/.cursor/mcp.json に以下を追加します。

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://sec-edgar-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

その後 Cursor を再起動すると、MCP パネルにツールが表示されます。

Claude Desktop にインストールする

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に以下を追加します。

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://sec-edgar-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktop を再起動します。スラッシュコマンドの MCP メニューにツールが表示されます。

API キーの取得

1. https://sec-edgar-mcp.atlasword.workers.dev/upgrade?tier=solo（または tier=team / tier=pro）にアクセスします。
2. Dodo Payments がホストするチェックアウト画面にリダイレクトされます。Dodo が住所を収集し、カード決済を処理し、VAT/GST に対応します。
3. 支払い後、Dodo は署名付きウェブフック（subscription.active）を Worker に送信します。Worker は mck_<32 random base64url> を発行し、KV に保存します。
4. https://sec-edgar-mcp.atlasword.workers.dev/welcome?key=<api_key> に移動します。この URL ではキーは一度しか表示されないため、ここでコピーしてください。
5. キーを Cursor / Claude Desktop の設定に貼り付けます（上記を参照）。
6. https://sec-edgar-mcp.atlasword.workers.dev/account からアカウントの確認、キーのローテーション、エクスポートを行えます（Bearer 認証）。

無料プラン（登録不要）もあります。匿名の呼び出しは IP ごとに月 100 回までです。

エンドポイント

ルート	説明
POST /mcp	MCP JSON-RPC 2.0 ツールインターフェース（メイン API）。有料プランでは Bearer 認証が必要です。
GET /health	稼働確認プローブ — {ok: true, ts}。mcp-hub の cron で使用します。
GET /	HTML ランディングページ（OG + favicon + JSON-LD）。
`GET /upgrade?tier=solo	team
GET /welcome?key=...	チェックアウト後のランディングページ。新しく発行された API キーが表示されます。
GET /account	Bearer 認証。{apiKey, tier, owner, status, portal_url} を返します。
POST /account/rotate	Bearer 認証。新しいキーを発行し、古いキーを無効化します。
GET /account/export	Bearer 認証。GDPR データエクスポート — アカウント、使用量カウンター、Dodo の詳細情報を含む JSON。
GET /account/team	Bearer 認証（Team 以上）。チームメンバーのサブキーを一覧表示します。
POST /account/team/invite	Bearer 認証（Team 以上）。チームメンバー用の新しいサブキーを発行します。
POST /account/team/revoke	Bearer 認証（Team 以上）。チームメンバーのサブキーを無効化します。
GET /team/accept?key=...	サブキーの URL を使用するチームメンバー向けオンボーディングページ。
POST /webhooks/dodo	Standard-Webhooks 署名付き。Dodo のサブスクリプションおよび支払いのライフサイクルを処理します。
GET /favicon.ico	インライン SVG。

料金プラン

すべてのプランで月間上限とレート制限は共通です。料金は製品ごとの位置付けを反映しています。

プラン	月間呼び出し回数	レート制限	チームの席数
Free	月 100 回	分あたり 10 回	0
Solo	月 2,000 回	分あたり 60 回	0
Team	月 10,000 回	分あたり 200 回	5
Pro	月 50,000 回	分あたり 600 回	25

プラン	料金	月間呼び出し回数	チームの席数
Free	$0	100	0
Solo	$9/mo	2,000	0
Team	$29/mo	10,000	5
Pro	$79/mo	50,000	25

Dodo Payments 経由で請求されます（販売事業者として記録され、VAT/GST は Dodo が処理します）。いつでもキャンセルできます。有料期間の終了までは引き続き利用できます。

データソース

• SEC EDGAR — https://www.sec.gov/edgar — パブリックドメイン（米国政府）

このサーバーは、上流ソースに対する薄いトランスポート + 認証 + キャッシュレイヤーです。呼び出しごとのレート制限は、各上流ソースの無料プランの利用規約を十分に遵守できるよう調整されています。

プライバシー + GDPR

• プライバシーポリシー： https://mcp-hub.atlasword.workers.dev/privacy
• 利用規約： https://mcp-hub.atlasword.workers.dev/terms
• 返金ポリシー： https://mcp-hub.atlasword.workers.dev/refund
• データエクスポート： GET https://sec-edgar-mcp.atlasword.workers.dev/account/export（Bearer 認証）を呼び出すと、アカウント、使用量カウンター、Dodo の顧客情報を含む、機械可読な JSON スナップショットが返されます。
• 削除： 登録済みのメールアドレスから [email protected] にメールを送信してください。

保存するのは、メールアドレス、発行した API キー、月間呼び出しカウンター、Dodo のサブスクリプションメタデータのみです。短いキャッシュ TTL を超えて、ツールの引数や上流からの応答をログに記録することはありません。

アーキテクチャ

• ランタイム： Cloudflare Workers（V8 アイソレート、グローバルエッジ）。
• ストレージ： 2 つの Cloudflare KV 名前空間 — <slug>-cache（上流レスポンスキャッシュ）と <slug>-usage（API キー、月次カウンター、チーム名簿）。
• 請求： Dodo Payments のライブモード、3 つのサブスクリプション商品（Solo / Team / Pro）、Standard-Webhooks による署名付きライフサイクルイベント。
• 可観測性： Cloudflare Workers Analytics、ポートフォリオの集計情報は mcp-hub status をご覧ください。
• ソース： TypeScript、Vitest でテスト済み、wrangler deploy でデプロイできます。このリポジトリの src/ をご覧ください。

ライセンス

MIT — LICENSE をご覧ください。

作者

Prakhar Gupta

• メール：[email protected]
• GitHub：@guptaprakhariitr

ステータス

• ライブステータスページ： https://mcp-hub.atlasword.workers.dev/status
• 機械可読なステータス： https://mcp-hub.atlasword.workers.dev/status.json
• ソースリポジトリ： https://github.com/guptaprakhariitr/sec-edgar-mcp

npm からインストール（ワンライナー）

軽量なランチャーを npm で @insnapsprakhar/sec-edgar-mcp として公開しています。URL を手動でコピー＆ペーストする必要はありません：

npx -y @insnapsprakhar/sec-edgar-mcp

または、MCP クライアントに組み込んでください：

{
  "mcpServers": {
    "sec-edgar": {
      "command": "npx",
      "args": ["-y", "@insnapsprakhar/sec-edgar-mcp"]
    }
  }
}

npm パッケージはランチャーにすぎません — mcp-remote を起動し、ホストされたエンドポイント（https://sec-edgar-mcp.atlasword.workers.dev/mcp）を指定します。