EdgarParser MCP

Registre officiel Autres

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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package edgar-mcp

Claude Code

claude mcp add edgarparser-mcp -e 'EDGAR_API_KEY=<your edgar_api_key>' -e 'EDGAR_API_URL=<EDGAR_API_URL>' -e 'EDGAR_MCP_OUTPUT_DIR=<EDGAR_MCP_OUTPUT_DIR>' -- uvx edgar-mcp==1.0.2

Configuration JSON (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "edgarparser-mcp": {
            "command": "uvx",
            "args": [
                "edgar-mcp==1.0.2"
            ],
            "env": {
                "EDGAR_API_KEY": "<your edgar_api_key>",
                "EDGAR_API_URL": "<EDGAR_API_URL>",
                "EDGAR_MCP_OUTPUT_DIR": "<EDGAR_MCP_OUTPUT_DIR>"
            }
        }
    }
}

Variables d'environnement

EDGAR_API_KEY obligatoire secret API key for the hosted EdgarParser API.
EDGAR_API_URL Optional API base URL override. Defaults to https://www.edgarparser.com.
EDGAR_MCP_OUTPUT_DIR Optional directory for output="file" responses.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire

edgar-mcp
Install
Configuration
Tool Inventory
Tool Families
Runtime Notes
Links

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

Questions fréquentes

Qu'est-ce que EdgarParser MCP ?

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

Comment installer EdgarParser MCP ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add edgarparser-mcp -e 'EDGAR_API_KEY=<your edgar_api_key>' -e 'EDGAR_API_URL=<EDGAR_API_URL>' -e 'EDGAR_MCP_OUTPUT_DIR=<EDGAR_MCP_OUTPUT_DIR>' -- uvx edgar-mcp==1.0.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour EdgarParser MCP ?

Oui. Il attend EDGAR_API_KEY, à renseigner dans sa configuration.

EdgarParser MCP est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient EdgarParser MCP ?

Il est publié par henrysouchien. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.

Détails du serveur

Référencé dans: Registre MCP officiel
Éditeur: henrysouchien
Catégorie: Autres
Exécution: Local
Étoiles GitHub: ★ 0
Langage: Python
Dernier commit: 16 sept. 2026
Tickets ouverts: 0
Version: 1.0.2
Publié le: 20 août 2026

io.github.henrysouchien/edgar-mcp

Serveurs similaires

KG-SSOT Verifiable knowledge graphs: validate and store .kg.yaml and .kg.json under the KG-SSOT...
Eclipse Muster MCP The Customer Graph core: one register of the people an account serves, with provenance ...
GhostPaw Grimoire Local procedural knowledge with spells, notes, and revision history.
Nevermined Catalog Discover and pay for services from the Nevermined Catalog using a spend-capped budget.
Eclipse Social Core MCP One canonical, hash-bound package behind every Eclipse social adapter. It publishes not...
Taminyaran Engineering MCP Engineering MCP for geosynthetics, waterproofing, drainage, ponds, foundations and tunn...
FluxProof Evidence-bearing public webpage monitoring with hashes, diffs, signed webhooks, REST, a...
GreenPick Greener, cheaper cloud infra decisions — carbon + cost + latency tradeoffs, in-editor.

Autres