Official description7 sourcesMCP servers8d ago
stagproject/sec-filings-mcp
SEC EDGAR filing MCP for agents - search, preview, purchase (x402).
View on GitHub ↗Direct link · no redirect page
Config template (adjust for your client)
claude mcp add sec-filings-mcp -- npx -y sec-filings-mcp
A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.
- Star count
- 2 ★ · stagproject/sec-filings-mcp · read from the repository page · (checked 2026-10-16 20:00:20)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-10-09 · last seen 2026-10-16 · seen 32× · listed by 7 sources
- Score
- score 703 · 2 ★ · 7 sources · mcp
FAQ (answers come from our records)
How do I install it?
We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.
Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
stagproject/sec-filings-mcp；first catalogued 2026-10-09；last seen 2026-10-16。There is no official certification or quality rating here — we record sources and dates only.Third-party quality signals
# sec-filings-mcp
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
SEC EDGAR structured filing MCP for agents: **search_filings**, **get_filing_sample**, **purchase_filing**. Data lives in Supabase views (fi_listings_portfolio, fi_listings_portfolio_compact) populated by the finance-factory pipeline.
| Read first | File |
|------------|------|
| **Try without xpay key** | docs/TRY_WITHOUT_XPAY.md — Glama sandbox or Cloud Run upstream |
| Distribution (you vs repo) | docs/DISTRIBUTION.md · docs/HANDOFF.md |
| Build / handoff | MCP_FINANCE_BUILD.md |
| Env template | .env.example → copy to .env |
| Glama | glama.json (maintainers: stagproject); build fix: GLAMA_BUILD.md |
| A2A / x402 | docs/A2A.md — Agent Card + payment mapping |
| MCP Registry | io.github.stagproject/sec-filings-mcp — docs/MCP_REGISTRY.md |
| Discovery URLs | docs/DISCOVERY.md |
Template reference: mcp_server.py (patent MCP, unmodified). **Runtime:** mcp_server_finance.py.
Protocol stack (MCP + A2A + x402)
| Layer | How to use |
|-------|------------|
| **MCP (production)** | xpay URL below — tools/call on search_filings, get_filing_sample, purchase_filing |
| **A2A (discovery)** | Agent Card on Cloud Run upstream (xpay blocks /.well-known/*): https://sec-filings-mcp-1065601264332.us-central1.run.app/.well-known/agent-card.json |
| **x402 (payment)** | purchase_filing — 402 + Polygon USDC + tx_hash redelivery |
Native A2A JSON-RPC task API is on the roadmap; today agents invoke via **MCP Streamable HTTP**. Details: docs/A2A.md.
Try first (no xpay API key)
| Path | URL / action |
|------|----------------|
| **Glama sandbox** | Open server → **Try in Browser** |
| **Cloud Run trial** | https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp — search_filings + get_filing_sample without ?key= |
Details: docs/TRY_WITHOUT_XPAY.md.
xpay proxy always needs a key; per-tool **$0** is allowed on xpay (docs) but is not the same as “no signup.”
Connect (production)
| Endpoint | URL |
|----------|-----|
| **xpay (billing + catalog)** | https://sec-edgar-filings.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY |
| Cloud Run (upstream) | https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp |
Register / manage on xpay.tools. Slug: sec-edgar-filings.
Publisher checklist (finance collection, awesome list): docs/DISTRIBUTION.md.
| Read first | File |
|------------|------|
| **Try without xpay key** | docs/TRY_WITHOUT_XPAY.md — Glama sandbox or Cloud Run upstream |
| Distribution (you vs repo) | docs/DISTRIBUTION.md · docs/HANDOFF.md |
| Build / handoff | MCP_FINANCE_BUILD.md |
| Env template | .env.example → copy to .env |
| Glama | glama.json (maintainers: stagproject); build fix: GLAMA_BUILD.md |
| A2A / x402 | docs/A2A.md — Agent Card + payment mapping |
| MCP Registry | io.github.stagproject/sec-filings-mcp — docs/MCP_REGISTRY.md |
| Discovery URLs | docs/DISCOVERY.md |
Template reference: mcp_server.py (patent MCP, unmodified). **Runtime:** mcp_server_finance.py.
Protocol stack (MCP + A2A + x402)
| Layer | How to use |
|-------|------------|
| **MCP (production)** | xpay URL below — tools/call on search_filings, get_filing_sample, purchase_filing |
| **A2A (discovery)** | Agent Card on Cloud Run upstream (xpay blocks /.well-known/*): https://sec-filings-mcp-1065601264332.us-central1.run.app/.well-known/agent-card.json |
| **x402 (payment)** | purchase_filing — 402 + Polygon USDC + tx_hash redelivery |
Native A2A JSON-RPC task API is on the roadmap; today agents invoke via **MCP Streamable HTTP**. Details: docs/A2A.md.
Try first (no xpay API key)
| Path | URL / action |
|------|----------------|
| **Glama sandbox** | Open server → **Try in Browser** |
| **Cloud Run trial** | https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp — search_filings + get_filing_sample without ?key= |
Details: docs/TRY_WITHOUT_XPAY.md.
xpay proxy always needs a key; per-tool **$0** is allowed on xpay (docs) but is not the same as “no signup.”
Connect (production)
| Endpoint | URL |
|----------|-----|
| **xpay (billing + catalog)** | https://sec-edgar-filings.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY |
| Cloud Run (upstream) | https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp |
Register / manage on xpay.tools. Slug: sec-edgar-filings.
Publisher checklist (finance collection, awesome list): docs/DISTRIBUTION.md.
- Source
- awesome · https://github.com/stagproject/sec-filings-mcp
- Browse by field
- MCP servers
- Traction
- 2 ★
- added
- yesterday
More in MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.