Hyperbot Trading Analytics

1. Overview

MCP Server Skill Documentation

Version: 1.0.0

Quick Start for Agents

This MCP server provides cryptocurrency trading analytics tools. To use these tools:

1. Connect via SSE: https://mcp.hyperbot.network/mcp/sse
2. Send requests to: https://mcp.hyperbot.network/mcp/message?sessionId={your-session-id}
3. Protocol: JSON-RPC 2.0

Available Tool Categories:

• Smart Money & Leaderboard: fetch_leader_board, find_smart_money
• Market Data: get_tickers, get_ticker, get_klines, get_market_stats, get_l2_order_book
• Whale Monitoring: get_whale_positions, get_whale_events, get_whale_directions, get_whale_history_ratio
• Trader Analysis: fetch_trade_history, get_trader_stats, get_max_drawdown, get_best_trades, get_performance_by_coin
• Position History: get_completed_position_history, get_current_position_history, get_completed_position_executions, get_current_position_pnl
• Batch Queries: get_traders_accounts, get_traders_statistics

---

2. MCP Server Installation

2.1 For Cursor Users

Add the following configuration to your Cursor MCP settings:

Method 1: Via UI

• Open Cursor Settings → Tools & MCP → Add New MCP Server
• Name: hyperbot-trading
• Type: sse
• URL: https://mcp.hyperbot.network/mcp/sse

Method 2: Edit config file directly

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "hyperbot-trading": {
      "type": "sse",
      "url": "https://mcp.hyperbot.network/mcp/sse"
    }
  }
}

After configuration: Restart Cursor to apply changes.

---

2.2 For Claude Desktop Users

Important: Claude Desktop requires mcp-remote to connect to remote SSE servers. Make sure you have Node.js installed.

Configuration File Locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "hyperbot-trading": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.hyperbot.network/mcp/sse"]
    }
  }
}

Setup Steps:

1. Open Claude Desktop → Settings → Developer → Edit Config
2. Add the configuration above
3. Save and restart Claude Desktop (Cmd/Ctrl + R)
4. Verify the tools appear in your MCP tools list

Prerequisite: Node.js 18+ must be installed. Install via:

• macOS: brew install node
• Windows: Download from https://nodejs.org/

---

2.3 For OpenClaw Users

Add the following configuration to your OpenClaw MCP settings:

Method 1: Via UI

• Open Settings → MCP → Add Server
• Name: hyperbot-trading
• URL: https://mcp.hyperbot.network/mcp/sse

Method 2: Edit config file

{
  "mcpServers": {
    "hyperbot-trading": {
      "type": "sse",
      "url": "https://mcp.hyperbot.network/mcp/sse"
    }
  }
}

After configuration: Restart OpenClaw to apply changes.

---

2.4 For Linux Users

Configuration File Locations:

Client	Config Path
Cursor	~/.cursor/mcp.json
Claude Desktop (AppImage)	~/.config/Claude/claude_desktop_config.json
Claude Desktop (Snap)	~/.local/share/Claude/claude_desktop_config.json

Quick Setup - Cursor on Linux:

mkdir -p ~/.cursor
cat > ~/.cursor/mcp.json << 'EOF'
{
  "mcpServers": {
    "hyperbot-trading": {
      "type": "sse",
      "url": "https://mcp.hyperbot.network/mcp/sse"
    }
  }
}
EOF

Quick Setup - Claude Desktop on Linux:

# Ensure Node.js is installed
sudo apt install nodejs npm  # Debian/Ubuntu
# or
sudo dnf install nodejs npm  # Fedora

# For AppImage installation
mkdir -p ~/.config/Claude
cat > ~/.config/Claude/claude_desktop_config.json << 'EOF'
{
  "mcpServers": {
    "hyperbot-trading": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.hyperbot.network/mcp/sse"]
    }
  }
}
EOF

---

2.5 For Other MCP Clients

Connection Endpoints:

Endpoint Type	URL
SSE Endpoint	https://mcp.hyperbot.network/mcp/sse
Message Endpoint	https://mcp.hyperbot.network/mcp/message

For clients supporting direct SSE URL:

{
  "type": "sse",
  "url": "https://mcp.hyperbot.network/mcp/sse"
}

For clients requiring mcp-remote (like Claude Desktop):

{
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://mcp.hyperbot.network/mcp/sse"]
}

---

2.6 Verification

After installation, verify the connection by checking if these tools are available in your MCP client:

Core Tools:

• fetch_leader_board - Smart money leaderboard
• find_smart_money - Discover smart money addresses
• get_tickers / get_ticker / get_klines - Market data
• get_whale_positions / get_whale_events - Whale monitoring
• get_trader_stats / get_performance_by_coin - Trader analysis

Troubleshooting:

Issue	Solution
Tools not appearing	Restart your MCP client
Connection timeout	Check network/firewall settings
Claude Desktop error	Ensure Node.js 18+ is installed
"mcp-remote not found"	Run npm install -g mcp-remote

---

3. Resources

3.1 Defined Resources

None

Usage Notes:

• Read-only resources that do not change system state
• Can be used as prompt input or for Agent decision-making reference
• Data sourced from Hyperbot platform and on-chain data
• Supports on-demand retrieval (pagination/filtering conditions)

---

4. Tools

How to Call Tools: Use JSON-RPC 2.0 format. First obtain a sessionId via SSE connection to https://mcp.hyperbot.network/mcp/sse, then send requests to https://mcp.hyperbot.network/mcp/message?sessionId={sessionId}.

4.1 Leaderboard & Smart Money Discovery

fetch_leader_board

Function: Get Hyperbot smart money leaderboard
Parameters:

• period: Time period, options: 24h, 7d, 30d
• sort: Sort field, options: pnl (profit/loss), winRate (win rate)

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"fetch_leader_board","arguments":{"period":"7d","sort":"pnl"}},"jsonrpc":"2.0","id":1}'

find_smart_money

Function: Discover smart money addresses with multiple sorting and filtering options
Parameters:

• period: Period in days, e.g., 7 means last 7 days
• sort: Sorting method, options: win-rate, account-balance, ROI, pnl, position-count, profit-count, last-operation, avg-holding-period, current-position
• pnlList: Whether to include PnL curve data (true/false)

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"find_smart_money","arguments":{"period":7,"sort":"win-rate","pnlList":true}},"jsonrpc":"2.0","id":2}'

---

4.2 Market Data

get_tickers

Function: Get latest trading prices for all markets
Parameters: None

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_tickers","arguments":{}},"jsonrpc":"2.0","id":3}'

get_ticker

Function: Get latest trading price for a specific coin
Parameters:

• address: Coin code, e.g., btc, eth, sol

MCP Tool Call Example:

curl 'https://mcp.hyperbot.network/mcp/message?sessionId=sessionId obtained via sse' \
  -H 'content-type: application/json' \
  --data-raw '{"method":"tools/call","params":{"name":"get_ticker","arguments":{"address":"ETH"}},"jsonrpc":"2.0","id":4}'