Insider trading MCP server

Connect a client

Add this to your MCP client configuration and restart it. There is no key field because there is no key.

{
  "mcpServers": {
    "tracefour": {
      "type": "http",
      "url": "https://tracefour.com/v1/mcp"
    }
  }
}

In Claude Code, the equivalent one-liner:

claude mcp add --transport http tracefour https://tracefour.com/v1/mcp

Anonymous callers get 60 requests per hour per IP. If you already have a free Tracefour API key, send it as Authorization: Bearer tf_YOUR_KEY and the limit becomes 600 per hour. The key is forwarded to the underlying REST endpoint unchanged.

A worked example

The interesting part of this server is what an agent has to do before it can answer anything about a named person: resolve the name to a slug. Insider slugs are EDGAR name order, surname first, so a model that constructs one from a common name will get a 404 every time.

# A model is asked: "What has NVIDIA's CEO filed recently?"
# It cannot guess the slug, so it searches first, then reads.

# 1. Orient. Every slug the server knows, in one call.
{"jsonrpc":"2.0","id":1,"method":"tools/call",
 "params":{"name":"get_catalog","arguments":{}}}

# 2. Resolve the person. "jensen huang" is not a slug; "huang" finds one.
{"jsonrpc":"2.0","id":2,"method":"tools/call",
 "params":{"name":"search_insiders","arguments":{"q":"huang","limit":3}}}
# -> huang-jen-hsun, tickers ["NVDA"]

# 3. Read the filings for that slug.
{"jsonrpc":"2.0","id":3,"method":"tools/call",
 "params":{"name":"get_insider","arguments":{"id":"huang-jen-hsun"}}}

# 4. Or go the other way: everything NVDA insiders bought this quarter.
{"jsonrpc":"2.0","id":4,"method":"tools/call",
 "params":{"name":"get_latest_filings",
           "arguments":{"ticker":"NVDA","direction":"P","since":"2026-04-01"}}}

Transcripts

Every block below was captured by POSTing to a running server. Step 2 of the worked example, sent as plain curl:

curl -X POST "https://tracefour.com/v1/mcp" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_insiders","arguments":{"q":"huang","limit":2}}}'

{
  "id": 3,
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"data\":[{\"slug\":\"chuang-tzu-sou\",\"name\":\"Chuang Tzu-Sou\",\"tickers\":[\"TSM\"],\"lastSeen\":\"2026-06-24T10:43:03.000Z\"},{\"slug\":\"huang-jen-hsun\",\"name\":\"HUANG JEN HSUN\",\"tickers\":[\"NVDA\"],\"lastSeen\":\"2026-06-23T10:00:38.000Z\"}],\"meta\":{...}}"
      }
    ]
  }
}

{
  "id": 2,
  "jsonrpc": "2.0",
  "result": {
    "tools": [
      {
        "name": "search_insiders",
        "description": "Find a corporate insider by name. Returns matching slugs for use with get_insider. Insider slugs are EDGAR name-order and cannot be guessed from a person name.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "q": { "type": "string", "description": "Name fragment, e.g. huang." },
            "limit": { "type": "number", "description": "1-100, default 20." }
          },
          "required": ["q"]
        }
      }
    ]
  }
}

{
  "id": 4,
  "jsonrpc": "2.0",
  "result": {
    "content": [
      { "type": "text", "text": "HTTP 404: Member not found." }
    ],
    "isError": true
  }
}