SEC EDGAR Filings MCP Server

io.github.stagproject/sec-filings-mcp

answering

SEC EDGAR Filings MCP is answering right now. Last checked 14 min ago. It exposes 3 tools. Last commit 30 May 2026.

SEC EDGAR MCP: search, preview, purchase filings. x402 USDC on Polygon. xpay + Cloud Run upstream.

Uptime history 41 hours of history · worst hour 86%

41 hours agonow

98.9%

Uptime 24h

180 of 182 checks

Tools

read from the server

2426 ms

Response time

average over 24h

Stars

last commit 30 May 2026

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 14 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add sec-filings-mcp --transport http https://sec-edgar-filings.mcp.xpay.sh/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sec-filings-mcp": {
      "url": "https://sec-edgar-filings.mcp.xpay.sh/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.sec-filings-mcp]
url = "https://sec-edgar-filings.mcp.xpay.sh/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "sec-filings-mcp": {
      "url": "https://sec-edgar-filings.mcp.xpay.sh/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "sec-filings-mcp": {
      "url": "https://sec-edgar-filings.mcp.xpay.sh/mcp"
    }
  }
}

This endpoint answered with an authorization challenge — the server is running, but you need an API key or OAuth to use it.

Available tools 3

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

filing

get_filing_sample

Free preview of one SEC filing (agent-friendly compact row from fi_listings_portfolio_compact). [COST: $0] Includes agent_summary and financial_metrics (CompanyFacts-derived) but NOT full alpha_signals / causality_events — those ship only via purchase_filing after x402 payment. Compare with purchase_filing: sample = evaluate quality; purchase = full evidence-backed JSON. [EXAMPLE ARGUMENTS - MINIMAL]: {} [EXAMPLE ARGUMENTS - MAXIMAL]: {"document_id": "000000708426000023"}

filings

search_filings

PRIMARY discovery tool — lightweight catalog over 10k+ SEC filings (fi_listings_portfolio). [COST: low xpay per-call fee] Does NOT return alpha_signals, causality_events, or financial_metrics (use get_filing_sample / purchase_filing). Always returns agent_readiness_score (higher = better structured data) and edgar_url. Required: at least one of ticker, form_type, company_name, fiscal_period, cik (avoids full-table scans). Agent workflow after this call: 1. Shortlist by agent_readiness_score and optional agent_one_liner 2. get_filing_sample(document_id) — free preview 3. purchase_filing(document_id) — paid full JSON (x402) [EXAMPLE ARGUMENTS - MINIMAL]: {"ticker": "AAPL", "limit": 5} [EXAMPLE ARGUMENTS - MAXIMAL]: { "ticker": "ADM", "form_type": "10-Q", "company_name": "Archer", "fiscal_period": "2026Q1", "min_agent_readiness_score": 70, "limit": 20, "offset": 0, "include_one_liner": true } [EXAMPLE ARGUMENTS - PAGINATION (page 2)]: {"ticker": "MSFT", "form_type": "10-K", "limit": 10, "offset": 10}

purchase

purchase_filing

Purchase and deliver one full SEC filing row from fi_listings_portfolio (MPP v1.0 x402). [COST: xpay per-call + on-chain USDC data price (see FINANCE_FILING_PRICE_USD)] Full JSON includes alpha_signals with evidence_verified causality_events and financial_metrics from SEC CompanyFacts. Do NOT return agent_bundle or internal pipeline fields. [AGENTIC WORKFLOW — mandatory 2-step 402 flow]: STEP 1: Call with document_id and network only; leave tx_hash EMPTY. STEP 2: Broadcast the exact transaction_payload on-chain (polygon USDC default). STEP 3: Call again with the same document_id, network, and confirmed tx_hash (66 chars). [EXAMPLE ARGUMENTS - MINIMAL (Step 1 — payment info)]: {"document_id": "000000708426000023", "network": "polygon"} [EXAMPLE ARGUMENTS - MAXIMAL (Step 3 — claim data)]: { "document_id": "000000708426000023", "network": "polygon", "tx_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef" }

Endpoints

URL	Transport	State	Latency	Checked
https://sec-edgar-filings.mcp.xpay.sh/mcp	streamable-http	needs key	211 ms	15 min ago
https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp	streamable-http	answering	227 ms	14 min ago

SEC EDGAR Filings MCP — questions

Answers built from our own checks of this server.

What can SEC EDGAR Filings MCP do?

It exposes 3 tools, read directly from the server on our last check. Among them: get_filing_sample, purchase_filing, search_filings. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is SEC EDGAR Filings MCP working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 180 of 182 checks got a reply (98.9%), average response time 2426 ms. The bar chart above shows every period we have measured.

How do I connect SEC EDGAR Filings MCP?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address. You will need your own key or an OAuth login: it refuses anonymous clients.

Does SEC EDGAR Filings MCP need an API key?

Yes. Every time we knock, SEC EDGAR Filings MCP answers with an authorization challenge instead of its tool list — that is how we know it is running and gated rather than broken. Bring your own credentials and it will talk.

Is SEC EDGAR Filings MCP open source?

Yes — it is published under the MIT licence, written in Python and 2 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.