henrysouchien avatar

EdgarParser MCP

henrysouchien/edgar-mcp

Connects Claude to the EdgarParser API for source-backed SEC EDGAR financial data. You get 29 tools spanning XBRL financial statements, filing metadata, full document access with markdown conversion, table extraction and comparison across tickers, operational KPI discovery, and citation-ready evidence retrieval. The server itself is a thin stdio client that forwards requests to the hosted API, so you'll need an EDGAR_API_KEY. Useful when you're building financial analysis workflows that need structured GAAP concepts, time series comparisons, or grounded answers with section-level citations from 10-Ks and 10-Qs. Some tools like metric warming and extraction search require paid tier access.

tools
32
auth
Secret needed
transport
STDIO
env vars
3
last updated
Aug 20, 2026

Tools

32 tools

Public tool metadata for what this MCP can expose to an agent.

get_filingsReturn filing metadata and SEC accession details for one ticker period.

Return filing metadata and SEC accession details for one ticker period.

No parameter schema in public metadata yet.

get_event_filingsDiscover event filings by ticker, CIK, date range, form type, or query.

Discover event filings by ticker, CIK, date range, form type, or query.

No parameter schema in public metadata yet.

describe_filingShow cached availability for financials, sections, tables, markdown, and extractions for one filing.

Show cached availability for financials, sections, tables, markdown, and extractions for one filing.

No parameter schema in public metadata yet.

get_filing_documentReturn a readable markdown filing document with section filtering and pagination.

Return a readable markdown filing document with section filtering and pagination.

No parameter schema in public metadata yet.

get_filing_sectionsExtract selected qualitative filing sections and optional embedded tables.

Extract selected qualitative filing sections and optional embedded tables.

No parameter schema in public metadata yet.

get_filing_cover_factsReturn exact DEI cover-page facts such as shares outstanding with citations.

Return exact DEI cover-page facts such as shares outstanding with citations.

No parameter schema in public metadata yet.

get_filing_evidencePlan and retrieve citation-ready filing evidence for qualitative SEC questions.

Plan and retrieve citation-ready filing evidence for qualitative SEC questions.

No parameter schema in public metadata yet.

get_issuer_submissions_metaReturn an issuer's SEC submissions header metadata directly from the public SEC JSON endpoint.

Return an issuer's SEC submissions header metadata directly from the public SEC JSON endpoint.

No parameter schema in public metadata yet.

get_operational_kpi_driversResearch filing narrative and markdown tables for operational KPI values and driver context.

Research filing narrative and markdown tables for operational KPI values and driver context.

No parameter schema in public metadata yet.

get_operational_kpi_driver_rowsReturn the strict producer-owned operational KPI driver row DTO without transport reinterpretation.

Return the strict producer-owned operational KPI driver row DTO without transport reinterpretation.

No parameter schema in public metadata yet.

get_filing_extractionsReturn cached langextract spans for one filing or run paid extraction on cache miss.

Return cached langextract spans for one filing or run paid extraction on cache miss.

No parameter schema in public metadata yet.

search_extractionsSearch cached langextract spans across filings with structured filters.

Search cached langextract spans across filings with structured filters.

No parameter schema in public metadata yet.

get_extraction_seriesReturn periodized counts and optional hits for cached langextract spans.

Return periodized counts and optional hits for cached langextract spans.

No parameter schema in public metadata yet.

extract_filing_fileRun a selected extraction schema against a short-lived filing artifact issued by get_filing_sections.

Run a selected extraction schema against a short-lived filing artifact issued by get_filing_sections.

No parameter schema in public metadata yet.

list_extraction_schemasList document extraction schemas available to the internal document API.

List document extraction schemas available to the internal document API.

No parameter schema in public metadata yet.

get_filing_tablesReturn filing table metadata or one hydrated structured table.

Return filing table metadata or one hydrated structured table.

No parameter schema in public metadata yet.

search_filing_tablesSearch cached filing table metadata across a ticker and period range.

Search cached filing table metadata across a ticker and period range.

No parameter schema in public metadata yet.

compare_filing_tablesCompare matching filing tables across multiple tickers.

Compare matching filing tables across multiple tickers.

No parameter schema in public metadata yet.

search_filing_textSearch cached markdown within one filing and return matching spans.

Search cached markdown within one filing and return matching spans.

No parameter schema in public metadata yet.

get_financialsReturn matcher-produced numeric financial rows for one fiscal filing period.

Return matcher-produced numeric financial rows for one fiscal filing period.

No parameter schema in public metadata yet.

get_filing_factsRetrieve exact-QName facts or whole statement and disclosure presentation occurrences from one exact SEC filing accession.

Retrieve exact-QName facts or whole statement and disclosure presentation occurrences from one exact SEC filing accession.

No parameter schema in public metadata yet.

get_metricReturn one discovered metric or XBRL tag with current, prior, and YoY values.

Return one discovered metric or XBRL tag with current, prior, and YoY values.

No parameter schema in public metadata yet.

get_metric_seriesReturn one metric across multiple periods with per-period cache and coverage status.

Return one metric across multiple periods with per-period cache and coverage status.

No parameter schema in public metadata yet.

list_metricsList exact metric candidates available in one filing period.

List exact metric candidates available in one filing period.

No parameter schema in public metadata yet.

search_metricsSearch filing metrics by natural-language query and return ranked exact candidates.

Search filing metrics by natural-language query and return ranked exact candidates.

No parameter schema in public metadata yet.

get_statementReturn a template-backed income statement, balance sheet, or cash flow statement from cached concepts.

Return a template-backed income statement, balance sheet, or cash flow statement from cached concepts.

No parameter schema in public metadata yet.

get_conceptResolve one registry-backed financial concept from cached filing facts.

Resolve one registry-backed financial concept from cached filing facts.

No parameter schema in public metadata yet.

compare_conceptCompare one registry-backed concept across a caller-provided ticker set.

Compare one registry-backed concept across a caller-provided ticker set.

No parameter schema in public metadata yet.

concept_trendReturn a cache-only concept time series across a requested period range.

Return a cache-only concept time series across a requested period range.

No parameter schema in public metadata yet.

cite_conceptJoin a registry-backed concept value to filing prose and optional extraction evidence.

Join a registry-backed concept value to filing prose and optional extraction evidence.

No parameter schema in public metadata yet.

warm_metric_cacheQueue paid-tier background warming for metric periods before follow-up reads.

Queue paid-tier background warming for metric periods before follow-up reads.

No parameter schema in public metadata yet.

warm_metric_cache_statusPoll a background cache-warming job returned by warm_metric_cache.

Poll a background cache-warming job returned by warm_metric_cache.

No parameter schema in public metadata yet.

Sponsors

Configuration

EDGAR_API_KEY*secret

API key for the hosted EdgarParser API.

EDGAR_API_URL

Optional API base URL override. Defaults to https://www.edgarparser.com.

EDGAR_MCP_OUTPUT_DIR

Optional directory for output="file" responses.

Readme

edgar-mcp

SEC EDGAR financial data for AI agents, exposed as an MCP stdio server.

Install

pip install edgar-mcp

Configuration

VariableRequiredPurpose
EDGAR_API_KEYhosted toolsAPI key for the hosted EDGAR API; not used by get_issuer_submissions_meta.
EDGAR_API_URLnoOverride the API base URL. Defaults to https://www.edgarparser.com.
EDGAR_MCP_OUTPUT_DIRnoDirectory for output="file" tool responses.

Claude Desktop / Claude Code config:

{
  "mcpServers": {
    "edgar-financials": {
      "type": "stdio",
      "command": "edgar-mcp",
      "env": {
        "EDGAR_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

Tool Inventory

This package exposes 32 public MCP tools. The inventory below is generated from the same manifest that drives the hosted API documentation.


View the full README on GitHub

Details

Repository
github.com/henrysouchien/edgar-mcp
Category
Data & Analytics
Package
edgar-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Data & Analytics MCP servers

View all
1herohunt-ai avatarHerohunt Mcpherohunt-ai/herohunt-mcpPeople search API - find 1 billion candidates across LinkedIn and GitHub with real-time data.0stars
2hug0x0 avatarMcp Reunionhug0x0/mcp-reunionMCP server for Réunion open data (data.regionreunion.com)0stars
3idnsidns avatarTenderAPI — French & EU public tendersidnsidns/tenderapi-mcpMCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.0stars
4bitquery avatarBitquery MCP Serverbitquery/mcpHosted on-chain data for AI agents: DEX trades, OHLCV, top traders, fund tracing, address labels.0stars
5exploratory-io avatarExploratory Serverexploratory-io/exploratorySearch and read notes, dashboards, charts, analytics and data published on Exploratory.0stars
6fhirfly-io avatarMcp Serverfhirfly-io/fhirfly-mcp-serverHealthcare reference data for AI agents: providers, drugs, diagnoses, labs, codes, claims.0stars