{ "markdown": "# edgar-mcp\n\nSEC EDGAR financial data for AI agents, exposed as an MCP stdio server.\n\n\n\n\n## Install\n\n```bash\npip install edgar-mcp\n```\n\n## Configuration\n\n| Variable | Required | Purpose |\n| --- | --- | --- |\n| `EDGAR_API_KEY` | hosted tools | API key for the hosted EDGAR API; not used by `get_issuer_submissions_meta`. |\n| `EDGAR_API_URL` | no | Override the API base URL. Defaults to `https://www.edgarparser.com`. |\n| `EDGAR_MCP_OUTPUT_DIR` | no | Directory for `output=\"file\"` tool responses. |\n\nClaude Desktop / Claude Code config:\n\n```json\n{\n \"mcpServers\": {\n \"edgar-financials\": {\n \"type\": \"stdio\",\n \"command\": \"edgar-mcp\",\n \"env\": {\n \"EDGAR_API_KEY\": \"YOUR_KEY_HERE\"\n }\n }\n }\n}\n```\n\n## Tool Inventory\n\nThis package exposes 32 public MCP tools. The inventory below is generated from the same manifest that drives the hosted API documentation.\n\n| Tool | Summary | Tier | Cache Behavior |\n| --- | --- | --- | --- |\n| `get_filings` | Return filing metadata and SEC accession details for one ticker period. | `public` | `cache_only` |\n| `get_event_filings` | Discover event filings by ticker, CIK, date range, form type, or query. | `public` | `cold_allowed` |\n| `describe_filing` | Show cached availability for financials, sections, tables, markdown, and extractions for one filing. | `public` | `cache_only` |\n| `get_filing_document` | Return a readable markdown filing document with section filtering and pagination. | `registered` | `cold_allowed` |\n| `get_filing_sections` | Extract selected qualitative filing sections and optional embedded tables. | `public` | `cold_allowed` |\n| `get_filing_cover_facts` | Return exact DEI cover-page facts such as shares outstanding with citations. | `registered` | `cold_allowed` |\n| `get_filing_evidence` | Plan and retrieve citation-ready filing evidence for qualitative SEC questions. | `paid` | `llm_call` |\n| `get_issuer_submissions_meta` | Return an issuer's SEC submissions header metadata directly from the public SEC JSON endpoint. | `public` | `cold_allowed` |\n| `get_operational_kpi_drivers` | Research filing narrative and markdown tables for operational KPI values and driver context. | `paid` | `llm_call` |\n| `get_operational_kpi_driver_rows` | Return the strict producer-owned operational KPI driver row DTO without transport reinterpretation. | `paid` | `cold_allowed` |\n| `get_filing_extractions` | Return cached langextract spans for one filing or run paid extraction on cache miss. | `paid` | `llm_call` |\n| `search_extractions` | Search cached langextract spans across filings with structured filters. | `paid` | `cache_only` |\n| `get_extraction_series` | Return periodized counts and optional hits for cached langextract spans. | `paid` | `cache_only` |\n| `extract_filing_file` | Run a selected extraction schema against a short-lived filing artifact issued by get_filing_sections. | `internal` | `llm_call` |\n| `list_extraction_schemas` | List document extraction schemas available to the internal document API. | `internal` | `cache_only` |\n| `get_filing_tables` | Return filing table metadata or one hydrated structured table. | `public` | `cold_allowed` |\n| `search_filing_tables` | Search cached filing table metadata across a ticker and period range. | `public` | `cache_only` |\n| `compare_filing_tables` | Compare matching filing tables across multiple tickers. | `public` | `cache_only` |\n| `search_filing_text` | Search cached markdown within one filing and return matching spans. | `registered` | `cache_only` |\n| `get_financials` | Return matcher-produced numeric financial rows for one fiscal filing period. | `public` | `cache_only` |\n| `get_filing_facts` | Retrieve known exact-QName XBRL facts from one exact SEC filing accession via cache-only lookup or allowed fetch; use metric tools for discovery. | `registered` | `cold_allowed` |\n| `get_metric` | Return one discovered metric or XBRL tag with current, prior, and YoY values. | `public` | `cache_only` |\n| `get_metric_series` | Return one metric across multiple periods with per-period cache and coverage status. | `public` | `cache_only` |\n| `list_metrics` | List exact metric candidates available in one filing period. | `public` | `cache_only` |\n| `search_metrics` | Search filing metrics by natural-language query and return ranked exact candidates. | `public` | `cold_allowed` |\n| `get_statement` | Return a template-backed income statement, balance sheet, or cash flow statement from cached concepts. | `public` | `cache_only` |\n| `get_concept` | Resolve one registry-backed financial concept from cached filing facts. | `public` | `cache_only` |\n| `compare_concept` | Compare one registry-backed concept across a caller-provided ticker set. | `public` | `cache_only` |\n| `concept_trend` | Return a cache-only concept time series across a requested period range. | `public` | `cache_only` |\n| `cite_concept` | Join a registry-backed concept value to filing prose and optional extraction evidence. | `paid` | `cache_only` |\n| `warm_metric_cache` | Queue paid-tier background warming for metric periods before follow-up reads. | `paid` | `cold_allowed` |\n| `warm_metric_cache_status` | Poll a background cache-warming job returned by warm_metric_cache. | `paid` | `cache_only` |\n\n## Tool Families\n\n### Filing Metadata and Documents\n\n`get_filings`, `get_event_filings`, `describe_filing`, `get_filing_document`, `get_filing_sections`, `get_filing_cover_facts`, `get_filing_evidence`, `get_issuer_submissions_meta`\n\n### Operational KPIs\n\n`get_operational_kpi_drivers`, `get_operational_kpi_driver_rows`\n\n### LangExtract\n\n`get_filing_extractions`, `search_extractions`, `get_extraction_series`, `extract_filing_file`, `list_extraction_schemas`\n\n### Filing Tables\n\n`get_filing_tables`, `search_filing_tables`, `compare_filing_tables`\n\n### Filing Text\n\n`search_filing_text`\n\n### XBRL and Concepts\n\n`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`\n\n## Runtime Notes\n\n- This is a thin client for the hosted EDGAR API and the public SEC submissions endpoint; it does not parse filings locally.\n- 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.\n- Large payload tools support `output=\"file\"` and write to `EDGAR_MCP_OUTPUT_DIR` or a local fallback directory.\n- API rate limits and paid-tool access are enforced by the hosted service.\n\n## Links\n\n- Hosted API: https://www.edgarparser.com\n- Documentation: https://docs.edgarparser.com\n- MCP setup: https://docs.edgarparser.com/mcp\n- Tool reference: https://docs.edgarparser.com/tools\n- Changelog RSS: https://docs.edgarparser.com/rss.xml\n- In-app developer page: https://www.edgarparser.com/developers\n- Open parser package: https://github.com/henrysouchien/edgar-parser\n- Source package: https://github.com/henrysouchien/edgar-mcp\n", "bytes": 7191, "sha": "14ffb01c2dc985e2262da36a77becd17a5496067c8afc5876f2a4817fa53d5f0", "repo_slug": "henrysouchien/edgar-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_henrysouchien_edgar_mcp_ecd32161/readme" }