EdgarParser MCP

edgar-mcp

AI エージェント向けの SEC EDGAR 財務データを、MCP stdio サーバーとして提供します。

インストール

pip install edgar-mcp

設定

変数	必須	用途
EDGAR_API_KEY	ホスト型ツール	ホスト型 EDGAR API の API キーです。get_issuer_submissions_meta では使用されません。
EDGAR_API_URL	いいえ	API のベース URL を上書きします。デフォルトは https://www.edgarparser.com です。
EDGAR_MCP_OUTPUT_DIR	いいえ	output="file" のツール応答を保存するディレクトリです。

Claude Desktop / Claude Code の設定：

{
  "mcpServers": {
    "edgar-financials": {
      "type": "stdio",
      "command": "edgar-mcp",
      "env": {
        "EDGAR_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

ツール一覧

このパッケージは、32 個の公開 MCP ツールを提供します。以下の一覧は、ホスト型 API ドキュメントの生成にも使用されるマニフェストから生成されています。

ツール	概要	ティア	キャッシュの動作
get_filings	1つのティッカーと期間について、提出書類のメタデータとSECアクセッションの詳細を返します。	public	cache_only
get_event_filings	ティッカー、CIK、日付範囲、様式の種類、またはクエリでイベント関連の提出書類を検索します。	public	cold_allowed
describe_filing	1つの提出書類について、財務情報、セクション、表、Markdown、抽出結果のキャッシュ状況を表示します。	public	cache_only
get_filing_document	セクションの絞り込みとページネーションに対応した、読みやすいMarkdown形式の提出書類を返します。	registered	cold_allowed
get_filing_sections	選択した定性的な提出書類のセクションと、任意の埋め込み表を抽出します。	public	cold_allowed
get_filing_cover_facts	株式数など、出典を付記した正確なDEI表紙ページの事実情報を返します。	registered	cold_allowed
get_filing_evidence	SECに関する定性的な質問向けに、引用可能な提出書類の証拠を計画して取得します。	paid	llm_call
get_issuer_submissions_meta	SECの公開JSONエンドポイントから、発行体のSEC提出書類ヘッダーのメタデータを直接返します。	public	cold_allowed
get_operational_kpi_drivers	提出書類の説明文とMarkdown表を調査し、業務KPIの値とその背景要因を取得します。	paid	llm_call
get_operational_kpi_driver_rows	トランスポートによる再解釈を介さず、生成元が所有する厳密な業務KPI要因行DTOを返します。	paid	cold_allowed
get_filing_extractions	1つの提出書類について、キャッシュ済みのlangextractスパンを返すか、キャッシュミス時に有料の抽出を実行します。	paid	llm_call
search_extractions	構造化フィルターを使って、複数の提出書類にまたがるキャッシュ済みのlangextractスパンを検索します。	paid	cache_only
get_extraction_series	キャッシュ済みのlangextractスパンについて、期間別の件数と任意の検索結果を返します。	paid	cache_only
extract_filing_file	get_filing_sectionsが発行した短期間有効の提出書類アーティファクトに対し、選択した抽出スキーマを実行します。	internal	llm_call
list_extraction_schemas	内部ドキュメントAPIで利用できるドキュメント抽出スキーマを一覧表示します。	internal	cache_only
get_filing_tables	提出書類の表のメタデータ、または構造化された表を展開して返します。	public	cold_allowed
search_filing_tables	ティッカーと期間の範囲を指定して、キャッシュ済みの提出書類の表メタデータを検索します。	public	cache_only
compare_filing_tables	複数のティッカーにまたがる一致した提出書類の表を比較します。	public	cache_only
search_filing_text	1つの提出書類内のキャッシュ済みMarkdownを検索し、一致するスパンを返します。	registered	cache_only
get_financials	1つの会計期間について、マッチャーが生成した数値の財務行を返します。	public	cache_only
get_filing_facts	正確なSEC提出書類アクセッションから、正確なQNameのファクト、または財務諸表や注記の表示箇所全体を取得します。	registered	cold_allowed
get_metric	検出された1つの指標またはXBRLタグについて、現在値、前期値、前年同期比の値を返します。	public	cache_only
get_metric_series	複数の期間にわたる1つの指標を、期間ごとのキャッシュ状況とカバレッジ状況とともに返します。	public	cache_only
list_metrics	1つの提出書類期間で利用可能な、正確な指標候補を一覧表示します。	public	cache_only
search_metrics	自然言語のクエリで提出書類の指標を検索し、順位付けされた正確な候補を返します。	public	cold_allowed
get_statement	キャッシュ済みの概念から、テンプレートに基づく損益計算書、貸借対照表、またはキャッシュフロー計算書を返します。	public	cache_only
get_concept	キャッシュ済みの提出書類ファクトから、レジストリに登録された1つの財務概念を解決します。	public	cache_only
compare_concept	呼び出し元が指定したティッカーのセットについて、レジストリに登録された1つの概念を比較します。	public	cache_only
concept_trend	指定した期間範囲について、キャッシュのみを使った概念の時系列を返します。	public	cache_only
cite_concept	レジストリに登録された概念の値を、提出書類の説明文および任意の抽出証拠と結び付けます。	paid	cache_only
warm_metric_cache	後続の読み取りに備え、指標の各期間について有料ティアのバックグラウンドキャッシュウォームアップをキューに登録します。	paid	cold_allowed
warm_metric_cache_status	warm_metric_cacheが返したバックグラウンドのキャッシュウォームアップジョブの状態を確認します。	paid	cache_only

ツールファミリー

提出書類のメタデータと文書

get_filings、get_event_filings、describe_filing、get_filing_document、get_filing_sections、get_filing_cover_facts、get_filing_evidence、get_issuer_submissions_meta

運用 KPI

get_operational_kpi_drivers、get_operational_kpi_driver_rows

LangExtract

get_filing_extractions、search_extractions、get_extraction_series、extract_filing_file、list_extraction_schemas

提出書類の表

get_filing_tables、search_filing_tables、compare_filing_tables

提出書類のテキスト

search_filing_text

XBRL とコンセプト

get_financials、get_filing_facts、get_metric、get_metric_series、list_metrics、search_metrics、get_statement、get_concept、compare_concept、concept_trend、cite_concept、warm_metric_cache、warm_metric_cache_status

実行時の注意事項

• これはホスト型 EDGAR API と公開 SEC 提出書類エンドポイントを利用する薄いクライアントであり、提出書類をローカルで解析しません。
• EDGAR_API_KEY がないか無効な場合でもサーバーは起動しますが、ホスト型 API のツール呼び出しでは認証エラーが返されます。get_issuer_submissions_meta ではキーは不要です。
• 大容量のペイロードを扱うツールは output="file" に対応しており、EDGAR_MCP_OUTPUT_DIR またはローカルのフォールバックディレクトリに書き込みます。
• API のレート制限と有料ツールへのアクセスは、ホスト型サービスによって適用されます。

リンク

• ホスト型 API：https://www.edgarparser.com
• ドキュメント：https://docs.edgarparser.com
• MCP のセットアップ：https://docs.edgarparser.com/mcp
• ツールリファレンス：https://docs.edgarparser.com/tools
• 変更履歴 RSS：https://docs.edgarparser.com/rss.xml
• アプリ内の開発者向けページ：https://www.edgarparser.com/developers
• オープンパーサーパッケージ：https://github.com/henrysouchien/edgar-parser
• ソースパッケージ：https://github.com/henrysouchien/edgar-mcp