PlugWiki
EdgarTools logo

EdgarTools MCP Server Setup for Claude Code, Cursor and Other Apps

CommunityLocal
GetPyPIedgartoolsdgunning/edgartoolsDocs

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.

Install EdgarTools MCP

Claude Code

  1. 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. 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_company

  • Finds 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_search

  • Finds 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_search

  • Opens 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_filing

  • Reads 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_read

  • Shows 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_trends

  • Compares 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_compare

  • Shows 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_ownership

  • Shows 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_proxy

  • Explains 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_notes

  • Looks 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_fund

  • Lists 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_screen

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-onlyThere is no separate switch. The 13 registered tools only look up and read filings.
Talks toSEC EDGAR, with the name and email you set as your identity
Sign-in and keysNo 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

WebsiteDocsGitHubPyPIOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.