EdgarTools
SEC EDGAR filings as typed Python objects, with an MCP server for assistants
- 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 edgartoolsAdd 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.


