{
  "name": "SEC EDGAR Filings for Agents",
  "slug": "sec-edgar-filings",
  "description": "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.",
  "toolCount": 3,
  "tools": [
    {
      "name": "search_filings",
      "description": "\nPRIMARY discovery tool — lightweight catalog over 10k+ SEC filings (fi_listings_portfolio).\n[COST: low xpay per-call fee]\nDoes NOT return alpha_signals, causality_events, or financial_metrics (use get_filing_sample / purchase_filing).\nAlways returns agent_readiness_score (higher = better structured data) and edgar_url.\n\nRequired: at least one of ticker, form_type, company_name, fiscal_period, cik (avoids full-table scans).\n\nAgent workflow after this call:\n1. Shortlist by agent_readiness_score and optional agent_one_liner\n2. get_filing_sample(document_id) — free preview\n3. purchase_filing(document_id) — paid full JSON (x402)\n\n[EXAMPLE ARGUMENTS - MINIMAL]:\n{\"ticker\": \"AAPL\", \"limit\": 5}\n\n[EXAMPLE ARGUMENTS - MAXIMAL]:\n{\n  \"ticker\": \"ADM\",\n  \"form_type\": \"10-Q\",\n  \"company_name\": \"Archer\",\n  \"fiscal_period\": \"2026Q1\",\n  \"min_agent_readiness_score\": 70,\n  \"limit\": 20,\n  \"offset\": 0,\n  \"include_one_liner\": true\n}\n\n[EXAMPLE ARGUMENTS - PAGINATION (page 2)]:\n{\"ticker\": \"MSFT\", \"form_type\": \"10-K\", \"limit\": 10, \"offset\": 10}\n",
      "price": 0
    },
    {
      "name": "get_filing_sample",
      "description": "\nFree preview of one SEC filing (agent-friendly compact row from fi_listings_portfolio_compact).\n[COST: $0]\nIncludes agent_summary and financial_metrics (CompanyFacts-derived) but NOT full\nalpha_signals / causality_events — those ship only via purchase_filing after x402 payment.\nCompare with purchase_filing: sample = evaluate quality; purchase = full evidence-backed JSON.\n\n[EXAMPLE ARGUMENTS - MINIMAL]:\n{}\n\n[EXAMPLE ARGUMENTS - MAXIMAL]:\n{\"document_id\": \"000000708426000023\"}\n",
      "price": 0
    },
    {
      "name": "purchase_filing",
      "description": "\nPurchase and deliver one full SEC filing row from fi_listings_portfolio (MPP v1.0 x402).\n[COST: xpay per-call + on-chain USDC data price (see FINANCE_FILING_PRICE_USD)]\nFull JSON includes alpha_signals with evidence_verified causality_events and financial_metrics\nfrom SEC CompanyFacts. Do NOT return agent_bundle or internal pipeline fields.\n\n[AGENTIC WORKFLOW — mandatory 2-step 402 flow]:\nSTEP 1: Call with document_id and network only; leave tx_hash EMPTY.\nSTEP 2: Broadcast the exact transaction_payload on-chain (polygon USDC default).\nSTEP 3: Call again with the same document_id, network, and confirmed tx_hash (66 chars).\n\n[EXAMPLE ARGUMENTS - MINIMAL (Step 1 — payment info)]:\n{\"document_id\": \"000000708426000023\", \"network\": \"polygon\"}\n\n[EXAMPLE ARGUMENTS - MAXIMAL (Step 3 — claim data)]:\n{\n  \"document_id\": \"000000708426000023\",\n  \"network\": \"polygon\",\n  \"tx_hash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\"\n}\n",
      "price": 0
    }
  ],
  "mcpUrl": "https://sec-edgar-filings.mcp.xpay.sh/mcp",
  "portal": "https://sec-edgar-filings.on.xpay.sh",
  "llmsTxt": "https://sec-edgar-filings.mcp.xpay.sh/llms.txt",
  "status": "active",
  "isPlatform": false
}