SEC EDGAR Data in Cursor

Connect Cursor to SEC EDGAR through the edgar.tools MCP server and your editor's AI can search companies, read filings, and pull financial data without leaving the file you're working on. One mcp.json entry, sign in once, done. Requires Cursor v0.48 or later.

You need a free edgar.tools account. Sign up here — or sign in with Google when Cursor prompts you on first use.

What you get in Cursor#

Cursor is the in-editor home for this connection, and it shines when your code touches financial data. Building a screener, a filings dashboard, or an integration against the edgar.tools API? Cursor's agent can fetch real company records, real filing lists, and real financial facts while it writes the code that handles them — so field names, date formats, and edge cases come from live data, not guesses. It also answers plain research questions ("what's in Apple's latest 10-K?") whenever one comes up mid-task.

1. Open Cursor's MCP settings#

Settings → MCP → Add new MCP server, or edit the config file directly:

  • macOS/Linux: ~/.cursor/mcp.json
  • Windows: %USERPROFILE%\.cursor\mcp.json

2. Add the edgar.tools server#

{
  "mcpServers": {
    "edgar-tools": {
      "url": "https://app.edgar.tools/mcp"
    }
  }
}

If you already have servers configured, add the edgar-tools entry alongside them.

3. Sign in on first use#

The first time Cursor's agent calls an edgar.tools tool, your browser opens to sign in — Continue with Google or email/password. The token lasts 90 days; future calls are automatic.

4. Verify it works#

Check Settings → MCP — edgar-tools should show as connected with its tool list. Then ask the agent:

"Get a company brief for NVIDIA."

You should see a company_brief tool call and a cited answer with NVIDIA's profile and recent filings. If the agent answers from general knowledge without a tool call, the server isn't connected yet.

Prompts to try#

  • "Search SEC EDGAR for companies in the semiconductor industry."
  • "Fetch Apple's latest quarterly filings and show me the response shape."
  • "What insider trades happened at Tesla in the last 30 days?" (insider activity unlocks on Pro)
  • "Write a TypeScript type for the company filings this tool returns."

Troubleshooting#

The server shows as disconnected in Settings → MCP. Check mcp.json for syntax errors (trailing commas are the usual culprit) and confirm the key is url — some other clients use different key names, but Cursor expects url. Restart Cursor after editing the file.

The agent doesn't use the tools. Tool calls happen in agent/composer conversations, not inline autocomplete. Ask a question that clearly needs SEC data, or name the tool: "use edgar-tools to look up…".

Tools worked before but now return errors, or your upgrade isn't reflected. Remove the server entry, restart, re-add it, and sign in again — the fresh token matches your current tier. Details in Reconnecting.

Tiers and permissions#

All edgar.tools MCP tools are read-only — the server reads SEC filing data and returns results; it cannot touch your code or act on your behalf. The free tier includes company search, filings, and company briefs; Pro adds financial statements, insider activity, full-text search, and live material events. Full mapping: MCP Tiers.