SEC EDGAR Filings MCP

sec-filings-mcp

面向 Agent 的 SEC EDGAR 结构化申报 MCP：search_filings、get_filing_sample、purchase_filing。数据存储在 Supabase 视图（fi_listings_portfolio、fi_listings_portfolio_compact）中，由 finance-factory 流水线填充。

优先阅读	文件
无需 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 已列入路线图；目前 Agent 通过 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 注册 / 管理。Slug：sec-edgar-filings。
发布者检查清单（金融合集、精选列表）：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。