# SEC EDGAR Filings for Agents
> Agent-native SEC EDGAR data: search 10-K/10-Q, free compact previews, then buy full filings with CompanyFacts metrics and evidence-verified causality chains. MPP v1.0 x402 USDC on Polygon.

## MCP Server URL
https://sec-edgar-filings.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY

## 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}
 (FREE — no charge)
- 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"}
 (FREE — no charge)
- 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"
}
 (FREE — no charge)

## Get Started
1. Get an API key at https://xpay.tools
2. Add the MCP server URL to your MCP client config (Claude, Cursor, Windsurf, etc.)
3. Pay per tool call from your XPay wallet — no subscriptions

## Connection Config
```json
{
  "mcpServers": {
    "sec-edgar-filings": {
      "url": "https://sec-edgar-filings.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"
    }
  }
}
```

## Pricing
- search_filings: FREE (no charge, API key still required)
- get_filing_sample: FREE (no charge, API key still required)
- purchase_filing: FREE (no charge, API key still required)

Note: Searching and listing content is free. Reading full articles in markdown is charged. All tools require a valid API key.

## About
Powered by XPay — pay-per-use API access for AI agents.
https://xpay.tools