Skip to content
Private beta access

SEC EDGAR MCP server for Claude and Codex

Connect Claude, Codex, or any MCP-compatible workflow to source-aware SEC EDGAR filing metadata for finance research and monitoring.
Request API keyView setup guide

Short answer

CMD+RVL's SEC EDGAR MCP server gives AI agents a bounded way to query filing metadata by company, CIK, form type, date range, amendments, and filing cadence while keeping EDGAR source context visible.
  • Private-beta remote MCP endpoint
  • Claude, Codex, and Claude Desktop examples
  • 10-K, 10-Q, 8-K, and amendment metadata

What the EDGAR MCP server covers

The public page keeps the surface deliberately narrow: retrieval, filing history, and monitoring context that a human can check against SEC EDGAR.

Source-aware filing metadata

Query companies, CIKs, form types, filing dates, amendments, and cadence with records that point back to EDGAR source context.

MCP access for finance workflows

Use a private-beta MCP endpoint from Claude, Codex, or another compatible client when your agent needs current filing metadata instead of pasted documents.

Bounded query surface

Designed for retrieval, filing history, and monitoring questions. It is not a general filing validator, investment adviser, or substitute for human review.

Example queries

"How many 8-K filings were submitted yesterday?"
"Show me Microsoft's 10-Q filings from Q4 2025"
"List amended 10-K and 10-Q filings for Tesla in 2025"
"What's the filing cadence for JPMorgan over the last twelve months?"

For developers

Technical details about the EDGAR MCP server for finance-data workflows, including the available tool, supported query patterns, and access boundaries.
Available tool

edgar_com_query

Natural language query interface to EDGAR filing metadata. Supports counts, lists, statistics, trends, amended-filing checks, cadence analysis, and time windows. 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
1

Choose your MCP client

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

Open your Claude settings file

Open your Claude settings file. If it doesn't exist, create it at the path below.
~/.claude/settings.json
3

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"
      }
    }
  }
}
4

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.

EDGAR MCP questions

What is the CMD+RVL SEC EDGAR MCP server?

The CMD+RVL SEC EDGAR MCP server is a private-beta Model Context Protocol server that lets Claude, Codex, and MCP-compatible clients query source-aware SEC filing metadata.

What can I query with the EDGAR MCP server?

The EDGAR MCP server supports filing counts, lists, statistics, trends, amended-filing checks, cadence analysis, and time windows across company, CIK, form type, filing date, and amendment metadata.

Which MCP clients does the EDGAR server support?

The page includes setup guidance for Claude CLI, Codex CLI, and Claude Desktop. Other MCP-compatible clients can use the same endpoint and API-key header pattern when they support remote MCP server configuration.

Is the EDGAR MCP server a filing validator or investment adviser?

No. The EDGAR MCP server is designed for retrieval, filing history, and monitoring questions. It is not a general filing validator, investment adviser, or substitute for human review.

Related resources

Use these pages to connect the EDGAR MCP server with adjacent developer, webhook, LLM, and outcome-delivery workflows.

Developer tools for auditable AI workflows

CLIs, SEC EDGAR MCP access, PBIX lineage extraction, webhooks, and machine-readable CMD+RVL data.

Webhook quickstart for SEC filing notifications

Local webhook setup and payload inspection for SEC filing notification workflows.

LLM resources

AI and LLM integration guides for CMD+RVL data surfaces.

Outcome API documentation

Scoped API access for outcome feeds and source-aware delivery.

Fee Exhibit Fragility Authority

Bounded Kovrex agent for SEC filing-fee exhibit checks.

Questions?

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