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.