SEC EDGAR Filings MCP
This server enables agents to discover, preview, and purchase structured SEC EDGAR filing data with AI-ready metadata and financial signals via three tools:
search_filings: Discover filings from a catalog of 10,000+ SEC filings by filtering on ticker, form type (10-K, 10-Q, 8-K, etc.), company name, fiscal period, or CIK. Returns agent readiness scores, EDGAR URLs, and optional one-liner summaries. Supports pagination.get_filing_sample: Retrieve a free compact preview of a specific filing (bydocument_id), including an agent summary and financial metrics — useful for evaluating data quality before purchasing.purchase_filing: Acquire the full filing JSON via a two-step on-chain USDC payment (x402 flow on Polygon or Base). Full data includes alpha signals, evidence-verified causality events, and detailed financial metrics not available in the free sample.
The three tools are designed for a structured agent workflow — search → sample (free) → purchase (paid) — minimizing cost while allowing quality evaluation before committing to a purchase.
Provides access to SEC EDGAR structured filings stored in a Supabase database, enabling search, preview, and purchase of filing data.
# sec-filings-mcp
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) | |
Build / handoff | |
Env template | .env.example → copy to |
Glama | glama.json ( |
A2A / x402 | docs/A2A.md — Agent Card + payment mapping |
MCP Registry |
|
Discovery URLs |
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 — |
A2A (discovery) | Agent Card on Cloud Run upstream (xpay blocks |
x402 (payment) |
|
Native A2A JSON-RPC task API is on the roadmap; today agents invoke via MCP Streamable HTTP. Details: docs/A2A.md.
Related MCP server: edgar-mcp
Try first (no xpay API key)
Path | URL / action |
Glama sandbox | Open server → Try in Browser |
Cloud Run trial |
|
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) |
|
Cloud Run (upstream) |
|
Register / manage on xpay.tools. Slug: sec-edgar-filings.
Publisher checklist (finance collection, awesome list): docs/DISTRIBUTION.md.
Local dev
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)Tests:
uv run python test_finance_mcp.py
uv run python test_finance_mcp.py --xpay-only --e2eCloud Run
gcloud run deploy sec-filings-mcp `
--source . `
--region us-central1 `
--allow-unauthenticated `
--port 8080Set env vars from .env (not committed). Do not deploy .env.cloudrun.yaml to git.
Glama
Listed at glama.ai/mcp/servers/stagproject/sec-filings-mcp — use Try in Browser for a no-key sandbox; production traffic uses xpay or Cloud Run above.
MCP Registry
io.github.stagproject/sec-filings-mcpPublish / update: docs/MCP_REGISTRY.md. Search: https://registry.modelcontextprotocol.io
License
MIT — see LICENSE.md.
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/stagproject/sec-filings-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server