edgar-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EDGAR_API_KEY | Yes | API key for EDGAR Financial API | |
| EDGAR_API_URL | No | URL for the EDGAR API (optional) | https://www.financialmodelupdater.com |
| EDGAR_MCP_OUTPUT_DIR | No | Path for output="file" responses. Falls back to ~/.cache/edgar-mcp/file_output if default is unavailable. | ./exports/file_output |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_filingsC | Fetch SEC filing metadata for a company. Returns list of 10-Q, 10-K, and 8-K (earnings release) filings with URLs, dates, and fiscal period assignments. |
| get_financialsB | Extract all financial facts from SEC filings. Returns structured JSON with income statement, balance sheet, and cash flow data. |
| get_metricC | Get a specific financial metric by common name or XBRL tag and return current/prior values with YoY comparison. |
| list_metricsA | List available metric tags for a filing period so an agent can choose an exact metric_name before calling get_metric. |
| search_metricsC | Search available filing metrics by natural-language query and return ranked candidates. |
| get_filing_sectionsC | Parse qualitative sections from SEC 10-K or 10-Q filings and return narrative/tables with metadata. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose with no ambiguity: get_filings retrieves metadata, get_filing_sections parses qualitative content, get_financials extracts structured financial data, get_metric fetches specific metrics, list_metrics enumerates available metrics, and search_metrics enables natural-language discovery. The boundaries are well-defined and complementary.
All tool names follow a consistent verb_noun pattern with snake_case throughout (e.g., get_filings, get_filing_sections, get_financials, get_metric, list_metrics, search_metrics). The naming is predictable and enhances readability across the set.
With 6 tools, the count is well-scoped for the SEC filing analysis domain. Each tool earns its place by covering distinct aspects like metadata retrieval, content parsing, data extraction, and metric access, without being overly sparse or bloated.
The tool set provides comprehensive coverage for analyzing SEC filings, including metadata, qualitative sections, financial data, and metrics. A minor gap exists in lacking explicit update or delete operations, but this is reasonable for a read-only data retrieval server focused on financial analysis workflows.