Skip to main content
Glama
SEC EDGAR MCP

SEC EDGAR MCP

by jsconiers

SEC EDGAR MCP

A free, key-less Model Context Protocol server for SEC EDGAR — company filings, XBRL financial facts, and full-text search, straight from the primary source. No API key, no account, no rate-limited third-party wrapper.

Built with FastMCP.

Tools

Tool

What it does

edgar_status

Show configuration (User-Agent, endpoints) and check that SEC is reachable.

lookup_cik

Resolve a stock ticker to its SEC CIK number and company name.

company_filings

Recent filings for a company (ticker or CIK), filterable by form type (10-K, 8-K, 4, ...).

insider_transactions

Recent insider Form 4 / 4-A filings for a company.

company_concept

Time series for one XBRL concept, e.g. NetIncomeLoss, Assets, EarningsPerShareDiluted.

company_facts

Discover every XBRL concept tag a company reports (feed tags into company_concept).

company_financials

Headline snapshot: revenue, net income, assets, liabilities, equity, diluted EPS.

full_text_search

Full-text search across all EDGAR filings (2001-present), with form and date filters.

All filing results include direct links to the documents on SEC.gov.

Related MCP server: stockscope-mcp

Install

git clone https://github.com/jsconiers/sec-edgar-mcp.git
cd sec-edgar-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python test_edgar.py   # offline tests

Use with Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sec-edgar": {
      "command": "/absolute/path/to/sec-edgar-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/sec-edgar-mcp/sec_edgar_mcp.py"]
    }
  }
}

Restart Claude Desktop, then ask things like "Pull NVIDIA's latest 10-K", "What was Apple's net income trend?", or "Find recent 8-Ks mentioning artificial intelligence."

Examples

lookup_cik("AAPL")                          -> CIK 0000320193, Apple Inc.
company_filings("NVDA", form_type="10-K")   -> recent annual reports + links
insider_transactions("MSFT")                -> recent Form 4 insider activity
company_concept("AAPL", "NetIncomeLoss")    -> quarterly/annual net income series
company_financials("TSLA")                  -> revenue, net income, assets, equity, EPS
full_text_search("data breach", forms="8-K", date_from="2025-01-01")

Data sources

  • data.sec.gov — submissions (filing history) and XBRL company facts / concepts

  • efts.sec.gov — EDGAR full-text search

  • www.sec.gov/files/company_tickers.json — ticker -> CIK map

Access note (User-Agent)

SEC asks API clients to identify themselves with a contact in the User-Agent. In practice the www.sec.gov host currently sits behind a bot manager that rejects descriptive User-Agents, so this server sends a browser-like header set that works. Override it via the SEC_EDGAR_UA environment variable if you wish (a browser-like UA is recommended). Please keep request volume under ~10 requests/second per SEC's fair-access policy.

License

MIT — see LICENSE. Not affiliated with or endorsed by the U.S. Securities and Exchange Commission. For informational purposes only; not investment advice.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for SEC EDGAR that provides real-time access to filings, financial statements, and full-text search across all EDGAR documents.
      Apache 2.0
    • A
      license
      A
      quality
      F
      maintenance
      Free MCP server for stock and financial intelligence from SEC EDGAR, supporting financials, filings, comparisons, insider trades, historical prices, and sector peers.
      6
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server that enables models to access SEC EDGAR filings, filing text, and XBRL financial facts with caching, rate limiting, and iXBRL stripping.
      8
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for SEC EDGAR data, providing tools to look up companies, retrieve filings and documents, and access XBRL financial facts.
      MIT