What is the SEC EDGAR MCP server and what can I query with it?

It's an MCP server that lets you programmatically access SEC EDGAR filings, XBRL financial data, and company information. You can search filings by company, CIK, or filing type, and extract structured financial metrics.

Do I need to set up authentication to use this server?

The server supports three auth modes (none, JWT, or OAuth) via the MCP_AUTH_MODE environment variable. You must always provide a User-Agent header in the EDGAR_USER_AGENT env var in the format 'AppName contact@email.com' for SEC compliance.

Can I self-host this server or do I have to use the hosted endpoint?

You can self-host using `npx @cyanheads/secedgar-mcp-server@0.4.3`. Configure the HTTP host, port, and endpoint path via MCP_HTTP_HOST, MCP_HTTP_PORT, and MCP_HTTP_ENDPOINT_PATH environment variables.

What's the difference between this and directly querying the SEC EDGAR API?

This MCP server wraps EDGAR access in the Model Context Protocol, making it easy to integrate with Claude and other AI tools. It handles User-Agent compliance and XBRL parsing automatically.

How do I debug issues or see what the server is doing?

Set the MCP_LOG_LEVEL environment variable to 'debug', 'info', or 'warn' to control logging verbosity. This helps troubleshoot connection and query issues.

MCP ServerHTTPOfficialv0.4.3

Cyanheads Secedgar MCP Server

Query SEC EDGAR filings, XBRL financial data, and company information via a standards-compliant MCP server. Built for developers integrating regulatory and financial research into AI workflows.

io.github.cyanheads/secedgar-mcp-server

Open in Agent Studio Scan security View source

Hosted URL

https://secedgar.caseyjhand.com/mcp

Transport

HTTP

Auth

2 required env vars

What the Cyanheads Secedgar MCP server does

How models use it and what it is built for.

Query SEC EDGAR filings, XBRL financial data, and company information via a standards-compliant MCP server. Built for developers integrating regulatory and financial research into AI workflows.

Connect to Cyanheads Secedgar

Hosted endpoint — paste into any MCP client.

https://secedgar.caseyjhand.com/mcp

Environment variables

Configuration this server reads at startup.

EDGAR_USER_AGENTRequired
User-Agent header for SEC compliance. Format: "AppName contact@email.com".
EDGAR_USER_AGENTRequired
User-Agent header for SEC compliance. Format: "AppName contact@email.com".
MCP_LOG_LEVEL
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_HTTP_HOST
The hostname for the HTTP server.
MCP_HTTP_PORT
The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH
The endpoint path for the MCP server.
MCP_PUBLIC_URL
Public-facing origin override for TLS-terminating proxies (e.g., https://mcp.example.com). Leave unset for direct deployments.
MCP_AUTH_MODE
Authentication mode to use: 'none', 'jwt', or 'oauth'.
MCP_LOG_LEVEL
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Resources

Where to find authoritative docs and source for Cyanheads Secedgar.

Source repository

Example prompts for Cyanheads Secedgar

Paste any of these into Agent Studio after connecting Cyanheads Secedgar.

Fetch the latest 10-K filing for Apple and extract revenue by segment
Query XBRL financials for Tesla's most recent quarterly report
Search SEC EDGAR for all filings by CIK number 0000789019
What authentication modes does this server support and how do I configure JWT?