protogrid
Sign inAdd to your agent

Search / io.github.stagproject/sec-filings-mcp

SEC EDGAR Filings MCP

R0· no sign-in

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

v1.0.2 · active · repository · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality76good
Trust87of 100
Uptime, 30 days100%
Latency p50395 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "sec-filings-mcp": {
      "type": "http",
      "url": "https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp"
    }
  }
}
claude mcp add --transport http sec-filings-mcp https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp
[mcp_servers.sec-filings-mcp]
url = "https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sec-filings-mcp": {
      "type": "remote",
      "url": "https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "sec-filings-mcp": {
      "type": "http",
      "url": "https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=sec-filings-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vc2VjLWZpbGluZ3MtbWNwLTEwNjU2MDEyNjQzMzIudXMtY2VudHJhbDEucnVuLmFwcC9tY3AifQ%3D%3D"
}
{
  "servers": {
    "sec-filings-mcp": {
      "type": "http",
      "url": "https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp"
    }
  }
}
{
  "mcpServers": {
    "sec-filings-mcp": {
      "httpUrl": "https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp"
    }
  }
}
extensions:
  "sec-filings-mcp":
    enabled: true
    name: "sec-filings-mcp"
    type: streamable_http
    uri: "https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp"
    timeout: 300

Quality 76 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene64 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • warn
    tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: purchase_filing (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_filing_sample (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); search_filings (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
  • pass
    tools.token_costabout 1,258 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

3 tools, about 1,258 tokens to load them all · tool set 625bebdb66f8 · checked 2026-10-19 19:01 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 87 / 100

provenance80
liveness100
freshness65
hygiene100

+repository +namespace-matches-repo +reachable +uptime-100% ~updated-144d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://sec-edgar-filings.mcp.xpay.sh/mcp streamable-httpapi_key ${KEY}yes100%395 ms–2026-10-19
https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp streamable-httpnoneyes100%195 ms2025-11-252026-10-19

Tools (3)

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"}
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" }
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}

Schemas: list_tools.

Similar MCP servers

  • Filings Intel MCPR0quality 86
    com.datakoot/sec-edgar-filings

    SEC EDGAR filings for AI agents: company lookup, filings, financials, insider trades. No keys.

  • SEC EDGARL0
    io.github.brechanbech/sec-mcp

    MCP server for SEC EDGAR data — company filings, financial concepts, and company info

  • SEC EDGAR Financial DataR2quality 67
    io.github.Taru0208/sec-edgar-mcp-server

    Search SEC EDGAR filings, financial statements, and company data.

  • secedgar-mcp-serverR0quality 78
    io.github.cyanheads/secedgar-mcp-server

    Query SEC EDGAR filings, XBRL financials, and company data via MCP. STDIO or Streamable HTTP.

  • SEC EDGARL0
    io.github.danishashko/edgar-mcp

    SEC EDGAR filings (10-K, 10-Q, 8-K), XBRL financials, and full-text filing search. No API key.

  • EDGAR (SEC filings)L0
    io.github.mcpwright/edgar-mcp

    SEC filings in your agent: issuers, Reg CF/D/A raises, XBRL financials, insider trades.

More from io.github.stagproject

  • mirelia-patent-marketunknown
    io.github.stagproject/mirelia-patent-market

    AI-optimized patent data marketplace providing structured JSON datasets.

Official server.json
{
  "name": "io.github.stagproject/sec-filings-mcp",
  "title": "SEC EDGAR Filings MCP",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://sec-edgar-filings.mcp.xpay.sh/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "key",
          "isSecret": true,
          "isRequired": true,
          "description": "xpay.tools API key (query param). Get one at https://xpay.tools — append as ?key=YOUR_XPAY_KEY to the MCP URL."
        }
      ]
    },
    {
      "url": "https://sec-filings-mcp-1065601264332.us-central1.run.app/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "1.0.2",
  "repository": {
    "url": "https://github.com/stagproject/sec-filings-mcp",
    "source": "github"
  },
  "description": "SEC EDGAR MCP: search, preview, purchase filings. x402 USDC on Polygon. xpay + Cloud Run upstream."
}