Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.0xinsider.com/llms.txt

Use this file to discover all available pages before exploring further.

@0xinsider/mcp is the official local Model Context Protocol server. It exposes the same intelligence as the REST API — trader grades, whale trades, smart-money flow, positions, insider detection — as MCP tools your agent can call directly. Works with Claude Code, Cursor, Codex, Gemini CLI, and any client that speaks stdio MCP.
Need a hosted HTTP endpoint instead of a local subprocess? See Remote MCP.

Install — one command

npx -y @0xinsider/mcp init
init auto-detects which clients you have installed and writes the right config block in the right place. You will be asked for your API key once. If you prefer to edit configs by hand, the per-client paths and snippets are below.

Manual install per client

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

What the server exposes

Tools (read-only)

ToolWhat it does
get_traderWallet profile — grade, P&L, win rate, strategy, category strengths.
get_whale_tradesRecent large trades, filterable by size, category, grade.
get_leaderboardTop-ranked traders (S/A/B) with optional category/strategy filter.
get_positionsCurrent positions across traders or markets.
get_position_timelinePer-market trader fills with running amount and average entry price.
search_marketsKeyword search across prediction markets.
explore_marketsBrowse whale-active markets by category, platform, status.
get_market_intelSmart-money breakdown for a single market.
get_insider_radarSuspicious accumulation and timing patterns.
All tools advertise readOnlyHint: true. The server cannot place trades or write data.

Resources (auto-attached context)

URIWhat you get
oxinsider://docs/apiFull API reference, ready for the model to read.
oxinsider://docs/agentsDecision tree for agents — when to use which tool.
oxinsider://data/leaderboardLive top 20 traders.
oxinsider://data/whale-tradesLive latest 20 whale trades.

Prompts (one-shot templates)

PromptUse when
analyze_traderYou want a full breakdown of a specific wallet.
market_reportYou want smart-money flow on a market topic.
trading_signalsYou want a scan for high-conviction signals across markets.

Try it

After install, ask your agent things like:
  • “Who are the top prediction-market traders right now?”
  • “What are A-grade or better whales buying in crypto markets today?”
  • “Analyze trader 0x863134d00841b2e200492805a01e1e2f5defaa53 — is their strategy worth following?”
  • “Are there suspicious accumulation patterns on the Trump election market?”
  • “Show me the position timeline for that whale on the Ethereum market.”
The agent will pick the right tool and call it for you.

Environment variables

VariableRequiredWhat it controls
OXINSIDER_API_KEYYesYour API key (oxi_sk_live_...).
OXINSIDER_API_URLNoOverride the base URL (mostly for self-hosted dev).
The MCP server uses your normal API key and shares the 100 req/min rate limit with direct API access. One key, one budget. Get yours at 0xinsider.com/developers.