edgar-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Network interface to bind when TRANSPORT=http. Defaults to 127.0.0.1. | 127.0.0.1 |
| PORT | No | Port to listen on when TRANSPORT=http. Defaults to 3000. | 3000 |
| TRANSPORT | No | Transport mode for the MCP server. Set to 'http' to expose the server over HTTP instead of stdio. | stdio |
| FRED_API_KEY | No | Optional API key for FRED. Allows full-text search across all FRED series. Without it, macro_search_series uses a limited catalog of ~50 key series. | |
| ALLOWED_HOSTS | No | Comma-separated list of accepted host names when TRANSPORT=http. Protects against DNS rebinding. | |
| MCP_AUTH_TOKEN | No | Bearer token required for each request when TRANSPORT=http. Recommended when not using localhost. | |
| SEC_USER_AGENT | Yes | Your name and email, required by the SEC to identify yourself when making requests. | |
| EDGAR_CACHE_MAX_MB | No | Maximum in-memory cache size in MB. Defaults to 100. | 100 |
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": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| edgar_search_companiesA | Find companies that file with the SEC (≈10,000 listed registrants) by ticker or name. Returns ticker, name, CIK and exchange. Use it when you are unsure of a ticker; most other tools accept a ticker, CIK or name directly. |
| edgar_get_company_infoA | Get a company's SEC profile: legal name, tickers/exchanges, CIK, SIC industry, filer category, fiscal year end, state of incorporation, address, former names, and its latest annual/quarterly reports. |
| edgar_list_filingsA | List a company's SEC filings, newest first, with form type, dates, accession number and document URL. Common forms: 10-K (annual), 10-Q (quarterly), 8-K (material events; see 'items', e.g. 2.02 = earnings), DEF 14A (proxy/executive pay), 4 (insider trades), S-1 (IPO), 13D/13G (5%+ holders), 20-F/6-K (foreign issuers). |
| edgar_read_filingA | Read the text of a filing's main document (10-K, 10-Q, 8-K, proxy, S-1...) or one of its exhibits. Long documents are paginated by characters.
|
| edgar_full_text_searchA | Search the full text of all SEC filings since 2001 (EDGAR full-text search). Supports exact phrases in double quotes, e.g. '"supply chain" tariffs'. Filter by form types, date range and company. Returns company, form, filing date, and document URL for each hit (read it with edgar_read_filing or open the URL). |
| edgar_get_financial_statementA | Get a company's income statement, balance sheet or cash flow statement from its SEC XBRL filings (10-K/10-Q; IFRS for 20-F/40-F filers), as line items × periods. Values are as reported (latest filing wins, so restatements are reflected). Quarterly values that are only reported year-to-date (cash flows, fiscal Q4) are derived by subtraction and flagged. The cash flow statement includes free cash flow (CFO − capex). For any tag not covered here use edgar_search_concepts + edgar_get_concept. |
| edgar_get_key_metricsA | Compute key metrics from SEC filings: revenue and YoY growth, gross/operating/net margin, diluted EPS and growth, free cash flow and FCF margin, SBC/revenue, ROE, ROA, current ratio, debt/equity, net cash, buybacks + dividends. Best single call for a quick fundamental overview of a company. |
| edgar_compare_companiesA | Compare 2-10 companies on key metrics for their latest fiscal year (or a given fiscal year): revenue, growth, margins, EPS, FCF, ROE, leverage, etc. Fiscal years end on different dates across companies; the period end used for each company is shown. |
| edgar_search_conceptsA | Find XBRL concepts (tags) a company reports, by keyword in the tag name or label — e.g. 'backlog', 'deferred revenue', 'segment', 'lease', 'employees'. Returns the concept name, label, units and the latest value. Then use edgar_get_concept for the full history. |
| edgar_get_conceptA | Get the reported history of any XBRL concept for a company (e.g. 'us-gaap:RevenueRemainingPerformanceObligation', 'dei:EntityCommonStockSharesOutstanding', 'us-gaap:NumberOfEmployees' is rarely tagged — search first). Annual/quarterly keep ~1-year/~1-quarter durations (quarters derived from YTD when needed); 'all' returns every distinct reported period. |
| edgar_rank_companiesA | Rank every SEC filer on one XBRL concept for a calendar period (XBRL "frames"), e.g. largest revenues in CY2025, most cash at end of 2025. Period formats: 'CY2025' (annual duration), 'CY2025Q4' (quarter duration), 'CY2025Q4I' (instant, for balance-sheet items). Values are aligned to calendar periods by the SEC, so fiscal years that don't match the calendar map to the closest calendar period. |
| edgar_get_insider_tradesA | Get recent insider transactions from Form 4 filings (officers, directors, 10% owners): date, insider, role, transaction type, shares, price, value and shares owned afterwards, plus a summary of open-market buys vs sells. Codes: P = open-market buy, S = open-market sale (the most informative); A = grant, M/X = option exercise, F = tax withholding, G = gift. |
| edgar_get_institutional_holdingsA | Get the US equity portfolio an investment manager reports quarterly on Form 13F (required above $100M): positions by value, % of portfolio, shares, and the change versus the previous quarter (new, added, reduced, exited). Works for hedge funds, mutual fund families, banks and insurers, e.g. 'Berkshire Hathaway', 'Pershing Square Capital Management', 'Scion Asset Management', 'Bridgewater Associates', or a CIK. Notes: 13F shows long US-listed positions only (no shorts, cash or foreign shares), is filed up to 45 days after quarter end, and identifies securities by CUSIP. Amendments are ignored. |
| market_get_stock_priceA | Get the current price and price history for a ticker (any exchange: US tickers as-is, others with a Yahoo suffix like 'SAP.DE', 'MC.PA', 'SHOP.TO', '7203.T'), an index ('^GSPC', '^MXX') or an exchange rate ('EURUSD=X', 'MXN=X' for USD/MXN). Returns current price, 52-week range, return over the range, max drawdown, and a sampled price table (split/dividend-adjusted closes). Source: Yahoo Finance's public chart endpoint (unofficial; may occasionally be unavailable). |
| market_get_dividendsA | Get a stock's dividend and split history (any exchange; Yahoo symbols like 'KO', 'JNJ', 'SAN.MC', 'WALMEX.MX'): trailing-12-month dividend and yield, payments per year, 5- and 10-year dividend growth (CAGR), consecutive years of increases, yearly totals and splits. Amounts are split-adjusted per share in the listing's currency. For the payout ratio, compare with EPS or FCF per share from edgar_get_key_metrics. |
| market_get_treasury_yieldsA | Get the official US Treasury daily par yield curve (1 month to 30 years) from treasury.gov — useful as the risk-free rate in valuations (typically the 10-year).
Returns the latest available date by default, or the closest date on/before |
| market_get_valuationA | Compute valuation multiples for a US-listed SEC filer by combining the live share price (Yahoo) with trailing-twelve-month fundamentals from SEC filings: market cap, enterprise value, P/E, P/S, P/FCF, EV/Revenue, EV/EBIT, earnings yield and FCF yield. TTM = sum of the last 4 consecutive quarters, or the latest fiscal year when quarters are missing (e.g. 20-F filers). Fails with an explanation when the company reports in a different currency from its share price (ADRs such as TSM or NVO). |
| macro_get_seriesA | Get US and global economic time series from FRED (Federal Reserve Bank of St. Louis, 800,000+ series): interest rates, inflation, GDP, jobs, money supply, credit spreads, FX, commodities, recession indicators. Pass 1-5 series IDs to line them up by date. Common IDs: DGS10 / DGS2 (Treasury yields), T10Y2Y (yield curve), FEDFUNDS, CPIAUCSL / CPILFESL (CPI / core), PCEPILFE (core PCE), UNRATE, PAYEMS, GDPC1 (real GDP), A191RL1Q225SBEA (GDP growth), M2SL, BAMLH0A0HYM2 (high-yield spread), VIXCLS, DCOILWTICO (oil), DEXUSEU / DEXMXUS (FX), USREC. Use transform 'pct_change_yoy' for inflation rates from price indexes, and frequency to aggregate daily data (e.g. monthly averages). Find other IDs with macro_search_series. |
| macro_search_seriesA | Find FRED series IDs by keyword, e.g. 'mortgage rate', 'core inflation', 'unemployment', 'yen', 'high yield'. Searches all 800,000+ FRED series when the server has a (free) FRED_API_KEY; otherwise a built-in catalog of ~50 key US series. |
| macro_get_country_indicatorA | Get annual macroeconomic indicators for any country (or aggregates like 'WLD' world, 'EUU' EU) from the World Bank, e.g. to compare the markets a company sells in. Indicators: gdp_usd, gdp_growth, gdp_per_capita, gdp_per_capita_ppp, inflation, unemployment, population, government_debt, current_account, exports, fdi_inflows, lending_rate, real_interest_rate, market_cap, exchange_rate; or any World Bank indicator ID (e.g. 'NY.GDP.MKTP.KD.ZG'). Data are annual and usually lag 6-18 months. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analizar_empresa | Análisis fundamental completo: negocio, resultados, balance, flujo de caja, valoración, insiders y riesgos. |
| comparar_empresas | Compara 2-10 empresas en crecimiento, rentabilidad, solidez financiera y valoración. |
| valoracion_dcf | Valor intrínseco por descuento de flujos de caja, con escenarios y sensibilidad. |
| resultados_trimestrales | Resume el último informe trimestral: cifras, comparación interanual y comentarios de la dirección. |
| cartera_inversor | Qué tiene y qué ha comprado o vendido un fondo o inversor institucional en el último trimestre. |
| panorama_macro | Tipos de interés, inflación, empleo, crecimiento y riesgo de recesión, con datos oficiales. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 20 tools
Most tools have distinct domains (EDGAR filings, XBRL concepts, market data, macro data), but some overlap exists: edgar_get_financial_statement, edgar_get_key_metrics, and edgar_compare_companies all derive fundamentals from SEC filings, and edgar_search_concepts/edgar_get_concept are closely paired. Descriptions are detailed enough to differentiate, though the boundary between key metrics and financial statements could confuse an agent.
The naming is mostly verb_noun with an edgar_/macro_/market_ prefix, but the prefixes are inconsistent: edgar_ tools use verbs (search, get, list, read, compare, rank), while macro_ and market_ tools mix verb styles (get_series, search_series, get_stock_price, get_dividends, get_treasury_yields, get_valuation, get_country_indicator). The pattern is readable but not uniform across the three domains.
20 tools is on the higher end but justifiable for a server covering three distinct domains (SEC filings, market data, macro data). Each tool serves a specific purpose, though a few could be consolidated (e.g., edgar_get_financial_statement and edgar_get_key_metrics overlap). The count is slightly heavy but not excessive for the apparent scope.
The server covers the core SEC filing workflow well: search companies, list/read filings, full-text search, financial statements, key metrics, comparisons, rankings, insider trades, and institutional holdings. Market data covers price, dividends, treasury yields, and valuation. Minor gaps: no direct tool for analyst estimates or earnings call transcripts, and macro data is limited to annual World Bank indicators plus FRED series, but the surface is largely complete for fundamental analysis.