# EDGAR MCP server: SEC filings in Claude, Cursor, Codex and VS Code

Canonical: https://sec-api.dev/edgar-mcp-server

> sec-api.dev runs a hosted, read-only EDGAR MCP server at https://sec-api.dev/api/mcp (Streamable HTTP, bearer API key) with 17 tools for company lookup, filings, filing text, XBRL facts, insider trades and FDA catalysts; add it to Claude Desktop through mcp-remote, or natively to Claude Code, Cursor, Codex, Gemini CLI and VS Code with the configs below, on the free 100-request plan.

sec-api.dev, not sec-api.io. Checked 2026-11-13.

**Free plan:** 100 API requests a month, 30 a minute, no credit card. Get a key: https://sec-api.dev/sign-up?ref=ai-claudebot

## Key facts

Server facts as of November 13, 2026. Client syntax checked against each vendor's documentation.

| Field | Value |
| --- | --- |
| Endpoint | https://sec-api.dev/api/mcp |
| Transport | Streamable HTTP (one JSON-RPC message per POST); no SSE |
| Authentication | Authorization: Bearer <sec-api.dev API key> |
| Tools | 17 read-only: 12 SEC EDGAR tools and 5 biotech catalyst tools |
| Price | Free: 100 requests every month, no card. Paid: Builder $29/month (50,000 requests), Scale $99/month (250,000 requests). Every MCP request, including discovery, counts. |
| Discovery | https://sec-api.dev/.well-known/mcp.json |
| Local stdio server | npx -y sec-api-dev-mcp (npm package sec-api-dev-mcp, https://www.npmjs.com/package/sec-api-dev-mcp) |
| Clients | Claude Desktop (via mcp-remote), Claude Code, Cursor, Codex CLI, Gemini CLI, VS Code, any client that sends custom headers |

## Claude Desktop

Claude Desktop starts local MCP servers from claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%\Claude\claude_desktop_config.json). mcp-remote bridges it to the hosted server and adds the Authorization header. Node.js 18 or later is required for npx. Replace your-sec-api-key, save, and restart Claude Desktop; the sec-api tools appear under the tools menu.

The key sits in this file. Keep the file private and rotate the key from your dashboard if it is shared. Writing Authorization:${AUTH_HEADER} without a space avoids an argument-quoting bug on Windows.

claude_desktop_config.json:

```json
{
  "mcpServers": {
    "sec-api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://sec-api.dev/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer your-sec-api-key"
      }
    }
  }
}
```

## Run it locally from npm

The same tools also ship as a stdio MCP server on npm, sec-api-dev-mcp (https://www.npmjs.com/package/sec-api-dev-mcp): zero dependencies, Node 18+, read-only. It runs through npx on your machine and calls the hosted API with SEC_API_KEY; demo_company and fda_calendar_next_30_days work without a key.

Claude Code:

```bash
claude mcp add sec-api -e SEC_API_KEY="$SEC_API_KEY" -- npx -y sec-api-dev-mcp
```

claude_desktop_config.json (or .cursor/mcp.json):

```json
{
  "mcpServers": {
    "sec-api": {
      "command": "npx",
      "args": [
        "-y",
        "sec-api-dev-mcp"
      ],
      "env": {
        "SEC_API_KEY": "your-sec-api-key"
      }
    }
  }
}
```

## Claude Code

Terminal (stored in ~/.claude.json, or .mcp.json with --scope project). The header value is stored in Claude Code’s configuration when you add the server. Rotate the key from the dashboard if that file is shared.

- Create a free sec-api.dev account and copy an API key from the dashboard.
- Run the command below in your project. Use --scope user to make the server available in every project.
- Start Claude Code and run /mcp to confirm sec-api is connected and lists 17 tools.

Terminal (stored in ~/.claude.json, or .mcp.json with --scope project):

```bash
export SEC_API_KEY="your-key"
claude mcp add --transport http sec-api https://sec-api.dev/api/mcp \
  --header "Authorization: Bearer $SEC_API_KEY"
```

## Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (project). Cursor resolves ${env:NAME} at startup, so the file itself holds no secret.

- Create a free sec-api.dev account and copy an API key.
- Set SEC_API_KEY in the environment Cursor starts with, then restart Cursor.
- Add the configuration below and enable the server in Settings, MCP.

~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

```json
{
  "mcpServers": {
    "sec-api": {
      "url": "https://sec-api.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SEC_API_KEY}"
      }
    }
  }
}
```

## Codex CLI

~/.codex/config.toml. bearer_token_env_var makes Codex send Authorization: Bearer with the variable’s value.

- Create a free sec-api.dev account and copy an API key.
- Export SEC_API_KEY in the shell that runs Codex.
- Add the block below to config.toml and restart Codex; run /mcp to list the tools.

~/.codex/config.toml:

```toml
[mcp_servers.sec-api]
url = "https://sec-api.dev/api/mcp"
bearer_token_env_var = "SEC_API_KEY"
```

## Gemini CLI

~/.gemini/settings.json (user) or .gemini/settings.json (project). httpUrl selects streamable HTTP; url would select SSE, which this server does not use.

- Create a free sec-api.dev account and copy an API key.
- Export SEC_API_KEY before starting Gemini CLI.
- Add the server below to settings.json and run /mcp to confirm the tools.

~/.gemini/settings.json (user) or .gemini/settings.json (project):

```json
{
  "mcpServers": {
    "sec-api": {
      "httpUrl": "https://sec-api.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer $SEC_API_KEY"
      }
    }
  }
}
```

## VS Code

.vscode/mcp.json (workspace) or the user MCP configuration. The input variable keeps the key out of the file. Use ${env:SEC_API_KEY} instead if you prefer environment variables.

- Create a free sec-api.dev account and copy an API key.
- Add the configuration below. VS Code prompts for the key once and stores it securely.
- Open the Chat view in agent mode and enable the sec-api tools.

.vscode/mcp.json (workspace) or the user MCP configuration:

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "sec-api-key",
      "description": "sec-api.dev API key",
      "password": true
    }
  ],
  "servers": {
    "sec-api": {
      "type": "http",
      "url": "https://sec-api.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sec-api-key}"
      }
    }
  }
}
```

## Tools

| Tool | Use it for |
| --- | --- |
| search_companies | Ticker/name → CIK. Current ticker directory. |
| get_company | CIK → source company profile. |
| get_filings | CIK → filings, exact form, recent or available full history. |
| get_companyfacts | CIK → reported facts; taxonomy, concept and unit filters. |
| search_filing_text | SEC document matches; query, form, CIK and date filters. |
| get_daily_index | A published SEC daily index; not a live feed. |
| get_documents | Accession → manifest, then bounded text from a listed filename. |
| extract_section | 10-K/10-Q/8-K heading-based extraction; verify boundaries. |
| get_insider_records | One Forms 3/4/5 XML: transactions, holdings and footnotes. |
| get_13f_holdings | One 13F information table; not a reconciled portfolio. |
| get_filing_xml | One verified XML document → source-native JSON. |
| query_insider_transactions | Imported quarterly transactions with exact filters, facets and snapshot guard; default1/max10 rows. |
| get_biotech_calendar | Upcoming FDA and clinical catalysts (PDUFA, AdCom, readouts) for the next N days, each with its exact source sentence. |
| get_drug_catalysts | Drug id, name or code → designations, sponsor and every dated catalyst with sources. |
| get_company_catalysts | Ticker or CIK → the company’s drugs, catalysts and cash runway (runway on Pro). |
| get_pdufa_outcomes | Past PDUFA, AdCom, CRL and readout outcomes (Biotech Pro and API plans). |
| search_biotech_events | Filter catalysts by date range, type, indication, phase, designation, ticker and date confidence. |

## First prompt to try

Prompt:

```text
Using the sec-api tools, find Apple's CIK, list its last three 10-K filings with their filing dates, and report total revenue from XBRL facts for each fiscal year. Cite the SEC URL for every number.
```

## Other EDGAR MCP servers

EdgarTools ships edgartools-mcp, a free server that runs on your machine in Python and calls the SEC directly. sec-api.io lists an MCP server on its plans (from $49 a month after 100 trial calls). The SEC itself publishes no MCP server. sec-api.dev is hosted, so nothing runs locally except the optional mcp-remote bridge for Claude Desktop.

## FAQ

### Is there an MCP server for SEC EDGAR?

Yes. sec-api.dev hosts one at https://sec-api.dev/api/mcp with 17 read-only tools and a free plan; EdgarTools ships a local one (edgartools-mcp).

### How do I add SEC EDGAR data to Claude Desktop?

Add the claude_desktop_config.json block on this page (it runs mcp-remote with your sec-api.dev key in the Authorization header) and restart Claude Desktop.

### Does the MCP server cost anything?

It is included on every plan. The free plan has 100 requests every month, no card; every MCP request, including initialization and tool discovery, counts toward it.

### Can the MCP server change anything?

No. Every tool is read-only: no trading, no account changes, no outgoing messages.

## Sources

- [Model Context Protocol: connect local servers (Claude Desktop)](https://modelcontextprotocol.io/docs/develop/connect-local-servers)
- [mcp-remote](https://github.com/geelen/mcp-remote)
- [Claude Code: Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp)
- [Cursor: Model Context Protocol](https://cursor.com/docs/context/mcp)
- [OpenAI: Codex MCP configuration](https://developers.openai.com/codex/mcp)
- [Gemini CLI: MCP servers](https://geminicli.com/docs/tools/mcp-server/)
- [VS Code: MCP configuration reference](https://code.visualstudio.com/docs/agents/reference/mcp-configuration)
- [EdgarTools MCP](https://github.com/dgunning/edgartools)

## Related

- [MCP reference and agent loop rules](https://sec-api.dev/docs/mcp)
- [agents.md (setup for agents)](https://sec-api.dev/agents.md)
- [Use with Claude Code](https://sec-api.dev/use-with-claude)
- [Use with Cursor](https://sec-api.dev/use-with-cursor)
- [Use with Codex CLI](https://sec-api.dev/use-with-codex)
- [Use with Gemini CLI](https://sec-api.dev/use-with-gemini)
- [Use with VS Code](https://sec-api.dev/use-with-vscode)
- [EDGAR API alternatives](https://sec-api.dev/edgar-api-alternatives)

---
Independent. Not affiliated with, endorsed by, or sponsored by the U.S. Securities and Exchange Commission. Data is reproduced from public SEC filings and datasets. Not investment advice. Not affiliated with sec-api.io.
