EdgarParser MCP server
io.github.henrysouchien/edgar-mcp·v1.0.2MCP stdio server for source-backed SEC EDGAR financial data from the hosted EdgarParser API.
0 stars38 downloads/wk
Reviews
Write oneNobody has reviewed EdgarParser MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
EdgarParser MCP tools (31)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
cite_conceptCite a registry-backed concept by returning the canonical concept value and the filing prose around that value from MD&A, notes, risk factors, and optional cached extraction spans.
compare_conceptCompare one registry-backed concept across a caller-provided list of filers. This is cross-filer comparison, not search: caller ticker order is preserved, and partial coverage is returned per row with available=false.
compare_filing_tablesCompare structured filing tables across caller-provided tickers in one response. Preserves ticker order and returns per-ticker availability, matching table metadata, and optionally hydrated table rows.
concept_trendReturn a cache-only time series for a registry-backed concept over a period range. v1 uses the latest filing's reported series and has no restatement awareness: it does not return restated or original_value fields.
describe_filingShow cached data availability for one filing across XBRL, sections, tables, extraction schemas, and markdown. Read-only; does not populate caches.
extract_filing_fileResolve a short-lived artifact handle issued by get_filing_sections and run scratch extraction for the requested schema via /api/documents/scratch-extract, without creating a canonical filing identity.
get_conceptGet a registry-backed financial concept value from cached XBRL financials. v1 resolves tag-backed concepts only and returns available=false for derivation or unsupported concepts. It never warms caches; call get_financials first when cache_status is cold.
get_event_filingsDiscover SEC event filings by ticker/CIK, filing-date range, and form type. Use this for deal, financing, proxy, filed-communication, and status-update materials that are not tied to a fiscal quarter's 10-K/10-Q. Do not pass 10-K or 10-Q here; use get_filings for periodic filing discovery, or get_filing_document/get_filing_sections when periodic filing content is needed. Event-form examples includ
get_extraction_seriesPeriodized counts (and optional hits) for langextract spans across a YYYY-Qn/YYYY-FY period range. ISO dates are not accepted. Cache read only. For raw cross-filing hits, use search_extractions.
get_filing_cover_factsGet exact cover-page DEI facts from a 10-K/10-Q, including citation-ready source metadata. Use this for outstanding-share questions instead of balance-sheet common-stock rows or weighted-average share metrics. Related tools: get_filing_document for markdown, get_filing_evidence for qualitative evidence, and get_filing_extractions for cached structured spans.
get_filing_documentGet a SEC filing as readable markdown. Returns sectioned markdown with ## SECTION: headers. Supports section filtering and pagination via char range or max_chars cap. Pass accession plus cik/form_type/primary_document from get_event_filings to read an exact event filing without falling back to the latest filing for a fiscal quarter. Period-keyed reads are cache backed; exact-accession reads are fe
get_filing_evidencePlan and retrieve filing evidence in one call for a qualitative SEC filing question. The source planner is internal; inspect its output by setting include_planner_trace=true, or by reading the X-Edgar-Planner-Trace response header when using the HTTP route directly. For metric-anchored joins from a concept value to supporting prose, use cite_concept instead once that Phase 6 tool is shipped. Suppo
get_filing_extractionsReturn cached langextract spans for one filing, or fetch the filing and run extraction on cache miss. Use this for ticker/year/quarter-keyed filings. Related tools: get_filing_document reads markdown, get_filing_evidence plans qualitative evidence, and get_filing_cover_facts returns DEI facts.
get_filing_sectionsParse qualitative sections from one filing resolved by ticker/year/quarter. Required call shape: `get_filing_sections(ticker="MSCI", year=2025, quarter=4, sections=["item_1", "item_7"])`.
get_filing_tablesFetch structured filing tables. Listing modes return metadata only; supplying table_id returns a single table with full row data. Pass accession to require the returned table cache to match a specific resolved filing identity. Omit source or use source='auto' for ordinary 10-K/10-Q tables. Use source='proxy' for DEF 14A proxy tables; use source='20f' or source='6k' with accession to target a speci
get_filingsFetch SEC filing metadata for one fiscal period. Required call shape: `get_filings(ticker="MSCI", year=2025, quarter=4)`.
get_financialsExtract all financial facts from one fiscal filing. Required call shape: `get_financials(ticker="MSCI", year=2024, quarter=4, full_year_mode=True)`.
get_issuer_submissions_metaFetch an issuer's SEC submissions header by CIK.
get_metricGet a specific financial metric by common name or XBRL tag and return current/prior values with YoY comparison. For guessed or user-facing names, call search_metrics or list_metrics first and pass an exact discovered metric_name into this tool; do not retry near-miss names blindly. Optional role filters accept friendly statement roles such as ["cash_flow"] or ["balance_sheet"]. If the response say
get_metric_seriesFetch one metric across multiple periods in a single call, using cache-first execution and per-period status reporting. Optional role filters are applied per period before the best match is selected. Pass `axis_key` exactly as returned by search_metrics/list_metrics when the user needs a dimensional fact such as product revenue. For FCF, FCF margin, cash conversion, or trend questions, inspect per
get_operational_kpi_driver_rowsReturn the strict producer-owned operational-KPI driver row DTO from `/api/operational-kpis/drivers`. Use these versioned, calculation-ready rows for programmatic consumers and cross-transport interoperability.
get_operational_kpi_driversReturn structured operational KPI values and driver growth rates from a filing's MD&A/earnings discussion. Use this for non-XBRL operating metrics such as Gross Bookings, MAPCs, Trips, customer counts, revenue driver bridges, take-rate inputs, segment growth rates, constant-currency growth, and volume-vs-price decomposition. It discovers candidate labels from the filing document and returns citati
get_statementReturn a bulk structured statement (income statement, balance sheet, or cash flow statement) from a deterministic v1 statement template and the v1 concept registry. Supports single-period mode with year+quarter and range mode with period_from+period_to; the two modes are mutually exclusive. v1 templates contain tag-kind concepts only, so computed or derivation rows such as margins and ratios belon
list_extraction_schemasList the document extraction schemas available through the EDGAR API.
list_metricsList available metric tags for a filing period so an agent can choose an exact metric_name before calling get_metric. Cash-flow candidates may carry `scope_warning` and `scope_bridge_ids`; validate those before using CFO in margin or trend formulas. Debt candidates may carry `debt_component_kind` values such as `instrument_principal`, `coupon_rate`, `finance_lease`, `other_notes`, or `total_debt_r
search_extractionsSearch cached langextract spans across filings using structured filters. Periods must use YYYY-Qn or YYYY-FY, not ISO dates. Read-only; cache misses are reported and never trigger LLM extraction.
search_filing_tablesCross-filing search over an Edgar table index for a ticker. Matches on table description, table_type, and section. Returns metadata only; use get_filing_tables with the table_id to fetch full table contents. Use search_filing_text for same-filing prose search.
search_filing_textSearch cached markdown within one SEC filing keyed by ticker, year, quarter, and source. Read-only: cold caches return cache_status='cold' and are not warmed. CC5 prefix exception: although search_* usually denotes cross-filing search, search_filing_text is intentionally same-filing only and requires the per-filing ticker/year/quarter inputs. Use search_filing_tables for cross-filing table metadat
search_metricsSearch available filing metrics by natural-language query and return ranked candidates. Optional role filters accept friendly statement roles such as ["cash_flow"], ["balance_sheet"], or ["income_statement"]. Cash-flow matches may carry mixed-scope warnings and bridge IDs; inspect the returned top-level `scope_bridges` before using CFO in FCF-style formulas. Debt refinance/tranche queries surface
warm_metric_cacheEnqueue async cache warming for metric periods. Paid/internal API tiers only. Each item requires ticker, year, quarter, and optional full_year_mode. Returns a job_id for warm_metric_cache_status polling.
warm_metric_cache_statusPoll an async metric cache warming job by job_id.
Public scan report
scanner v0.1.10 · 2026-11-02 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 46 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How EdgarParser MCP compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,255 servers
- Tools
- 31
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 38
- more than 29% of 12,191 servers with a package
What its tools let an agent do: 31 read
Install EdgarParser MCP in Claude Code, Cursor or VS Code
claude mcp add edgar-mcp -- uvx edgar-mcp
What the publisher says
From the EdgarParser MCP repository's README, as published. We do not edit it. Read it on GitHub
edgar-mcp
SEC EDGAR financial data for AI agents, exposed as an MCP stdio server.
<!-- Generated from docs/toolmanifest.yaml by scripts/rendermcp_readme.py. --> <!-- mcp-name: io.github.henrysouchien/edgar-mcp -->
Install
pip install edgar-mcpConfiguration
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.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
EdgarParser MCP: common questions
- Is EdgarParser MCP server safe?
- Mostly: it is graded B (78/100). Read the EdgarParser MCP safety report
- How do I install EdgarParser MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does EdgarParser MCP need an API key?
- Yes. The registry entry asks for
EDGAR_API_KEY. - Is EdgarParser MCP maintained?
- The last commit was 48 days ago (2026-09-16). The latest release is v1.0.2.
- What can I use instead of EdgarParser MCP?
- Servers from other publishers that do the same job: EdgarTools MCP server.
- How does EdgarParser MCP compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,255 servers); tools 31 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to EdgarParser MCP
Same job from other publishers: the closest match first, then the best rated.
- EdgarToolsOpen-source SEC EDGAR toolkit — 13 tools, 7 prompts, every filing type. No API key required.not reviewedWidely usedA