Skip to main content
Glama
titusblair

edgar-mcp

by titusblair

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
EDGAR_MCP_CACHENoOptional. Set to move the cache directory from the default ~/.cache/edgar-mcp.
EDGAR_MCP_USER_AGENTYesThe SEC requires a User-Agent with real contact details. Example: 'Your Name you@example.com'.

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
find_companyA

Resolve a company name or stock ticker to its SEC CIK number, which every other tool needs. Use this when a name is ambiguous or you want to confirm which entity you are about to read. Only companies that file with the SEC are here: no private companies, and most foreign issuers only if they file a 20-F. Returns ranked candidates with a confidence score.

list_filingsA

List what a company has filed with the SEC, newest first. Filter by form type: 10-K is the annual report, 10-Q quarterly, 8-K a material event, DEF 14A the proxy statement (executive pay and board), S-1 an IPO registration, 20-F a foreign issuer's annual report, 4 an insider trade. The form filter matches on prefix, so '10-K' also returns 10-K/A amendments. Returns accession numbers, which read_filing_section needs.

list_filing_sectionsA

Show which numbered items a filing actually contains, and how many tokens each one would cost to read. Call this before read_filing_section when you are not sure a section exists or want to budget the read. Many companies incorporate Part III by reference to their proxy, so Items 10-14 are often a single sentence pointing elsewhere.

read_filing_sectionA

Read ONE section of a filing rather than the whole document. This is the main tool: a 10-K is typically 50,000+ tokens and you almost never need all of it.

Sections: business (Item 1, what the company does), risk_factors (1A, what management says could go wrong — the most quoted section), properties (2), legal_proceedings (3), market_for_stock (5), mdna (7, management's own explanation of the results — read this before the financial statements), market_risk (7A), financial_statements (8), controls (9A), directors (10), executive_comp (11).

Output is capped at max_tokens. If the section is longer you get an offset to continue from; the response always says how much was cut.

get_financial_factsA

Look up a reported financial figure across recent periods, from structured XBRL data. Use this for any number — it is far more reliable than reading figures out of filing prose.

Concepts: revenue, net_income, operating_income, gross_profit, total_assets, total_liabilities, stockholders_equity, cash, eps_basic, eps_diluted, rnd_expense, shares_outstanding, long_term_debt, operating_cash_flow.

Each maps to one or more US-GAAP tags and the response names the tag that answered, because the exact definition matters. Annual figures by default; set annual=false for every period as reported, including quarters.

search_filingsA

Search the full text of all EDGAR filings from 2001 onward. Use this to find WHO discusses something — 'which companies mention quantum computing risk' — rather than to read a company you have already identified.

A multi-word query is matched as an exact phrase. Results are filings, not passages, so follow up with read_filing_section to read one. Narrow with forms (e.g. '10-K') and a date range when a query is common.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.3/5.0

Scored across 6 tools

Disambiguation5/5

Each tool serves a clearly distinct purpose: company resolution (find_company), filing listing (list_filings), section listing (list_filing_sections), section reading (read_filing_section), structured financial data (get_financial_facts), and full-text search (search_filings). There is no overlap; even list_filings and search_filings address different discovery needs (known company vs. unknown company).

Naming Consistency5/5

All tool names follow a consistent verb_noun snake_case pattern (find_company, list_filings, list_filing_sections, read_filing_section, get_financial_facts, search_filings). The pattern is uniform and clearly reflects the action each tool performs.

Tool Count5/5

Six tools is well-scoped for an EDGAR MCP server. Each tool covers a distinct part of the workflow (entity resolution, filing discovery, structure inspection, content reading, structured data extraction, and cross-company search) without redundancy or unnecessary bulk.

Completeness5/5

The tool surface covers the core EDGAR workflows end-to-end: finding a company, listing its filings, inspecting filing structure, reading specific sections, extracting structured financial facts, and searching across all filings. There are no obvious dead ends; the chain from find_company → list_filings → list_filing_sections → read_filing_section is complete, and get_financial_facts provides a reliable alternative for numerical data.

Maintenance

ActivityMaintained
ResponsivenessNo issues