
EdgarTools MCP Server Setup for Claude Code, Cursor and Other Apps
Lets Claude and other assistants search SEC filings, read 10-Ks and compare company financials from EDGAR.
EdgarTools is an open-source Python toolkit for SEC EDGAR, and its built-in server gives your assistant 13 tools for US company filings. It covers financials, filing text, insider trades, fund holdings and executive pay. It runs on your computer with no API key, but the SEC asks you to identify yourself, so you set your name and email once in the config. Install it with the extra named in the install box, not the bare package name.
Good for
- Investors and analysts who want filings read and compared by Claude
- Researchers tracking insider trades, 13F holdings or executive pay
- Finance students who need quick company financials from primary sources
- Developers who already use the EdgarTools Python library
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install EdgarTools MCP
Claude Code
- 1
Copy this prompt.
Add the EdgarTools MCP server to Claude Code. Run this command: claude mcp add edgartools -e EDGAR_IDENTITY=<EDGAR_IDENTITY> -- uvx --from "edgartools[ai]" edgartools-mcp Ask me for EDGAR_IDENTITY and only put the values in that config, nowhere else. Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python), uv.
Run the server with the ai extra, as shown, because plain uvx edgartools is the library and command line tool, not the MCP server. Replace the identity placeholder with your name and email, for example Jane Doe jane@example.com.
Built from the package data we hold. Not yet tested by us.
Tools
Gives a company overview: profile, financials, filings, owners
The best starting point for any company question. One call can return the profile, financial statements, recent filings and ownership data, and you choose which parts to include.
Try: “Give me an overview of Apple with eight quarters of financials.”
Network ·
edgar_companyFinds companies by name or lists their filings by form type
Searches company names and filing details such as form type and date. It does not search the text inside filings.
Try: “List Apple's 8-K filings from this year.”
Network ·
edgar_searchFinds filings that mention a topic or phrase
Searches the actual text of SEC filings through EDGAR full-text search, with filters for form type and date range.
Try: “Find 8-Ks that mention a cybersecurity incident since January.”
Network ·
edgar_text_searchOpens one filing and summarizes what is in it
Returns what a filing is, its key data and what you can read next. For 10-K, 10-Q, 8-K, Form 4, 13F and proxy filings it also pulls out financials, sections and transactions.
Try: “Show me the latest 10-K for Microsoft.”
Network ·
edgar_filingReads specific sections of a filing
Extracts the text of sections such as risk factors, management discussion, business description and financial tables. Use the filing tool first to pick the filing.
Try: “Read the risk factors section of Tesla's latest 10-K.”
Network ·
edgar_readShows financial figures over time with growth rates
Returns time series from XBRL data, such as revenue, net income and EPS, across annual or quarterly periods with growth rates.
Try: “Show Nvidia revenue and net income by quarter for the last 8 quarters.”
Network ·
edgar_trendsCompares companies side by side on financial metrics
Lines up chosen companies on metrics such as revenue and net income, or picks peers automatically for an industry.
Try: “Compare revenue and net income for JPM, BAC and WFC.”
Network ·
edgar_compareShows insider trades and fund portfolios
Covers insider trading from Form 4 filings and institutional portfolios from 13F filings, including changes between periods.
Try: “What insider trades were filed at Apple recently?”
Network ·
edgar_ownershipShows CEO pay and governance data
Pulls executive compensation tables, pay-versus-performance figures and governance details from proxy statements.
Try: “What was the CEO of Microsoft paid last year?”
Network ·
edgar_proxyExplains the notes behind financial statement numbers
Returns the narrative and tables from a note such as debt, leases, revenue recognition or contingencies, and which statement lines it explains.
Try: “What does Apple's debt note say about its notes payable?”
Network ·
edgar_notesLooks up funds, ETFs, BDCs and money market funds
Finds funds by ticker or name and returns holdings, money market yields and BDC investments, depending on the action you ask for.
Try: “Show the top holdings of the VFINX fund.”
Network ·
edgar_fundLists companies by industry, exchange or state
Filters the SEC's reference data by industry, SIC code, exchange or state and returns matching companies.
Try: “List semiconductor companies on Nasdaq.”
Read ·
edgar_screenShows what was just filed with the SEC
Returns the latest filings from the live feed, which updates every few minutes, optionally for one form type.
Try: “Show today's newest 8-K filings.”
Network ·
edgar_monitor
Read from the source code
Permissions
low risk · 2 things to watch
Low risk
Every tool only reads public SEC data, and your name and email are sent to the SEC with each request. Nothing is written or deleted.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
HTTP mode has no sign-in
The optional streamable-http mode listens on 127.0.0.1 by default. If you bind it to 0.0.0.0, anyone on the network can call it, so keep it behind an authenticating proxy. github.com
Your name and email go to the SEC
The identity you set is sent with every request, as the SEC asks. Use an address you are happy to share. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | There is no separate switch. The 13 registered tools only look up and read filings. |
|---|---|
| Talks to | SEC EDGAR, with the name and email you set as your identity |
| Sign-in and keys | No key or account. EDGAR_IDENTITY holds your name and email, which the SEC requires for API requests. |
Questions
Is EdgarTools official?
No. It is an open-source project by dgunning, not made by the SEC.
Do I need an API key?
No. You set EDGAR_IDENTITY to your name and email, which the server says the SEC requires for API requests.
Why does the install use edgartools[ai]?
The server needs the extra packages in the ai option. Installing plain edgartools gives you the library but not the server.
Is it free?
Yes. It is MIT licensed and reads public SEC data with no paid tier.
Can it write or file anything with the SEC?
No. All 13 tools look up and read public filings.
Which filings can it read?
The project says it covers every filing type. It extracts structured data for 10-K, 10-Q, 8-K, Form 4, 13F and proxy filings, and reads text from others.
Can I run it for a team?
Yes. It has a streamable-http mode on port 8000. The README warns the endpoint has no authentication, so put it behind a proxy or keep it on a trusted network.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
edgartools- Registry
- PyPI
- Transport
- stdio
- Auth
- None
- Version
- 5.62.1
- License
- MIT
- Last commit
- Oct 25, 2026
- Open issues
- 93
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com