EdgarParser MCP

io.github.henrysouchienPublished by GitHub account henrysouchienv1.0.2Updated Oct 24, 2026

MCP stdio server for source-backed SEC EDGAR financial data from the hosted EdgarParser API.

The publisher's own server: edgar.tools SEC Intelligence

VerifiedSTDIODesktop onlyFinance Knowledge & Memory Data & Analytics

Server details

Identifier: io.github.henrysouchien/edgar-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account henrysouchien for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.henrysouchien%2Fedgar-mcp.svg)](https://sourceweft.com/mcp/io.github.henrysouchien%2Fedgar-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Gives an assistant access to SEC EDGAR filing metadata, documents, tables, and XBRL financial metrics through a hosted API.

What you can do: A local stdio server that acts as a thin client for the hosted EdgarParser API and the public SEC submissions endpoint; it does not parse filings locally. It exposes 32 tools covering filing metadata and documents, filing tables and text search, operational KPI drivers, LangExtract extraction spans, and XBRL concepts, metrics, and statements, including comparison and trend tools. Large responses can be written to files.
When to use it: Use it when an assistant needs source-backed SEC EDGAR data: filing discovery, reading filing sections or documents, comparing tables or concepts across tickers, or retrieving financial metrics and statements with citations. It is not useful for non-SEC data or for offline parsing of filings you already have.
Requirements: Runs as a local process installed from PyPI (pip install edgar-mcp) and needs Python. A hosted API key is required in EDGAR_API_KEY for hosted tools; get_issuer_submissions_meta works without it. Optional EDGAR_API_URL overrides the API base URL (default and optional EDGAR_MCP_OUTPUT_DIR sets where output="file" responses are written. Network access to the hosted API and the public SEC endpoint is required.

Before you install

The server sends requests to a third-party hosted service and requires the EDGAR_API_KEY secret; missing or invalid keys cause hosted tool calls to fail with authentication errors. Some tools are paid tier and consume hosted-service credits, and rate limits and paid access are enforced by that service. Tools with output="file" write files to EDGAR_MCP_OUTPUT_DIR or a local fallback directory, so choose that directory deliberately.

Installation

In SourceWeft

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

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

edgar-mcp

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

Install

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:

json

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

{  "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.

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 matcher-produced numeric financial rows for one fiscal filing period.	`public`	`cache_only`
`get_filing_facts`	Retrieve exact-QName facts or whole statement and disclosure presentation occurrences from one exact SEC filing accession.	`registered`	`cold_allowed`
`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_filing_facts, 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.

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.0.2LatestSep 16, 2026

Score

40% 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 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.

Other Edgar integrations

edgar.tools SEC Intelligence

tools.edgarOfficial publisher

Remote MCP server giving assistants 23 tools and 5 recipes for SEC filings, financials, insider trades, 13F holdings and funds.

Streamable HTTPWeb executableAuth

FinanceCredential requiredOct 24, 2026

SEC EDGAR Filings

Published by GitHub account SudiptoHaldar

Read-only SEC EDGAR filing metadata by stock ticker: latest filing, calendar-year filing history, and form-type codes, with official sec.gov links.

STDIODesktop only

Finance3 toolsNov 5, 2026

SEC EDGAR — Recent Company Filing Index by CIK

Published by GitHub account kriton-dev

SEC EDGAR — Recent Company Filing Index by CIK's hosted MCP server; credential required; Streamable HTTP.