npm package: @0xinsider/mcp
Description: MCP server for 0xinsider — prediction market intelligence for AI agents
Author: 0xinsider
Latest version: 1.0.0

# @0xinsider/mcp

MCP server for [0xinsider](https://0xinsider.com) — prediction market intelligence for AI agents.

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

## Quick Start

### Claude Code

```bash
npx -y @0xinsider/mcp init
```

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

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

### Cursor

Add to `~/.cursor/mcp.json`:

```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`:

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

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

### Other MCP Clients

Any client that supports stdio transport:

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

Need the command list? Run:

```bash
npx -y @0xinsider/mcp --help
```

## API Key

Get your API key at [0xinsider.com/developers](https://0xinsider.com/developers). Requires an Insider subscription.

## Tools

| Tool | Description |
|------|-------------|
| `get_trader` | Look up a trader by wallet address — grade, P&L, win rate, strategy, quant metrics |
| `get_whale_trades` | Recent large trades with signal scoring, filterable by size/category/grade |
| `get_leaderboard` | Top-ranked traders (S/A/B grades) with optional category/strategy filters |
| `search_markets` | Search prediction markets by keyword |
| `get_market_intel` | Smart money flow analysis for a specific market |
| `get_insider_radar` | Suspicious trading pattern detection |

## 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?"
- "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