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 31 public MCP tools. The inventory below is generated from the same manifest that drives the hosted API documentation.

Tool Summary Tier Cache Behavior
get_filings Return filing metadata and SEC accession details for one ticker period. public cache_only
get_event_filings Discover event filings by ticker, CIK, date range, form type, or query. public cold_allowed
describe_filing Show cached availability for financials, sections, tables, markdown, and extractions for one filing. public cache_only
get_filing_document Return a readable markdown filing document with section filtering and pagination. registered cold_allowed
get_filing_sections Extract selected qualitative filing sections and optional embedded tables. public cold_allowed
get_filing_cover_facts Return exact DEI cover-page facts such as shares outstanding with citations. registered cold_allowed
get_filing_evidence Plan and retrieve citation-ready filing evidence for qualitative SEC questions. paid llm_call
get_issuer_submissions_meta Return an issuer's SEC submissions header metadata directly from the public SEC JSON endpoint. public cold_allowed
get_operational_kpi_drivers Research filing narrative and markdown tables for operational KPI values and driver context. paid llm_call
get_operational_kpi_driver_rows Return the strict producer-owned operational KPI driver row DTO without transport reinterpretation. paid cold_allowed
get_filing_extractions Return cached langextract spans for one filing or run paid extraction on cache miss. paid llm_call
search_extractions Search cached langextract spans across filings with structured filters. paid cache_only
get_extraction_series Return periodized counts and optional hits for cached langextract spans. paid cache_only
extract_filing_file Run a selected extraction schema against a short-lived filing artifact issued by get_filing_sections. internal llm_call
list_extraction_schemas List document extraction schemas available to the internal document API. internal cache_only
get_filing_tables Return filing table metadata or one hydrated structured table. public cold_allowed
search_filing_tables Search cached filing table metadata across a ticker and period range. public cache_only
compare_filing_tables Compare matching filing tables across multiple tickers. public cache_only
search_filing_text Search cached markdown within one filing and return matching spans. registered cache_only
get_financials Return the full structured XBRL financial fact payload for one filing period. public cache_only
get_metric Return one discovered metric or XBRL tag with current, prior, and YoY values. public cache_only
get_metric_series Return one metric across multiple periods with per-period cache and coverage status. public cache_only
list_metrics List exact metric candidates available in one filing period. public cache_only
search_metrics Search filing metrics by natural-language query and return ranked exact candidates. public cold_allowed
get_statement Return a template-backed income statement, balance sheet, or cash flow statement from cached concepts. public cache_only
get_concept Resolve one registry-backed financial concept from cached filing facts. public cache_only
compare_concept Compare one registry-backed concept across a caller-provided ticker set. public cache_only
concept_trend Return a cache-only concept time series across a requested period range. public cache_only
cite_concept Join a registry-backed concept value to filing prose and optional extraction evidence. paid cache_only
warm_metric_cache Queue paid-tier background warming for metric periods before follow-up reads. paid cold_allowed
warm_metric_cache_status Poll a background cache-warming job returned by warm_metric_cache. paid cache_only

Tool Families

Filing Metadata and Documents

get_filings, get_event_filings, describe_filing, get_filing_document, get_filing_sections, get_filing_cover_facts, get_filing_evidence, get_issuer_submissions_meta

Operational KPIs

get_operational_kpi_drivers, get_operational_kpi_driver_rows

LangExtract

get_filing_extractions, search_extractions, get_extraction_series, extract_filing_file, list_extraction_schemas

Filing Tables

get_filing_tables, search_filing_tables, compare_filing_tables

Filing Text

search_filing_text

XBRL and Concepts

get_financials, get_metric, get_metric_series, list_metrics, search_metrics, get_statement, get_concept, compare_concept, concept_trend, cite_concept, warm_metric_cache, warm_metric_cache_status

Runtime Notes

  • This is a thin client for the hosted EDGAR API and the public SEC submissions endpoint; it does not parse filings locally.
  • Missing or invalid EDGAR_API_KEY lets the server start, but hosted API tool calls return authentication errors; get_issuer_submissions_meta does not require the key.
  • Large payload tools support output="file" and write to EDGAR_MCP_OUTPUT_DIR or a local fallback directory.
  • API rate limits and paid-tool access are enforced by the hosted service.

Links

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for henrychien from gravatar.com henrychien

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

edgar_mcp-1.0.2.tar.gz (54.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

edgar_mcp-1.0.2-py3-none-any.whl (55.7 kB view details)

Uploaded Python 3

File details

Details for the file edgar_mcp-1.0.2.tar.gz.

File metadata

  • Download URL: edgar_mcp-1.0.2.tar.gz
  • Upload date:
  • Size: 54.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.2

File hashes

Hashes for edgar_mcp-1.0.2.tar.gz
Algorithm Hash digest
SHA256 66b7379060cb76ed34752231f8428d47906336d914bf17c106120f8a5d098ccf
MD5 3731f8179cee722a099e487191970b40
BLAKE2b-256 66f31716a76b4f48a551af38830b3e63409cc07135875140484ed2c560b63be8

See more details on using hashes here.

File details

Details for the file edgar_mcp-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: edgar_mcp-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 55.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.2

File hashes

Hashes for edgar_mcp-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 df963ef7d0593e74fef45794b6240726f5ab0850015662e4f47da5feed70d1ef
MD5 04ab35169306d7ac5adeefa401ae853f
BLAKE2b-256 cd3ad0cadafbb388651baeeeacdd8c0b8100343d669d0925f935abbb85ec509e

See more details on using hashes here.

Release history Release notifications | RSS feed

1.0.3

2 files

This release

1.0.2 This release

2 files

1.0.1

2 files

1.0.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.1

2 files

0.2.0

2 files

0.1.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page