
EdgarParser 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 toolsPublic 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*secretAPI key for the hosted EdgarParser API.
EDGAR_API_URLOptional API base URL override. Defaults to https://www.edgarparser.com.
EDGAR_MCP_OUTPUT_DIROptional 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
| Variable | Required | Purpose |
|---|---|---|
EDGAR_API_KEY | hosted tools | API key for the hosted EDGAR API; not used by get_issuer_submissions_meta. |
EDGAR_API_URL | no | Override the API base URL. Defaults to https://www.edgarparser.com. |
EDGAR_MCP_OUTPUT_DIR | no | Directory 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.
Details
- Repository
- github.com/henrysouchien/edgar-mcp
- Category
- Data & Analytics
- Package
edgar-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active