Skip to content
MCP server

EDGAR Filings

SEC filing figures with accession numbers: symbols, segment revenue, BDC credit, Form 4

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.1.3
Listing updated
today

Similar MCP servers

About EDGAR Filings

EDGAR Filings is an open-source MCP server for legal and government. It runs locally on your machine and is started by your AI client.

The aim is to stop a model from guessing financial facts. Each figure returned is tagged with its accession number, XBRL concept, period and an EDGAR index URL, so a reader can open the filing and confirm it. The README frames the problem as models inventing segment mix, insider trades and BDC credit quality.

It is built on the edgartools library and covers four narrow jobs: every trading symbol on the latest 10-K or 10-Q, dimensioned segment revenue, non-accrual rates for business development companies, and the newest Form 4 insider summaries. The tools warn about known pitfalls, such as dual-class tickers overwriting the common symbol, Form 4 grants and option exercises not counting as open-market trades, and a parse gap when non-accrual extraction returns none.

The SEC requires a fair-access identity, so an EDGAR_IDENTITY value with a real name and email is mandatory. The first launch downloads pandas and pyarrow, which can make a client look stuck.

Install

Run in a terminal

claude mcp add edgar-mcp --env EDGAR_IDENTITY='<EDGAR_IDENTITY>' -- uvx edgar-filings-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "edgar-mcp": {
      "command": "uvx",
      "args": [
        "edgar-filings-mcp"
      ],
      "env": {
        "EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "edgar-mcp": {
      "command": "uvx",
      "args": [
        "edgar-filings-mcp"
      ],
      "env": {
        "EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "edgar-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "edgar-filings-mcp"
      ],
      "env": {
        "EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "edgar-mcp": {
      "command": "uvx",
      "args": [
        "edgar-filings-mcp"
      ],
      "env": {
        "EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "edgar-mcp": {
      "command": "uvx",
      "args": [
        "edgar-filings-mcp"
      ],
      "env": {
        "EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
      }
    }
  }
}

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

Configuration

  • EDGAR_IDENTITYSEC fair-access User-Agent: 'Name you@email.com'Required

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

get_trading_symbols
Returns every TradingSymbol on the latest 10-K or 10-Q.
get_segment_revenue
Returns dimensioned XBRL revenue by product, business or geographic axis.
get_bdc_nonaccrual
Returns BDC non-accrual rate, fair value, named investments and extraction method.
get_form4
Returns newest Form 4 summaries, transaction lines, open_market and code_counts.

What it does

Trading symbols
Lists every TradingSymbol on the latest 10-K or 10-Q.
Segment revenue
Returns revenue split by product, business or geographic axes.
BDC non-accrual
Reports non-accrual rate, fair value, named investments and extraction method.
Form 4 summaries
Shows the newest insider filings with transaction lines and an open-market flag.
Checkable citations
Every number carries accession, concept, period and EDGAR URL.
Built-in warnings
Tools flag known traps such as dual-class tickers and 10-K/A amendments.

Good for

  • Check NVDA data center segment revenue against its filing
  • Review a BDC's non-accrual rate and the investments behind it
  • Scan recent insider transactions and separate open-market trades from grants
  • Find all listed symbols a filer reports

Pricing

Open source

MIT licence

EDGAR Filings FAQ

What identity does the SEC need?

Set EDGAR_IDENTITY to a real name and email address, as the SEC fair-access policy asks.

Which filing forms are supported?

The 10-K and 10-Q for symbols, segments and BDC data (10-K is the default), plus Form 4.

How do I install it?

Add uvx edgar-filings-mcp to your client's MCP config, or install from the Git repository or a clone.

Why is the first start slow?

The first uvx run downloads edgartools with pandas and pyarrow; running it once in a terminal caches them.

What is the licence?

MIT; it is not affiliated with the SEC.

Is EDGAR Filings free?

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

How do I add EDGAR Filings to Claude Code?

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

What are the best alternatives to EDGAR Filings?

The closest alternatives to EDGAR Filings 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