{"server":{"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."},"_meta":{"io.modelcontextprotocol.registry/official":{"status":"active","isLatest":true,"updatedAt":"2026-07-08T10:29:36.563774Z","publishedAt":"2026-07-08T10:29:36.563774Z","statusChangedAt":"2026-07-08T10:29:36.563774Z"},"dev.protogrid/connectability":{"class":"R0","autonomous":true,"human_steps":[],"preferred":{"kind":"remote","idx":0},"remotes":[{"idx":0,"url":"https://mcp.filingapi.dev/mcp","transport":"streamable-http","templated":false,"headers":[{"name":"","required":false,"secret":false,"value":"${FILINGAPI_KEY}","secret_names":[]}],"auth":{"type":"none","location":null,"secret_name":null,"oauth":null},"protocol":{"supported_versions":["2025-11-25"],"stateless":false},"health":{"reachable":true,"uptime_30d":1,"latency_ms_p50":247,"consecutive_failures":0,"last_probe_at":"2026-10-19T17:10:30.636Z","last_ok_at":"2026-10-19T17:10:30.636Z"}}],"packages":[]},"dev.protogrid/tools":[{"name":"get_company_info","title":null,"description":"Get sector, industry, and data coverage info for a company.\n\n    Returns the company's GICS sector and industry classification,\n    plus counts of available filings and transcripts.\n    ","annotations":null,"source":"probe","observed_at":"2026-10-19T17:10:30.636Z"},{"name":"get_earnings_calendar","title":null,"description":"Get upcoming earnings announcement dates with EPS and revenue\n    estimates. Defaults to the next 7 days if no dates specified.\n\n    Use this when asked about upcoming earnings, who reports this week,\n    or when a specific company's next earnings date is.\n    ","annotations":null,"source":"probe","observed_at":"2026-10-19T17:10:30.636Z"},{"name":"get_filing_detail","title":null,"description":"Get the full detail of a single SEC filing by ticker and accession\n    number (the unique SEC filing ID, e.g. '0000320193-26-000011').\n\n    Use this after get_filings or get_guidance has identified a specific\n    filing you want to inspect in full.\n    ","annotations":null,"source":"probe","observed_at":"2026-10-19T17:10:30.636Z"},{"name":"get_filings","title":null,"description":"Get SEC filings (8-K, 10-Q, etc.) for a company by ticker symbol.\n\n    Use this to see what filings are available for a company, with dates\n    and accession numbers. Does not include guidance extraction - use\n    get_guidance for that.\n    ","annotations":null,"source":"probe","observed_at":"2026-10-19T17:10:30.636Z"},{"name":"get_guidance","title":null,"description":"Get forward-looking guidance language extracted from a company's\n    SEC filings, by ticker symbol.\n\n    Use this when asked what a company said about future performance,\n    revenue outlook, margin expectations, or other forward-looking\n    statements. Note: results are keyword-matched sentences from filings\n    and may include both forward guidance and recent reported results -\n    read each sentence carefully to distinguish actual forward guidance\n    from historical figures.\n    ","annotations":null,"source":"probe","observed_at":"2026-10-19T17:10:30.636Z"},{"name":"get_sector_filings","title":null,"description":"Get recent SEC filings for all companies in a given sector.\n\n    Sector names are case-insensitive, e.g. \"Technology\", \"Energy\",\n    \"Healthcare\". Use list_sectors first if unsure of exact names.\n    Optionally filter by event_type (earnings_release, acquisition,\n    executive_change, restructuring, dividend, guidance_update).\n    ","annotations":null,"source":"probe","observed_at":"2026-10-19T17:10:30.636Z"},{"name":"get_signals","title":null,"description":"Get real-time AI sentiment signals derived from SEC 8-K filings.\n\n    Each signal includes: ticker, bullish/bearish/neutral classification,\n    confidence score (-100 to 100), a one-line summary, and key factors.\n    Signals are generated by Claude Haiku within minutes of EDGAR publication.\n\n    Use this when asked which companies have recently filed bullish or\n    bearish 8-Ks, or to screen for sentiment shifts across the S&P 500.\n    Default window is 30 days; set hours=24 for today only.\n    ","annotations":null,"source":"probe","observed_at":"2026-10-19T17:10:30.636Z"},{"name":"get_transcript","title":null,"description":"Get all available earnings call transcripts for a company by ticker.\n\n    Returns a list of transcripts (each with fiscal_quarter, fiscal_year,\n    date, and speakers). If asked about a specific quarter, look for it\n    within the returned list rather than expecting a single result -\n    this endpoint does not currently filter server-side.\n\n    Use this when asked what was said on an earnings call, as opposed to\n    in written SEC filings.\n    ","annotations":null,"source":"probe","observed_at":"2026-10-19T17:10:30.636Z"},{"name":"list_sectors","title":null,"description":"List all available sectors with the number of tickers in each.\n\n    Use this when asked about sectors, industries, or to find which\n    sector a type of company falls under. Returns 11 GICS sectors\n    covering the S&P 500.\n    ","annotations":null,"source":"probe","observed_at":"2026-10-19T17:10:30.636Z"},{"name":"search_filings","title":null,"description":"Search across all SEC filings in the database by keyword, optionally\n    filtered by ticker and date range (YYYY-MM-DD format).\n\n    Use this for open-ended questions like \"which companies mentioned\n    supply chain issues\" rather than looking up one known ticker.\n    ","annotations":null,"source":"probe","observed_at":"2026-10-19T17:10:30.636Z"}],"dev.protogrid/trust":{"score":70,"components":{"hygiene":80,"liveness":100,"freshness":65,"provenance":35},"drivers":["+reachable","+uptime-100%","~updated-103d-ago","-no-repository"],"flags":["no-repository"],"blocked":false,"computed_at":"2026-10-19T20:34:48.945Z","disclaimer":"Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed."},"dev.protogrid/quality":{"score":79,"label":"good","components":{"auth":null,"hygiene":71,"protocol":75,"stability":100,"dependencies":null},"checks":[{"id":"protocol.modern","detail":"newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28","status":"warn","category":"protocol"},{"id":"protocol.stateless","detail":"only applies to 2026-07-28 servers","status":"na","category":"protocol"},{"id":"protocol.transport","detail":"streamable HTTP","status":"pass","category":"protocol"},{"id":"protocol.list_ttl","detail":"only applies to 2026-07-28 servers","status":"na","category":"protocol"},{"id":"auth.prm","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.as_metadata","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.cimd","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.secret_in_url","detail":"no templated URL","status":"na","category":"auth"},{"id":"tools.descriptions","detail":"every tool has a description","status":"pass","category":"hygiene"},{"id":"tools.description_length","detail":"descriptions are concise","status":"pass","category":"hygiene"},{"id":"tools.schemas","detail":"every tool has an object input schema","status":"pass","category":"hygiene"},{"id":"tools.annotations","detail":"no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones","status":"fail","category":"hygiene"},{"id":"tools.directory_hints","detail":"no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_earnings_calendar (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_filings (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_filing_detail (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …","status":"fail","category":"hygiene"},{"id":"tools.token_cost","detail":"about 1,362 tokens to load every tool","status":"pass","category":"hygiene"},{"id":"tools.api_dump","detail":"tools are not a one-to-one API dump","status":"pass","category":"hygiene"},{"id":"stability.changes","detail":"no tool changes in 30 days","status":"pass","category":"stability"},{"id":"stability.rug_pull","detail":"no tool changed its meaning under the same name","status":"pass","category":"stability"},{"id":"deps.known_vulns","detail":"no npm or PyPI package","status":"na","category":"dependencies"},{"id":"deps.mcp_sdk_version","detail":"no npm or PyPI package","status":"na","category":"dependencies"},{"id":"deps.resolvable","detail":"no npm or PyPI package","status":"na","category":"dependencies"}],"drivers":["-tools.annotations","-tools.directory_hints","~protocol.modern"],"flags":[],"tool_count":10,"token_estimate":1362,"tools_hash":"c2a8786b0c156749028688c6836c175c","tools_changed_at":null,"computed_at":"2026-10-19T20:38:04.291Z","disclaimer":"Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed."},"dev.protogrid/identity":{"canonical_id":"io.github.jethrokirk-sudo/filingapi","aliases":[],"alias_count":0,"repository_key":null,"owner":{"verified":false,"method":null,"since":null}}},"next_actions":[{"action":"list_tools","description":"Every current tool with input schemas","href":"/v1/servers/io.github.jethrokirk-sudo%2Ffilingapi/tools","arguments":{"name":"io.github.jethrokirk-sudo/filingapi"}},{"action":"get_connection","description":"Minimal connection block for the preferred remote or package","href":"/v1/servers/io.github.jethrokirk-sudo%2Ffilingapi/connection?target=mcpServers","arguments":{"name":"io.github.jethrokirk-sudo/filingapi","target":"mcpServers"}},{"action":"search","description":"Find other servers by intent","href":"/v1/search?q={query}","arguments":{"q":"{query}"}}]}