EdgarParser MCP

io.github.henrysouchien由 GitHub 账号 henrysouchien 发布v1.0.2更新于 Oct 24, 2026

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

发布方自己的服务：edgar.tools SEC Intelligence

已验证STDIO仅桌面金融知识与记忆数据与分析

服务详情

标识符: io.github.henrysouchien/edgar-mcp
传输: STDIO
运行时: Desktop only
信任: Verified
发布于: Sep 16, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 henrysouchien。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![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)

概览

AI 生成的概览

让助手通过托管 API 获取 SEC EDGAR 申报文件元数据、文档、表格和 XBRL 财务指标。

可以做什么: 这是一个本地 stdio 服务器，作为托管 EdgarParser API 和公开 SEC submissions 端点的轻量客户端，不在本地解析申报文件。它提供 32 个工具，涵盖申报文件元数据与文档、申报表格与文本搜索、运营 KPI 驱动因素、LangExtract 抽取片段，以及 XBRL 概念、指标和报表，并包含跨标的比较与趋势工具。较大的响应可写入文件。
适用场景: 当助手需要来源可追溯的 SEC EDGAR 数据时适用：发现申报文件、阅读申报章节或文档、跨股票代码比较表格或概念，或获取带引用的财务指标与报表。它不适用于非 SEC 数据，也不适用于离线解析本地已有的申报文件。
运行要求: 作为本地进程运行，从 PyPI 安装（pip install edgar-mcp），需要 Python。托管工具需要在 EDGAR_API_KEY 中提供托管 API 密钥；get_issuer_submissions_meta 无需密钥。可选 EDGAR_API_URL 覆盖 API 基础地址（默认 EDGAR_MCP_OUTPUT_DIR 指定 output="file" 响应的写入目录。需要访问托管 API 和公开 SEC 端点的网络连接。

安装前请注意

该服务器会向第三方托管服务发送请求，并需要 EDGAR_API_KEY 密钥；密钥缺失或无效会导致托管工具调用返回认证错误。部分工具属于付费层级，会消耗托管服务额度，速率限制和付费访问由该服务执行。使用 output="file" 的工具会向 EDGAR_MCP_OUTPUT_DIR 或本地回退目录写入文件，请谨慎选择该目录。

安装

在 SourceWeft 中

打开控制台中的 EdgarParser MCP，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

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.