# SEC EDGAR Filings MCP MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-stagproject-sec-filings-mcp
- Repository: https://github.com/stagproject/sec-filings-mcp

## Install
- Endpoint: https://sec-edgar-filings.mcp.xpay.sh/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: key (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://sec-edgar-filings.mcp.xpay.sh/mcp
- Header: key
- Remote endpoint: https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp

## Tools
- 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}
 Endpoint: https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp
- 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"}
 Endpoint: https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp
- 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"
}
 Endpoint: https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.stagproject
- Version: 1.0.2
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 28, 2026
- Source: https://registry.modelcontextprotocol.io