nero-form4-mcp

An MCP server that gives AI agents authoritative, parse-validated SEC Form-4 insider-trade data via Nero. Thin stdio adapter over the hosted Nero REST API — exact integer-cents money math, Form 4/A amendments flagged as separate filings (not auto-superseded), fail-closed nulls (a value that can't be read is null + listed in warnings, never silently guessed).

Tool

get_recent_form4_filings({ ticker?, cik?, limit? }) — recent Form-4 filings for ONE issuer (trailing 30 days by filing date). Provide exactly one of ticker (e.g. AAPL, BRK.B) or cik (e.g. 320193); limit 1–20 (default 5). Returns the typed Nero payload (query, count, filings[], errors[], truncated) in structuredContent.

Setup

You need a RapidAPI key subscribed to the Nero API (free tier available). Add to your MCP client config:

{
  "mcpServers": {
    "nero-form4": {
      "command": "npx",
      "args": ["-y", "nero-form4-mcp"],
      "env": { "RAPIDAPI_KEY": "your-rapidapi-key" }
    }
  }
}

• RAPIDAPI_KEY (required) — your RapidAPI consumer key. Never hardcoded; read from the env only.
• NERO_RAPIDAPI_HOST (optional) — defaults to the Nero RapidAPI host.

The key is sent as the X-RapidAPI-Key header (never in a URL/log). The gateway↔origin secret is not part of this package. All diagnostics go to stderr (stdout is the JSON-RPC channel).

Develop

npm install
npm run typecheck
npm test        # protocol + behavior tests against a local mock upstream (no key needed)
npm run build   # -> dist/ for publish

MIT-style; not affiliated with the SEC. Data: public SEC EDGAR via Nero.