🐋 wm-mcp — Whales Market MCP Server

MCP server for Whales Market — the OTC trading platform for pre-market tokens, points, and allocations.

Query market data, token prices, offers, trades, and wallet info directly from your AI assistant.

Quick Install

Claude Code

claude mcp add whales-market -- npx -y @whalesmarket/mcp

Cursor

Settings → MCP Servers → Add new MCP Server:

{
  "mcpServers": {
    "whales-market": {
      "command": "npx",
      "args": ["-y", "@whalesmarket/mcp"]
    }
  }
}

Claude Desktop

Settings → Developer → Edit Config (claude_desktop_config.json):

{
  "mcpServers": {
    "whales-market": {
      "command": "npx",
      "args": ["-y", "@whalesmarket/mcp"]
    }
  }
}

Windsurf

Cascade → MCP → Configure (mcp_config.json):

{
  "mcpServers": {
    "whales-market": {
      "command": "npx",
      "args": ["-y", "@whalesmarket/mcp"]
    }
  }
}

VS Code (Copilot)

Add to .vscode/settings.json:

{
  "mcp": {
    "servers": {
      "whales-market": {
        "command": "npx",
        "args": ["-y", "@whalesmarket/mcp"]
      }
    }
  }
}

HTTP (Remote / Self-hosted)

# Docker
docker run -p 3000:3000 ghcr.io/bigbearman/wm-mcp

# Or manually
MCP_HTTP_PORT=3000 npx -y @whalesmarket/mcp

Endpoints:

• POST /mcp — JSON-RPC requests
• GET /mcp — SSE stream
• DELETE /mcp — Session termination
• GET /health — Health check

Available Tools

| Tool | Description | |------|-------------| | search_tokens | Search/list tokens with filters (category, chain, sort) | | get_token_detail | Detailed info for a token by symbol | | get_token_chart | Historical price chart data | | get_offers | Buy/sell offers with filters | | get_recent_trades | Recent trades across all markets | | get_market_stats | Overall market statistics | | get_wallet_info | Wallet info, tier, and discount | | get_orders_by_address | All orders for a wallet address | | get_upcoming_tokens | Upcoming tokens list | | get_leaderboard | Referral leaderboard + live stats |

Usage Examples

Once connected, ask your AI assistant:

• "Search for pre-market tokens on Whales Market"
• "What's the current price of HYPE?"
• "Show me recent trades"
• "Get market statistics"
• "Show buy offers for token X"
• "What tokens are coming soon?"

Configuration

| Variable | Description | Default | |----------|-------------|---------| | WM_API_URL | Whales Market API base URL | https://api.whales.market | | WM_AUTH_TOKEN | Bearer token for authenticated endpoints | (optional) | | MCP_HTTP_PORT | Enable HTTP transport (e.g., 3000) | (stdio) | | MCP_HTTP_HOST | Bind address for HTTP mode | 0.0.0.0 |

Development

git clone https://github.com/bigbearman/wm-mcp.git
cd wm-mcp
npm install
npm run dev       # Dev mode with hot reload
npm run build     # Compile TypeScript
npm run inspect   # MCP Inspector for debugging

License

MIT — Whales Market