protogrid

Search / io.github.jethrokirk-sudo/filingapi

filingapi

R0· no sign-in

SEC filings, earnings transcripts, guidance signals & macro calendar for S&P 500. 11 MCP tools.

v1.0.0 · active · descriptor JSON · versions

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

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "filingapi": {
      "type": "http",
      "url": "https://mcp.filingapi.dev/mcp",
      "headers": {
        "": "$${FILINGAPI_KEY}"
      }
    }
  }
}
claude mcp add --transport http filingapi https://mcp.filingapi.dev/mcp --header ": $${FILINGAPI_KEY}"
[mcp_servers.filingapi]
url = "https://mcp.filingapi.dev/mcp"
http_headers = { "" = "$${FILINGAPI_KEY}" }
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "filingapi": {
      "type": "remote",
      "url": "https://mcp.filingapi.dev/mcp",
      "enabled": true,
      "headers": {
        "": "${env:FILINGAPI_KEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "filingapi": {
      "type": "http",
      "url": "https://mcp.filingapi.dev/mcp",
      "headers": {
        "": "$${FILINGAPI_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=filingapi&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmZpbGluZ2FwaS5kZXYvbWNwIiwiaGVhZGVycyI6eyIiOiIkJHtGSUxJTkdBUElfS0VZfSJ9fQ%3D%3D"
}
{
  "servers": {
    "filingapi": {
      "type": "http",
      "url": "https://mcp.filingapi.dev/mcp",
      "headers": {
        "": "$${FILINGAPI_KEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "filingapi": {
      "httpUrl": "https://mcp.filingapi.dev/mcp",
      "headers": {
        "": "$${FILINGAPI_KEY}"
      }
    }
  }
}
extensions:
  "filingapi":
    enabled: true
    name: "filingapi"
    type: streamable_http
    uri: "https://mcp.filingapi.dev/mcp"
    headers:
      "": "$${FILINGAPI_KEY}"
    timeout: 300

Quality 79 / 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 hygiene71 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • 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: get_guidance (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_transcript (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_sector_filings (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
  • pass
    tools.token_costabout 1,362 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

10 tools, about 1,362 tokens to load them all · tool set c2a8786b0c15 · checked 2026-10-19 14:42 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 70 / 100

no-repository
provenance35
liveness100
freshness65
hygiene80

+reachable +uptime-100% ~updated-103d-ago -no-repository

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://mcp.filingapi.dev/mcp streamable-httpnoneyes100%246 ms2025-11-252026-10-19

Tools (10)

get_company_infoGet sector, industry, and data coverage info for a company. Returns the company's GICS sector and industry classification, plus counts of available filings and transcripts.
get_earnings_calendarGet upcoming earnings announcement dates with EPS and revenue estimates. Defaults to the next 7 days if no dates specified. Use this when asked about upcoming earnings, who reports this week, or when a specific company's next earnings date is.
get_filing_detailGet the full detail of a single SEC filing by ticker and accession number (the unique SEC filing ID, e.g. '0000320193-26-000011'). Use this after get_filings or get_guidance has identified a specific filing you want to inspect in full.
get_filingsGet SEC filings (8-K, 10-Q, etc.) for a company by ticker symbol. Use this to see what filings are available for a company, with dates and accession numbers. Does not include guidance extraction - use get_guidance for that.
get_guidanceGet forward-looking guidance language extracted from a company's SEC filings, by ticker symbol. Use this when asked what a company said about future performance, revenue outlook, margin expectations, or other forward-looking statements. Note: results are keyword-matched sentences from filings and may include both forward guidance and recent reported results - read each sentence carefully to distinguish actual forward guidance from historical figures.
get_sector_filingsGet recent SEC filings for all companies in a given sector. Sector names are case-insensitive, e.g. "Technology", "Energy", "Healthcare". Use list_sectors first if unsure of exact names. Optionally filter by event_type (earnings_release, acquisition, executive_change, restructuring, dividend, guidance_update).
get_signalsGet real-time AI sentiment signals derived from SEC 8-K filings. Each signal includes: ticker, bullish/bearish/neutral classification, confidence score (-100 to 100), a one-line summary, and key factors. Signals are generated by Claude Haiku within minutes of EDGAR publication. Use this when asked which companies have recently filed bullish or bearish 8-Ks, or to screen for sentiment shifts across the S&P 500. Default window is 30 days; set hours=24 for today only.
get_transcriptGet all available earnings call transcripts for a company by ticker. Returns a list of transcripts (each with fiscal_quarter, fiscal_year, date, and speakers). If asked about a specific quarter, look for it within the returned list rather than expecting a single result - this endpoint does not currently filter server-side. Use this when asked what was said on an earnings call, as opposed to in written SEC filings.
list_sectorsList all available sectors with the number of tickers in each. Use this when asked about sectors, industries, or to find which sector a type of company falls under. Returns 11 GICS sectors covering the S&P 500.
search_filingsSearch across all SEC filings in the database by keyword, optionally filtered by ticker and date range (YYYY-MM-DD format). Use this for open-ended questions like "which companies mentioned supply chain issues" rather than looking up one known ticker.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.jethrokirk-sudo/filingapi",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.filingapi.dev/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "",
          "value": "${FILINGAPI_KEY}"
        }
      ]
    }
  ],
  "version": "1.0.0",
  "description": "SEC filings, earnings transcripts, guidance signals & macro calendar for S&P 500. 11 MCP tools."
}