English Français العربية

SEC EDGAR Insider Trades & Financials

Official registry Search and web

SEC EDGAR for agents: Form 4 insider trades, cluster buys, filings, XBRL financials and search.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http sec-edgar-insider-trades-financials 'https://sec-edgar-api.kidriahx.workers.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "sec-edgar-insider-trades-financials": {
            "type": "http",
            "url": "https://sec-edgar-api.kidriahx.workers.dev/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. SEC EDGAR MCP (remote)
  2. Tools
  3. Connect a client
  4. REST endpoints
  5. Run locally
  6. Deploy your own (Cloudflare Workers Free)
  7. Project layout
  8. License

SEC EDGAR MCP (remote)

A remote Model Context Protocol server and JSON API for U.S. SEC EDGAR data, running on Cloudflare Workers. It gives AI agents Form 4 insider trades, market-wide cluster buys, company filings, XBRL financials and EDGAR full-text search as compact JSON, with no XML parsing or CIK lookups needed.

  • Remote MCP endpoint (Streamable HTTP, stateless): https://sec-edgar-api.kidriahx.workers.dev/mcp
  • Server card: https://sec-edgar-api.kidriahx.workers.dev/.well-known/mcp/server-card.json
  • REST API spec: https://sec-edgar-api.kidriahx.workers.dev/openapi.yaml
  • MCP Registry name: io.github.monriah-studio/sec-edgar-mcp

Data comes straight from SEC EDGAR (public domain) under SEC fair-access rules: a declared User-Agent, a global rate limit of about 8.7 req/s (under SEC's 10 req/s) and caching. Not affiliated with the SEC. Not investment advice.

Tools

ToolWhat it returns
get_insider_tradesForm 4 transactions for a company (ticker/CIK) or an insider (reporting-owner CIK): who bought or sold, role, shares, price, dollar value, 10b5-1 flag and filing link, with buy/sell totals.
get_market_insider_buysOpen-market insider purchases across the whole market, grouped by company, with cluster-buy detection (2+ insiders).
get_company_filingsLatest 10-K, 10-Q, 8-K (with item numbers), S-1, proxy and other filings, with direct document links.
get_company_snapshotRevenue, margins, net income, EPS, cash flow, balance sheet and debt, with YoY growth, from XBRL.
get_company_conceptAnnual or quarterly history of any XBRL tag (e.g. NetIncomeLoss, Revenues).
search_filingsEDGAR full-text search with phrase, form and date filters.
resolve_companyTicker ↔ CIK lookup.

Connect a client

Any MCP client that supports Streamable HTTP can use the URL directly. For example:

{
  "mcpServers": {
    "sec-edgar": {
      "type": "http",
      "url": "https://sec-edgar-api.kidriahx.workers.dev/mcp"
    }
  }
}

If the operator has set MCP_API_KEYS, send a key as Authorization: Bearer <key>, X-API-Key: <key> or ?api_key=<key>.

Example prompts:

  • "Which companies had cluster insider buying (2+ insiders) in the last 30 days?"
  • "Show NVIDIA's last 10 insider sales and whether they were under 10b5-1 plans."
  • "Compare Apple's revenue, net margin and debt-to-equity with last year."
  • "Find 8-K filings this year that mention 'share repurchase'."

REST endpoints

The same Worker also serves a REST API (see openapi.yaml): /v1/insider-trades/{tickerOrCik}, /v1/insider-buys, /v1/filings/{tickerOrCik}, /v1/company/{tickerOrCik}/snapshot, /v1/company/{tickerOrCik}/facts, /v1/company/{tickerOrCik}/concept/{taxonomy}/{tag}, /v1/search, /v1/resolve/{tickerOrCik}, plus /health.

Run locally

Requires Node.js 18+. No Cloudflare account is needed for local dev.

npm install
npx wrangler dev --test-scheduled          # serves http://localhost:8787 (MCP at /mcp)
node test/unit.mjs                         # unit tests
node test/harness.mjs http://localhost:8787   # REST against live EDGAR
node test/mcp.mjs http://localhost:8787       # MCP: lists tools and calls each one
curl "localhost:8787/__scheduled?cron=*/10+*+*+*+*"   # run the insider-buy cron once

Optional local secrets go in .dev.vars (git-ignored; see .dev.vars.example).

Deploy your own (Cloudflare Workers Free)

  1. npx wrangler login
  2. npx wrangler kv namespace create CACHE, then put the printed id in wrangler.toml ([[kv_namespaces]]).
  3. Set SEC_USER_AGENT in wrangler.toml to your own name and a monitored email (SEC fair-access requirement).
  4. npx wrangler deploy
  5. Optional: npx wrangler secret put MCP_API_KEYS (protects /mcp) and npx wrangler secret put RAPIDAPI_PROXY_SECRET (protects REST).

The Durable Object rate limiter (SecRateLimiter) and the */10 * * * * cron are created automatically.

Project layout

  • src/index.js: router and REST endpoints
  • src/sec.js: SEC client, global rate limiter (Durable Object), caching
  • src/form4.js: Form 4 XML parser
  • src/mcp/: MCP server (tools.js defines the 7 tools)
  • test/: unit tests, live harness, MCP test and sample responses
  • server.json: MCP Registry metadata

License

MIT © 2026 MonRiah Studio. See LICENSE.

Frequently asked questions

What is SEC EDGAR Insider Trades & Financials?

SEC EDGAR for agents: Form 4 insider trades, cluster buys, filings, XBRL financials and search.

How do I install SEC EDGAR Insider Trades & Financials?

It runs as a remote server. In Claude Code: claude mcp add --transport http sec-edgar-insider-trades-financials 'https://sec-edgar-api.kidriahx.workers.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does SEC EDGAR Insider Trades & Financials need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is SEC EDGAR Insider Trades & Financials open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains SEC EDGAR Insider Trades & Financials?

It is published by monriah-studio. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.