EDGAR Filings

EDGAR Filings MCP

ウェブ検索の推測ではなく、SEC提出書類に記載された数値を返す Cursor / Claude 用ツールです。

対象ユーザー： IDE のチャットを使っていて、edgartools をつなぐコードを書かずに、銘柄の 10-K／10-Q のシンボル、セグメント別売上高、BDC の未収利息債権、または Form 4 の明細を知りたい方です。

解決する課題： モデルはセグメント構成、インサイダー取引、BDC の信用の質を捏造することがあります。これらのツールは、アクセッション番号、コンセプト、期間、open_market、未収利息債権の算出方法、EDGAR インデックスの URL を返すため、提出書類を確認できます。

対象外のもの： 調査製品でも、文書リーダーでも、10-K を読む代わりになるものでもありません。edgartools をラップし、4 つの用途だけに対応しています。中国の PE、ヒューマノイドロボット、未上場クレジット CV は対象外です。これらの提出書類は EDGAR にありません。

インストール

すでに uv が PATH にある場合は、これを ~/.cursor/mcp.json（Windows の場合：%USERPROFILE%\.cursor\mcp.json）に貼り付けてください。実在する名前とメールアドレスを使用してください（SEC FAQ）。同じスニペットが examples/cursor.mcp.json と examples/claude.mcp.json にもあります。

{
  "mcpServers": {
    "edgar-filings": {
      "command": "uvx",
      "args": ["edgar-filings-mcp"],
      "env": {
        "EDGAR_IDENTITY": "Your Name [email protected]"
      }
    }
  }
}

PyPI パッケージ edgar-filings-mcp は公開済みです。レジストリ名は io.github.Dxfory/edgar-mcp です。Smithery ホスト版は使わないでください。mcp>=1.9,<2 を固定してください。MCP 2.x では FastMCP の名前が変更されており、このパッケージはすでにその範囲を指定しています。

初回の uvx 起動時には edgartools がダウンロードされます（pandas / pyarrow）。クライアントが応答しないように見える場合は、ターミナルで uvx edgar-filings-mcp を一度実行して uv にホイールをキャッシュさせてから、MCP サーバーを再起動してください。次回以降の初期化は数秒で完了します。

uv がまだない場合：

macOS / Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）：

irm https://astral.sh/uv/install.ps1 | iex

PyPI ではなく git からの場合：

uvx --from git+https://github.com/Dxfory/edgar-mcp.git edgar-filings-mcp

クローン（uv なし）

git clone https://github.com/Dxfory/edgar-mcp.git
cd edgar-mcp
python -m venv .venv

macOS / Linux：

.venv/bin/python -m pip install -e .

Windows：

.\.venv\Scripts\python -m pip install -e .

引数 ["-m", "edgar_mcp"] を使い、クライアントにそのインタープリターを指定してください。

PyPI の SSL 接続に失敗する場合（ローカルの HTTPS プロキシでよく発生します）は、ミラーを使用してください：

python -m pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple

ツール

ツール	戻り値
get_trading_symbols	最新の 10-K または 10-Q にあるすべての dei:TradingSymbol と、従来の entity_info スカラー
get_segment_revenue	次元付き XBRL 売上高（製品／事業／地域の軸）
get_bdc_nonaccrual	BDC の未収利息債権率、公正価値、名称付き投資、抽出方法
get_form4	最新の Form 4 の要約、取引明細、open_market、code_counts

get_trading_symbols、get_segment_revenue、get_bdc_nonaccrual の form は 10-K（デフォルト）または 10-Q です。get_bdc_nonaccrual が受け付けるのは、ARCC などの SEC BDC（814- 提出者）のみです。5 つ目のツールはありません。

注目テーマに関する、このサーバーが回答すること／しないこと

テーマ	エージェントが捏造する情報	ツール	注意事項
AI インフラ	NVIDIA／ハイパースケーラーの「AI 構成比」	NVDA の get_segment_revenue（Data Center はタグ付けされています）。AMZN／MSFT の設備投資は AI 限定ではありません	偽の AI 設備投資ツールを追加しないでください
プライベートクレジット／BDC	未収利息債権、信用の質としての NAV、経常的なものとしての PIK	get_bdc_nonaccrual	未収利息債権率 ≠ Fitch のデフォルト率です。PIK でも未収利息債権にならない場合があります
GP 主導の継続ファンド	取引価格と「額面プレミアム」	なし	プライベートセカンダリーは EDGAR の対象外です
中国の PE／具身型知能	資金調達額と工場の稼働時間	なし	SSE／HKEX の対象であり、EDGAR の対象ではありません

ツールがすでに警告している落とし穴

• entity_info.ticker は、TradingSymbol の事実が繰り返される場合、最後の値を採用します。複数クラス株や優先株のティッカーが、普通株のシンボルを上書きすることがあります。
• セグメント構成は get_financials() には含まれません。一部の財務諸表の「DETAILED」ビューでは報告セグメントの行が省略されますが、このサーバーはディメンション付きの事実を照会します。
• Form 4 の A／M／F は、付与、オプション行使、税金の源泉徴収を表します。open_market は false です。
• BDC の extraction_method=none、または抽出器の警告を伴うゼロの利率は、帳簿に問題がない証拠ではなく、解析漏れです。
• 最新の 10-K が 10-K/A の場合があります。ツールは投資明細表の脚注が欠落しないよう、元のフォームを優先します。

Cursor を使わずに実行する

python -m edgar_mcp

stdio のみです。標準出力には何も出力しないでください。

python tests/run_offline.py
python scripts/smoke_stdio.py
python scripts/pressure.py

smoke_stdio.py が確認するのは、初期化と4つのツール名のみです（EDGAR は確認しません）。uvx が PATH に追加された後：

python scripts/smoke_stdio.py -- uvx edgar-filings-mcp

pressure.py は EDGAR のライブデータにアクセスするため、EDGAR_IDENTITY が必要です。

ライセンス

MIT。提出書類のデータは SEC EDGAR システムから取得しています。このプロジェクトは SEC と提携していません。