SEC EDGAR MCP server for Claude, Cursor and any MCP client

Call typed SEC filing data — resolved 13D activist stakes, parsed 8-K item codes, S-1 and merger forms — as tools inside your AI client. Open source, MIT, runs over stdio.

edgar-events-mcp is a Model Context Protocol server that wraps the EDGAR Events API. Point any MCP client at it and your agent pulls resolved SEC filing data directly, instead of scraping EDGAR HTML or writing the cover-page parser by hand. It uses only the Python standard library for HTTP and works with Claude Desktop, Cursor, Cline, Continue, and other MCP clients. EDGAR Events is an independent service and is not affiliated with the SEC.

The four tools

Tool	Key	Returns
get_recent_activist_stakes	No key	Latest resolved SC 13D / 13D-A stakes: holder, target ticker, percent of class, share count.
get_activist_stakes	Key	The full 13D feed with date-range, ticker, and minimum-percent filters.
get_filings	Key	Typed filing events across named tickers, by form type, 8-K item code, materiality, and lookback.
get_ticker_filings	Key	The same feed scoped to one ticker.

get_recent_activist_stakes needs no key and no signup. Drop the server into your client with no env block and ask who just took an activist stake in a public company; the tool answers from the live SEC feed.

Install

pip install git+https://github.com/reedox/edgar-events-mcp

That gives you an edgar-events-mcp console command. To run it with no install, use uv:

uvx --from git+https://github.com/reedox/edgar-events-mcp edgar-events-mcp

Once the package is published to PyPI the shorter uvx edgar-events-mcp will work. Until then, use the git form above.

Claude Desktop config

Open Settings, then Developer, then Edit Config, and add the server to claude_desktop_config.json:

{
  "mcpServers": {
    "edgar-events": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/reedox/edgar-events-mcp",
        "edgar-events-mcp"
      ],
      "env": {
        "EDGAR_EVENTS_API_KEY": "your-key-or-omit-for-the-free-tool"
      }
    }
  }
}

Drop the env block and the server runs with only the free get_recent_activist_stakes tool. Restart the client after editing. The same command, args, and env shape works in Cursor, Cline, and Continue. The key is read from the environment and sent as the X-API-Key header; it is never logged. To point at a different API host, set EDGAR_EVENTS_BASE_URL.

What the key adds

A key turns on the three filtered tools and the full filing history behind them. The model picks the tool and fills in the ticker, date range, item code, and materiality flag from your question:

• "Show me 13D filings above 10% of class since June 1." calls get_activist_stakes.
• "Did AAPL or MSFT file any material 8-Ks in the last day?" calls get_filings.

Comparing it against sec-api.io, EdgarKit, and the free edgartools library? The SEC filing API comparison covers who resolves a 13D cover page and who pushes it to a signed webhook in real time.

FAQ

Which MCP clients does it work with?

Any client that speaks the Model Context Protocol over stdio: Claude Desktop, Cursor, Cline, Continue, and others. The same command, args, and env shape works across all of them.

Can I use it without an API key?

Yes. The get_recent_activist_stakes tool needs no key and no signup. It returns the latest resolved SC 13D / 13D-A stakes. The three filtered tools need a free or paid key.

What are the four tools?

get_recent_activist_stakes (free, no key), get_activist_stakes, get_filings, and get_ticker_filings. The last three take a key and open the date-range, ticker, form, 8-K item-code, and materiality filters.

Does it resolve the 13D cover page to holder and percent?

Yes. Stakes come back parsed from the SC 13D cover-page XML: holder, target ticker, percent of class, and share count. You get typed JSON, not a link to the filing.

What does it cost?

The free tool and a free key cost nothing. A Pro key is 29 USD per month and adds the full filing history and real-time signed webhooks.