SEC EDGAR Filings MCP

sec-filings-mcp

エージェント向けの SEC EDGAR 構造化申告書 MCP：search_filings、get_filing_sample、purchase_filing。データは、finance-factory パイプラインによって作成された Supabase ビュー（fi_listings_portfolio、fi_listings_portfolio_compact）に格納されています。

まず読むもの	ファイル
xpay キーなしで試す	docs/TRY_WITHOUT_XPAY.md — Glama サンドボックスまたは Cloud Run アップストリーム
配布（あなたとリポジトリ）	docs/DISTRIBUTION.md · docs/HANDOFF.md
ビルド／引き継ぎ	MCP_FINANCE_BUILD.md
環境変数テンプレート	.env.example → .env にコピー
Glama	glama.json（maintainers: stagproject）；ビルドの修正：GLAMA_BUILD.md
A2A／x402	docs/A2A.md — Agent Card と決済のマッピング
MCP Registry	io.github.stagproject/sec-filings-mcp — docs/MCP_REGISTRY.md
ディスカバリー URL	docs/DISCOVERY.md

テンプレートの参照先：mcp_server.py（特許 MCP、未変更）。ランタイム： mcp_server_finance.py。

プロトコルスタック（MCP + A2A + x402）

レイヤー	使用方法
MCP（本番）	下記の xpay URL — search_filings、get_filing_sample、purchase_filing に対する tools/call
A2A（ディスカバリー）	Cloud Run アップストリーム上の Agent Card（xpay は /.well-known/* をブロック）：https://sec-filings-mcp-1065601264332.us-central1.run.app/.well-known/agent-card.json
x402（決済）	purchase_filing — 402 + Polygon USDC + tx_hash による再配信

ネイティブ A2A JSON-RPC タスク API はロードマップにあります。現時点では、エージェントは MCP Streamable HTTP 経由で呼び出します。詳細：docs/A2A.md。

まず試す（xpay API キー不要）

方法	URL／操作
Glama サンドボックス	サーバーを開く → ブラウザーで試す
Cloud Run トライアル	https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp — ?key= なしで search_filings + get_filing_sample を利用

詳細：docs/TRY_WITHOUT_XPAY.md。
xpay プロキシには常にキーが必要です。xpay ではツールごとに $0 に設定できます（ドキュメント）が、これは「登録不要」と同じではありません。

接続（本番）

エンドポイント	URL
xpay（課金 + カタログ）	https://sec-edgar-filings.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY
Cloud Run（アップストリーム）	https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp

xpay.tools で登録／管理します。スラッグ：sec-edgar-filings。
公開者向けチェックリスト（finance collection、awesome list）：docs/DISTRIBUTION.md。

ローカル開発

git clone https://github.com/stagproject/sec-filings-mcp.git
cd sec-filings-mcp
copy .env.example .env
# Edit .env with Supabase + x402 keys
uv sync
# Run once in Supabase SQL Editor: sql/fi_processed_transactions.sql
uv run python mcp_server_finance.py --sse
# MCP: http://127.0.0.1:8081/mcp  (PORT in .env)

テスト：

uv run python test_finance_mcp.py
uv run python test_finance_mcp.py --xpay-only --e2e

Cloud Run

gcloud run deploy sec-filings-mcp `
  --source . `
  --region us-central1 `
  --allow-unauthenticated `
  --port 8080

.env（コミット対象外）から環境変数を設定します。.env.cloudrun.yaml を git にデプロイしないでください。

Glama

glama.ai/mcp/servers/stagproject/sec-filings-mcp に掲載されています。キー不要のサンドボックスには ブラウザーで試す を使用してください。本番トラフィックには、上記の xpay または Cloud Run を使用します。

MCP Registry

io.github.stagproject/sec-filings-mcp

公開／更新：docs/MCP_REGISTRY.md。検索：https://registry.modelcontextprotocol.io

ライセンス

MIT — LICENSE.md を参照してください。