@0xinsider/mcp

MCP server for 0xinsider — prediction market intelligence for AI agents.

Gives your AI agent access to trader grades, whale trades, smart money signals, market intelligence, and insider-radar flags across prediction markets.

Two ways to connect

• Remote HTTP (no install) — POST https://api.0xinsider.com/api/v1/mcp with Authorization: Bearer oxi_sk_live_.... Implements the MCP Streamable HTTP transport (protocolVersion 2025-11-25). Works with MCP clients that speak HTTP and can send headers. ?token= remains a legacy URL-only compatibility path, but prefer headers because URL secrets can leak through shell history, browser history, proxy logs, and crash reports. 31 read-only public V1 tools -- the 29 the stdio server exposes plus the remote-only get_report and search_content -- same rate limits, same billing.
• Stdio (this npm package) — run npx -y @0xinsider/mcp locally for Claude Code / Cursor / Codex / Gemini CLI. Best when the client can launch a child process and you prefer to keep the API key out of URLs.

The stdio server exposes these 29 read-only tools (the remote HTTP endpoint additionally exposes the remote-only get_report and search_content, 31 total): get_leaderboard, get_trader, batch_get_traders, get_whale_trades, get_whale_trade, get_whale_trades_history, get_market_intel, batch_get_market_intel, get_smart_money_flows, get_sharp_money_flows, get_market_snapshot, get_insider_radar, get_insider_radar_flag, get_positions, get_position_timeline, get_position_timeline_by_id, search_markets, explore_markets, get_event_replay_since, list_webhooks, get_webhook, get_daily_report_snapshot, get_weekly_report_snapshot, get_monthly_report_snapshot, get_trader_export_snapshot, get_platforms, get_large_positions, get_trending_wallets, get_trader_pnl.

Quick Start

Claude Code

npx -y @0xinsider/mcp init

init reads the key without echoing it. For non-interactive setup, set OXINSIDER_API_KEY in the process environment or pipe the key on stdin. Do not pass the key as a command-line argument.

Or manually add to ~/.claude/settings.json:

{
  "mcpServers": {
    "0xinsider": {
      "command": "npx",
      "args": ["-y", "@0xinsider/mcp"],
      "env": {
        "OXINSIDER_API_KEY": "oxi_sk_live_..."
      }
    }
  }
}

Cursor

npx -y @0xinsider/mcp init can also configure Cursor automatically when its local config directory is present.

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "0xinsider": {
      "command": "npx",
      "args": ["-y", "@0xinsider/mcp"],
      "env": {
        "OXINSIDER_API_KEY": "oxi_sk_live_..."
      }
    }
  }
}

Codex

npx -y @0xinsider/mcp init can also configure Codex automatically.

Or add this to ~/.codex/config.toml:

[mcp_servers."0xinsider"]
command = "npx"
args = ["-y", "@0xinsider/mcp"]

[mcp_servers."0xinsider".env]
OXINSIDER_API_KEY = "oxi_sk_live_..."

Gemini CLI

npx -y @0xinsider/mcp init detects Gemini CLI when the gemini command is installed and prints a manual config template.

Or add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "0xinsider": {
      "command": "npx",
      "args": ["-y", "@0xinsider/mcp"],
      "env": {
        "OXINSIDER_API_KEY": "oxi_sk_live_..."
      }
    }
  }
}

Other MCP Clients

Any client that supports stdio transport:

Set OXINSIDER_API_KEY in the process environment before starting the stdio server. Do not pass the key as a command-line argument.

Need the command list? Run:

npx -y @0xinsider/mcp --help

API Key

Get your API key at 0xinsider.com/developers. Requires a Pro subscription.

Security

init never prints the API key. If an older version wrote the key to recorded terminal output, rotate the key before you use the new configuration.

Tools

| Tool | Description | |------|-------------| | get_trader | Look up a trader by wallet address or username — grade, P&L, win rate, strategy, quant metrics | | batch_get_traders | Look up 1-25 traders in one call with per-item results and batch-item quota | | get_whale_trades | Recent large trades with signal scoring, filterable by size/category/grade | | get_whale_trade | Read one whale trade by wt_ ID or raw whale_alerts.id | | get_whale_trades_history | Replay historical whale trades with cursor, market, trader, category, grade, platform, and time filters | | get_leaderboard | Top-ranked traders (S/A/B grades) with optional category/strategy filters | | search_markets | Search prediction markets by keyword | | explore_markets | Browse whale-active markets with facets and grouped discovery entries | | get_market_intel | Smart money flow analysis for a specific market | | batch_get_market_intel | Fetch market intelligence for 1-25 condition IDs in one call | | get_smart_money_flows | Deprecated alias of get_sharp_money_flows (byte-identical); kept for backward compatibility | | get_sharp_money_flows | Ranked sharp-money flow discovery across markets (timeframe, category, platform, min-grade, direction filters) | | get_market_snapshot | Live market-card snapshot with outcomes, liquidity, sports context, and freshness state | | get_positions | Current positions with trader, market, value, side, P&L, and freshness context | | get_position_timeline | Per-market trader fills with running amount and average entry price | | get_position_timeline_by_id | Per-market trader fills using an internal trader ID alias | | get_insider_radar | Suspicious trading pattern flags | | get_insider_radar_flag | Read one insider-radar flag by rf_ ID or raw radar_flags.id | | get_event_replay_since | Durable public event replay after an opaque cursor | | list_webhooks | Read webhook endpoints owned by the authenticated API-key user | | get_webhook | Read one webhook endpoint by ID | | get_daily_report_snapshot | Read a dated daily whale-activity report snapshot | | get_weekly_report_snapshot | Read a weekly whale-activity report snapshot by week token or date range | | get_monthly_report_snapshot | Read a monthly whale-activity report snapshot | | get_trader_export_snapshot | Read trader export metadata without starting an export job | | get_platforms | Provider capability matrix: which platforms support grade, P&L, strategy, timeline, whale signal, insider radar, and market snapshot |

Resources

| Resource | URI | Description | |----------|-----|-------------| | API Docs | oxinsider://docs/api | Complete API reference | | Agent Instructions | oxinsider://docs/agents | Decision tree for AI agents | | Leaderboard | oxinsider://data/leaderboard | Current top 20 traders | | Whale Trades | oxinsider://data/whale-trades | Latest 20 whale trades |

Prompts

| Prompt | Description | |--------|-------------| | analyze_trader | Deep analysis of a trader's performance and risk profile | | market_report | Smart money flow report for a market topic | | trading_signals | Scan for high-conviction trading signals |

Example Usage

Once configured, ask your AI agent:

• "Who are the top prediction market traders right now?"
• "What are whales buying in crypto markets?"
• "Analyze trader 0x1234... — is their strategy worth following?"
• "Analyze trader swisstony — is their strategy worth following?"
• "Are there any suspicious trading patterns on the Trump election market?"
• "Generate a smart money report for AI markets"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | OXINSIDER_API_KEY | Yes | Your API key (oxi_sk_live_...) | | OXINSIDER_API_URL | No | Override API base URL (default: https://api.0xinsider.com) |

Rate Limits

100 requests per minute per user. The server returns actionable error messages when limits are hit.

License

MIT