# EdgarTools

> EdgarTools is an open-source MCP server for finance and payments. SEC EDGAR filings as typed Python objects, with an MCP server for assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/dgunning/edgartools
- **MCP Registry name:** io.github.dgunning/edgartools
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/edgartools
