Private Beta

EDGAR MCP Server

Query SEC EDGAR filings with natural language. Connect Claude, Codex, or any MCP-compatible client to structured filing metadata.

Natural Language Queries

Ask questions like "How many 10-K filings did Apple have last quarter?" and get structured answers.

Filing Metadata Access

Search submissions by company, CIK, filing type, date ranges, and more.

MCP Standard

Works with any Model Context Protocol compatible client out of the box.

Example Queries

"How many 8-K filings were submitted yesterday?"

"Show me Microsoft's 10-Q filings from Q4 2025"

"What companies filed the most 10-Ks last month?"

"List amended filings for Tesla in 2025"

For Developers

Technical details about the EDGAR MCP Server, including the available tool and query capabilities.

Available Tool

edgar_com_query

Natural language query interface to EDGAR filing metadata. Supports counts, lists, statistics, trends, and more. Automatically handles date ranges, calendar quarters, and relative dates.

Supported Query Types

count

list

statistics

frequency

trend

time_window

amended

cadence

Request Access

The EDGAR MCP Server is currently in private beta. Enter your email to request an API key.

Quick Start

Already have an API key? Follow these steps to connect the EDGAR MCP server to your client.

Before You Start

API Key — Request access above and wait for your API key via email
Node.js — Version 18 or higher installed on your machine

MCP Client — Claude CLI, Codex CLI, or Claude Desktop installed

Choose your MCP client

Select the client you want to configure. Each has a different config file location.

Open your Claude settings file

Open your Claude settings file. If it doesn't exist, create it at the path below.

~/.claude/settings.json

Add the EDGAR MCP server config

Copy this configuration and paste it into your config file. Replace your-api-key with the API key you received via email, and your-session-id with any identifier you like (e.g., "my-session-1").

{
  "mcpServers": {
    "edgar": {
      "type": "sse",
      "url": "https://edgar.cmdrvl.com/mcp",
      "headers": {
        "X-API-Key": "your-api-key",
        "MCP-Session-ID": "your-session-id"
      }
    }
  }
}

Restart your client

Start a new Claude CLI session. The edgar_com_query tool should now be available. Try asking: "How many 10-K filings were submitted last week?"

Using a different tool?We have instructions for Claude CLI, Codex CLI, and Claude Desktop. If you're using a different MCP-compatible client (Cursor, VS Code, Windsurf, etc.), the configuration pattern is similar — you'll need to point to our SSE endpoint and include your API key in the headers. Reach out and we'll help you get set up.

Questions?

Reach out if you have questions about integration, need help troubleshooting, or want to discuss your use case.Contact Us→