Filingapi

io.github.jethrokirk-sudoPublished by GitHub account jethrokirk-sudov1.0.0Updated Oct 25, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server that lets an assistant look up SEC filings, earnings transcripts, guidance language, earnings dates and AI sentiment signals for S&P 500 and G

What you can do
Retrieve SEC filings for a ticker, with dates and accession numbers, and open a single filing in full by accession number. Search across all filings by keyword, optionally filtered by ticker and date range. Pull forward-looking guidance language and earnings call transcripts for a company. Check upcoming earnings dates with EPS and revenue estimates. Browse GICS sectors, list recent filings for a whole sector filtered by event type, and get a company's sector, industry and data coverage. Read AI-generated bullish, bearish or neutral sentiment signals derived from 8-K filings.
When to use it
Useful for equity research and financial questions about US-listed companies: what a company filed, what it said about future performance, when it reports earnings, which companies mentioned a topic, or how recent 8-Ks were scored for sentiment.
Requirements
A remote streamable HTTP endpoint; no package, environment variable or header is declared. No authentication is declared, so no account or API key appears to be needed. Network access to the endpoint is required.
Before you install
Sentiment signals are AI-generated from 8-K filings and should be treated as unverified interpretation, not advice. Guidance results are described as keyword-matched sentences from filings, so they can be incomplete or out of context. Coverage is limited to the S&P 500 and the data the service has indexed; verify figures against the original filings before relying on them.

Installation

In SourceWeft

  1. Open Filingapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.jethrokirk-sudo%2Ffilingapi/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "filingapi": {
      "type": "http",
      "url": "https://mcp.filingapi.dev/mcp"
    }
  }
}

Tools

10

get_filings

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.

Parameterstickerrequiredfiling_type

get_guidance

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.

Parameterstickerrequired

get_filing_detail

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.

Parameterstickerrequiredaccession_numberrequired

search_filings

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.

Parametersqueryrequiredtickerdate_todate_from

get_transcript

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.

Parameterstickerrequired

get_earnings_calendar

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.

Parameterstickerdate_todate_from

list_sectors

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.

Takes no parameters.

get_sector_filings

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).

Parameterssectorrequiredevent_type

get_company_info

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.

Parameterstickerrequired

get_signals

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.

Parametershourslimit

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.