Skip to content
MCP server

EdgarTools

SEC EDGAR filings as typed Python objects, with an MCP server for assistants

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
6.3.0
Listing updated
today

Similar MCP servers

About EdgarTools

EdgarTools is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

EdgarTools turns SEC filings dating back to 1994 into structured data: standardized income statements, balance sheets and cash flows, 13F institutional holdings, Form 4 insider trades, N-PORT fund portfolios and 8-K events. It runs inside your own Python process, needs no API key, and keeps to the SEC's fair-access limit of 10 requests a second.

The MCP server is the assistant-facing side of the library. The registry entry lists 13 tools and 7 prompts and requires an EDGAR_IDENTITY value, your name and email, because EDGAR asks for contact details on every request.

The README separates the library from edgar.tools, a hosted platform with its own MCP endpoint at app.edgar.tools/mcp, and advises attaching only one of the two to a client so their routing does not overlap. Python 3.11 or newer is needed for version 6.

Install

Run in a terminal

claude mcp add edgartools --env EDGAR_IDENTITY='<EDGAR_IDENTITY>' -- uvx edgartools

Add to claude_desktop_config.json

{
  "mcpServers": {
    "edgartools": {
      "command": "uvx",
      "args": [
        "edgartools"
      ],
      "env": {
        "EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "edgartools": {
      "command": "uvx",
      "args": [
        "edgartools"
      ],
      "env": {
        "EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "edgartools": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "edgartools"
      ],
      "env": {
        "EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "edgartools": {
      "command": "uvx",
      "args": [
        "edgartools"
      ],
      "env": {
        "EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "edgartools": {
      "command": "uvx",
      "args": [
        "edgartools"
      ],
      "env": {
        "EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • EDGAR_IDENTITYYour name and email for SEC EDGAR API identification (e.g. 'Your Name your.email@example.com')Required

What it does

Standardized statements
Multi-year and quarterly income statement, balance sheet and cash flow rows that line up across companies.
Full-text filing search
Search the text of filings since 2001 by form, date range or 8-K item.
Parsed forms
13F holdings, Form 4 trades and N-PORT portfolios as typed objects and DataFrames.
Filing text for RAG
Items of a 10-K or 10-Q as text, or whole filings as markdown.

Good for

  • Compare a metric across several public companies
  • Pull recent insider trades for a ticker
  • Find 10-Ks that mention a topic such as tariffs
  • See a fund's latest holdings
  • Feed filing sections to a retrieval pipeline

Pricing

Open source

MIT licence; hosted edgar.tools is separate

EdgarTools FAQ

Do I need an API key?

No. EDGAR only requires an identity string with your name and email.

What licence is it under?

The README says free and open source under the MIT licence.

How does it differ from edgar.tools?

edgar.tools is the hosted platform built on the library; the library runs locally in your own process.

Which Python version is needed?

Python 3.11 or newer for version 6.

Is EdgarTools free?

Yes. EdgarTools is open source, so you can use and self-host it for free.

How do I add EdgarTools to Claude Code?

Run this command in your terminal: claude mcp add edgartools --env EDGAR_IDENTITY='<EDGAR_IDENTITY>' -- uvx edgartools

What are the best alternatives to EdgarTools?

The closest alternatives to EdgarTools are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers