{"name":"io.github.stagproject/sec-filings-mcp","slug":"stagproject-sec-filings-mcp","title":"SEC EDGAR Filings MCP","description":"SEC EDGAR MCP: search, preview, purchase filings. x402 USDC on Polygon. xpay + Cloud Run upstream.","url":"https://mcp.market/server/stagproject-sec-filings-mcp","rating":null,"grade":"B","score":77,"certified":false,"status":"active","category":"search","tags":["search"],"presence":{"score":16,"stars":2,"forks":0,"downloads_week":null,"last_push_at":"2026-05-30T15:44:25.000Z","license":"MIT"},"uptime":{"percent":100,"checks":28,"ok":28,"last_checked_at":"2026-11-04T01:30:36.919Z","last_ok_at":"2026-11-04T01:30:36.919Z","latency_ms":167},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/stagproject/sec-filings-mcp","website":null,"version":"1.0.2","remotes":[{"type":"streamable-http","url":"https://sec-edgar-filings.mcp.xpay.sh/mcp","headers":[{"description":"xpay.tools API key (query param). Get one at https://xpay.tools — append as ?key=YOUR_XPAY_KEY to the MCP URL.","isRequired":true,"isSecret":true,"name":"key"}]},{"type":"streamable-http","url":"https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp"}],"packages":[],"tools":[{"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","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"document_id from search_filings. Defaults to demo ADM 10-Q (000000708426000023).","title":"Document Id"}},"title":"get_filing_sampleArguments"}},{"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","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"document_id":{"description":"document_id from search_filings or get_filing_sample.","title":"Document Id","type":"string"},"network":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"polygon","description":"Blockchain network. Default polygon (USDC). Also supports base.","title":"Network"},"tx_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Transaction hash. LEAVE EMPTY on first call to receive 402 payment instructions.","title":"Tx Hash"}},"required":["document_id"],"title":"purchase_filingArguments"}},{"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","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Ticker prefix, case-insensitive (e.g. AAPL, MSFT). At least one filter required.","title":"Ticker"},"form_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"SEC form: 10-K, 10-Q, 8-K, etc.","title":"Form Type"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Substring match on company_name (e.g. Apple, Archer-Daniels).","title":"Company Name"},"fiscal_period":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Fiscal period label (e.g. 2026Q1, 2025FY).","title":"Fiscal Period"},"cik":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"SEC CIK prefix (digits, e.g. 0000320193).","title":"Cik"},"min_agent_readiness_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum agent_readiness_score (0–100). Use 70+ for production-quality rows.","title":"Min Agent Readiness Score"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":10,"description":"Page size (1–100). Default 10 keeps payloads small for LLM context.","title":"Limit"},"offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":0,"description":"Skip rows for pagination (e.g. 10 for page 2 when limit=10).","title":"Offset"},"include_one_liner":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"If true, adds agent_one_liner (~1 sentence) per row for triage without calling get_filing_sample. Slightly heavier response.","title":"Include One Liner"}},"title":"search_filingsArguments"}}],"scan":{"score":77,"grade":"B","scanned_at":"2026-09-27T17:05:47.652Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-27T17:05:47.635Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 239ms (auth required)"]},"poisoning":{"score":15,"max":15,"notes":["3 tool descriptions checked"]},"auth":{"score":9,"max":15,"notes":["auth enforced (unknown)"]},"maintenance":{"score":8,"max":15,"notes":["last push 120 days ago"]},"identity":{"score":6,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[],"inputs":{"probes":[{"url":"https://sec-edgar-filings.mcp.xpay.sh/mcp","reachable":true,"authRequired":true,"latencyMs":239,"authScheme":"unknown"},{"url":"https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp","reachable":true,"authRequired":false,"latencyMs":219,"serverInfo":{"name":"SEC Filings Agent Marketplace","version":"1.26.0"}}],"packages":[],"repo":{"found":true,"owner":"stagproject","repo":"sec-filings-mcp","archived":false,"pushedAt":"2026-05-30T15:44:25Z","stars":2,"forks":0,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/246415583?v=4","ownerCreatedAt":"2025-11-27T04:08:04Z","license":"MIT"},"icon":{"url":null,"source":"none"},"presence":{"stars":2,"forks":0,"downloadsWeek":null,"license":"MIT","lastPushAt":"2026-05-30T15:44:25.000Z","score":16}}}},"grade_history":[],"reviews":[]}