0xinsider local MCP server

@0xinsider/mcp runs a local Model Context Protocol server over stdio. Use it when Claude Code, Cursor, Codex, Gemini CLI, or another stdio client needs 0xinsider data.

A hosted agent that cannot run a local process can use Remote MCP at POST /api/v1/mcp instead. Both transports expose the same 33 tools and share the same rate limits.

Install with init

npx -y @0xinsider/mcp init

init detects Claude Code (~/.claude/settings.json), Cursor (~/.cursor/mcp.json), and Codex (~/.codex/config.toml) and writes their config.
For Gemini CLI it prints a config template to paste into ~/.gemini/settings.json.
It reads the API key from the terminal without an echo.
For a non-interactive run, set OXINSIDER_API_KEY in the environment or pipe the key on stdin.

Do not pass the key as a command-line argument. Shell history records arguments. If an older version wrote the key to recorded terminal output, rotate the key before you use the new config.

For a stable terminal command, install the package globally:

npm install --global @0xinsider/mcp
0xinsider --help

The package installs 0xinsider and the alias 0xinsider-mcp. Both run the same CLI. The commands are serve (the default), init, and help.

Configure a client by hand

Claude Code
Cursor
Codex
Gemini CLI
Other clients

~/.claude/settings.json

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

~/.cursor/mcp.json. Restart Cursor after you save.

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

~/.codex/config.toml

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

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

~/.gemini/settings.json

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

Any stdio MCP client works. Set the key in the process environment, then start the server:

OXINSIDER_API_KEY=oxi_sk_live_... npx -y @0xinsider/mcp

Use the tools

The server exposes 33 read-only tools from the same catalog as Remote MCP. It cannot place trades or write data.

Group	Tools
Traders	`get_trader`, `batch_get_traders`, `get_leaderboard`, `get_trending_wallets`, `get_trader_pnl`, `get_positions`, `get_position_timeline`, `get_position_timeline_by_id`, `get_trader_export_snapshot`
Whale activity	`get_whale_trades`, `get_whale_trade`, `get_whale_trades_history`, `get_event_replay_since`
Markets	`search_markets`, `explore_markets`, `get_market_intel`, `batch_get_market_intel`, `get_market_snapshot`, `get_sharp_money_flows`, `get_smart_money_flows`, `get_large_positions`
Insider radar	`get_insider_radar`, `get_insider_radar_flag`
Reports	`get_report`, `get_daily_report_snapshot`, `get_weekly_report_snapshot`, `get_monthly_report_snapshot`
Webhooks	`list_webhooks`, `get_webhook`
Content and platforms	`search_content`, `get_platforms`
Picks	`get_pick_of_the_day`, `get_pick_of_the_day_archive`

get_smart_money_flows is a deprecated alias of get_sharp_money_flows. Webhook create, update, delete, verify, and rotate operations are not tools.

Use the resources and prompts

The stdio server also serves four resources and three prompts. Remote MCP serves tools only.

Resource	Content
`oxinsider://docs/api`	The full API reference.
`oxinsider://docs/agents`	The decision tree for agents: which tool to call when.
`oxinsider://data/leaderboard`	The current top 20 traders.
`oxinsider://data/whale-trades`	The latest 20 whale trades.

Prompt	Use it for
`analyze_trader`	A full breakdown of one wallet.
`market_report`	A smart-money flow report on a market topic.
`trading_signals`	A scan for high-conviction signals across markets.

Ask a question

After install, ask a task-specific question. The client picks the tool.

“Who are the top prediction-market traders right now?”
“What did A-grade or better whales buy in crypto markets today?”
“Analyze trader swisstony. Is their strategy worth a follow?”
“Are there suspicious accumulation patterns on the Trump election market?”
“Show the position timeline for that whale on the Ethereum market.”

Set environment variables

Variable	Required	Meaning
`OXINSIDER_API_KEY`	Yes	The API key (`oxi_sk_live_...`).
`OXINSIDER_API_URL`	No	The API base URL. Default `https://api.0xinsider.com`.

The server sends the key with every call. Tool calls spend the same 100 requests per minute as REST calls. See Rate Limits. Remote MCP documents the Streamable HTTP transport, the initialize handshake, and Mcp-Session-Id.

Getting Started

Guides

Concepts

0xinsider local MCP server

Install with init

Configure a client by hand

Use the tools

Use the resources and prompts

Ask a question

Set environment variables

​Install with init

​Configure a client by hand

​Use the tools

​Use the resources and prompts

​Ask a question

​Set environment variables

​Related

Install with init

Configure a client by hand

Use the tools

Use the resources and prompts

Ask a question

Set environment variables

Related