Skip to main content
Glama
Sign In
x402-insider-mcp

x402-insider-mcp

by amgiiine
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

x402-insider-mcp

MCP (Model Context Protocol) server exposing SEC Form 4 insider-trading data as tools, backed by a live x402 pay-per-call API.

What it is

  • 3 tools: search_insider_trades(ticker, limit), top_insiders(days), owner_history(name).

  • Each returns free preview rows (max 3) straight from the API.

  • Full result sets require x402 payment — the wrapper never signs or holds payments. Payments: x402 scheme=exact, USDC on Base, $0.02/call raw endpoints, payTo 0xcC3c1E564fF534CD1913f19dB3880cAb44563AE3 (receive-only). See https://x402.org

  • Dataset: SEC EDGAR Form 4 insider transactions, 2025Q4–2026Q1 (~5,000 rows preview set).

Related MCP server: sec-edgar-mcp

NEW: derived signal endpoints on the upstream API ($0.05/call)

The backing API now sells derived signals, not just raw rows (added 2026-09-13):

  • GET /signals/cluster?ticker=&days= — insider cluster-buy detection (≥3 unique insiders buying open-market at one issuer within the window; conviction-scored).

  • GET /signals/momentum?days=[&ending_at=YYYY-MM-DD] — issuers with accelerating insider buying (2 consecutive up-weeks + volume z-score); ending_at re-anchors for backtesting. Both: free 1-line preview without payment, full results $0.05/call via the same x402 flow (X-PAYMENT header, Coinbase facilitator). These are plain HTTP endpoints — call them from any x402 client, or wire them into your own MCP tools.

Run (no Docker needed)

./run.sh            # stdio MCP server; point your MCP client at it

Requires Python 3.8+, stdlib only. Requires network access to the API host.

API endpoint

Currently CT-local: http://127.0.0.1:8790 (set X402_API_URL to override). Public URL rotates (Cloudflare quick tunnel) — see the fleet lead for the current one.

Honest limits

  • Preview rows are capped at 3 by the upstream API by design (that is the free tier).

  • No payment logic in this repo: bring your own x402 client to pay for full rows.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • shareseer-mcp

      shareseer-mcpofficial

      shareseer
      A
      license
      Not graded
      quality
      C
      maintenance
      ShareSeer provides: SEC filings data (10-K, 10-Q, 8-K forms) & related financials Insider trading transaction data per company Largest insider purchases & Sales in a day and week Integration: Remote MCP server (https://shareseer.com/mcp)
      9
      MIT

    • sec-edgar-mcp

      guptaprakhariitr
      A
      license
      Not graded
      quality
      D
      maintenance
      Hosted MCP server that gives AI agents real-time access to SEC EDGAR filings search, 10-K/8-K reading, XBRL financial facts, and insider-trade (Form 4) alerts.
      13 npm
      1
      MIT

    • headless-records-mcp

      jgmcalpine
      A
      license
      B
      quality
      D
      maintenance
      Enables MCP agents to access public SEC Form 4 insider filing data via a local API wrapper, supporting tools for assessing insider activity, checking data freshness, and retrieving filing provenance without providing financial advice.
      3
      MIT

    • form4api-mcp

      theodor90
      A
      license
      A
      quality
      B
      maintenance
      Real-time SEC Form 4 insider trading data — transactions with post-trade returns, cluster-buy signals, Form 144 early warnings, and 13F institutional holdings. 27 tools + 6 research prompts; free tier available.
      38
      125 npm
      2
      MIT