Skip to content

io.github.jethrokirk-sudo/filingapi

by jethrokirk-sudo · remote · no sign-in to list tools · v1.0.0 · published by GitHub user jethrokirk-sudo

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

Read only
CompareRegistry entry

10 tools: 10 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http filingapi https://mcp.filingapi.dev/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

10 tools

Only reads 10Claude Code: allow
  • get_company_infoGet sector, industry, and data coverage info for a company.No findings

    Why it is in this group

    • The name "get_company_info" says "get": a word for reading.
    Description, as the server wrote it
    Get 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.No findings

    Why it is in this group

    • The name "get_earnings_calendar" says "get": a word for reading.
    Description, as the server wrote it
    Get 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.No findings

    Why it is in this group

    • The name "get_filing_detail" says "get": a word for reading.
    Description, as the server wrote it
    Get 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.No findings

    Why it is in this group

    • The name "get_filings" says "get": a word for reading.
    Description, as the server wrote it
    Get 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.No findings

    Why it is in this group

    • The name "get_guidance" says "get": a word for reading.
    Description, as the server wrote it
    Get 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.No findings

    Why it is in this group

    • The name "get_sector_filings" says "get": a word for reading.
    Description, as the server wrote it
    Get 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.No findings

    Why it is in this group

    • The name "get_signals" says "get": a word for reading.
    Description, as the server wrote it
    Get 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.No findings

    Why it is in this group

    • The name "get_transcript" says "get": a word for reading.
    Description, as the server wrote it
    Get 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.No findings

    Why it is in this group

    • The name "list_sectors" says "list": a word for reading.
    Description, as the server wrote it
    List 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).No findings

    Why it is in this group

    • The name "search_filings" says "search": a word for reading.
    Description, as the server wrote it
    Search 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.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http filingapi https://mcp.filingapi.dev/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__filingapi__get_filings",
      "mcp__filingapi__get_guidance",
      "mcp__filingapi__get_filing_detail",
      "mcp__filingapi__search_filings",
      "mcp__filingapi__get_transcript",
      "mcp__filingapi__get_earnings_calendar",
      "mcp__filingapi__list_sectors",
      "mcp__filingapi__get_sector_filings",
      "mcp__filingapi__get_company_info",
      "mcp__filingapi__get_signals"
    ],
    "ask": [],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as filingapi. Review it before you use it.