Edgaralert MCP server

EDGAR Alert MCP Server

Connect Claude Desktop (or any MCP-compatible client) directly to your EDGAR Alert account. Ask live questions about SEC insider trading signals, Form 4 activity, 8-K officer/director changes, and company research context — without leaving your conversation.

Works on any paid EDGAR Alert plan. Most tools (latest alerts,

search, company profiles, fundamentals, price windows) work on STARTER

and PRO. One tool — edgaralertgetcompanyagentcontext, the bundled

AI research-context payload — requires Enterprise; on a lower plan

it returns a clear upgrade message instead of failing silently. See

Tools below for the full breakdown, and

edgaralert.com/pricing to upgrade.

What this is (and isn't)

https://api.edgaralert.com/api/v1 REST API. Every tool maps to exactly one v1 endpoint.

• A thin wrapper around the existing public

here — all of that lives in the API, same as it does for every other v1 API consumer.

• No direct database access. No scoring or signal logic is duplicated

place orders, change your subscription, or alter account settings.

• No billing, no account management, no trading. This server cannot

edgaralertaddtickertolist and edgaralertremovetickerfromlist POST and DELETE against /ticker-lists. Everything else is a GET.

• Two tools write, and only to your own watchlists.

api.edgaralert.com as the X-API-Key header, and this server never writes it to disk or logs it.

• Your API key is yours — you provide it, it is sent only to

Requirements

(get one here) — STARTER and PRO both work for most tools; Enterprise unlocks all 8.

• Node.js 18.17 or later
• An EDGAR Alert API key on any paid plan

Install

Option A: One-click install via .mcpb (recommended for most users)

latest release.

1. Download edgaralert-mcp.mcpb from the

Install Extension, and select the downloaded file (or just drag the file onto the Claude Desktop window).

1. Open Claude Desktop → Settings → Extensions → Advanced settings →

securely in your OS keychain — this project never sees or stores it outside that prompt.

1. When prompted, paste your EDGAR Alert API key. Claude Desktop stores it

1. Restart Claude Desktop if prompted.

Option B: Manual install via claudedesktopconfig.json

1. Clone or download this folder (mcp-server/) somewhere on your machine.
2. Install dependencies and build:

cd mcp-server
   npm install
   npm run build

1. Open your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

1. Add an entry under mcpServers (see example below).
2. Restart Claude Desktop.

Option C: Run locally for development

cd mcp-server
npm install
EDGARALERT_API_KEY=EA_your_key_here npm run dev

This runs the server on stdio using tsx, without a build step. Useful when iterating on tool definitions.

Example Claude Desktop config

{
  "mcpServers": {
    "edgaralert": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "EDGARALERT_API_KEY": "EA_your_key_here"
      }
    }
  }
}

Replace /absolute/path/to/mcp-server/dist/index.js with the real path on your machine, and EAyourkey_here with your actual EDGAR Alert API key. Never commit this file with a real key in it.

Environment variables

Shortened. The full README is on GitHub.