vooi-mcp

MCP server for perpetual futures trading on Hyperliquid, Lighter, Aster, trade.xyz, and Kinetiq — through one API.

Use it to run funding arbitrage, manage cross-venue positions, and route perp orders from Claude, Cursor, or any MCP-compatible agent.

---

What this is

Connect Claude, Cursor, or any MCP-compatible agent to perpetual futures on Hyperliquid, Lighter, Aster, trade.xyz, and Kinetiq. One connection — read positions, compare funding rates across venues, route orders, transfer margin between DEXs. No separate integrations per venue.

Works across 500+ markets: crypto perps, and RWA perps like NVDA, gold, S&P 500, SAMSUNG, and HYUNDAI.

MCP endpoint:

https://perps-api.vooi.io/mcp

Auth: Bearer token. Generate yours at ultra.vooi.io/api-tokens.

---

What agents can do

• Check open positions and account balances across all venues
• Read live funding rates and compare spreads across DEXs
• Route orders to Hyperliquid, Lighter, Aster, trade.xyz, or Kinetiq
• Transfer margin between venues (~15 seconds end-to-end)
• Execute delta-neutral funding arbitrage strategies
• Monitor 500+ markets: crypto perps, RWA perps (stocks, gold, indices)

---

Connect

Claude Desktop

Claude Desktop uses stdio — connect via the claude.ai web UI or add as a custom connector.

Go to Settings → Connectors → Add custom connector, paste the endpoint, and authenticate with your VOOI API token.

Alternatively, add via claude_desktop_config.json:

{
  "mcpServers": {
    "vooi-perps": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://perps-api.vooi.io/mcp"],
      "env": {
        "VOOI_API_TOKEN": "your-token-here"
      }
    }
  }
}

Restart Claude Desktop after saving.

---

Claude Code

claude mcp add --transport http vooi-perps https://perps-api.vooi.io/mcp \
  --header "Authorization: Bearer $VOOI_API_TOKEN"

Set your token first:

export VOOI_API_TOKEN=your-token-here

Verify connection:

claude mcp list

---

Cursor

Add to .cursor/mcp.json in your project root, or to global Cursor MCP settings:

{
  "mcpServers": {
    "vooi-perps": {
      "type": "http",
      "url": "https://perps-api.vooi.io/mcp",
      "headers": {
        "Authorization": "Bearer ${VOOI_API_TOKEN}"
      }
    }
  }
}

Set VOOI_API_TOKEN in your environment before launching Cursor.

---

Codex CLI

VOOI_API_TOKEN=your-token-here codex --mcp-server https://perps-api.vooi.io/mcp

---

Example prompts

Once connected, prompt your agent directly:

What are the current funding rates across all venues for BTC?

Open a delta-neutral position: long BTC on Lighter, short BTC on Hyperliquid, $500 each side.

Transfer $200 margin from my Hyperliquid account to Lighter.

Show me my open positions and unrealized PnL across all venues.

Find the top 5 funding arb opportunities right now. Show spread and estimated APR.

---

Security

Keep your VOOI API token private.

Do not:

• hard-code the token in shared config files
• commit config files with raw tokens to git
• paste tokens into AI chats or support messages
• share screenshots that include tokens

Use environment variables. If a token is exposed, revoke it at ultra.vooi.io/api-tokens and generate a new one.

---

Related repos

• vooi-funding-bot-example — Production-grade delta-neutral funding arb bot over VOOI Perps API. Includes a Claude Code skill that drives the same strategy through MCP with human-in-the-loop confirmation.
• vooi-signals-bot-example — Telegram signals → LLM parser → VOOI Ultra API trade execution.

---

Links

• VOOI Perps API docs: perps-api.vooi.io/docs
• MCP setup guide: docs.vooi.io/vooi-ultra-v3/vooi_ultra-mcp
• Get API token: ultra.vooi.io/api-tokens
• VOOI Ultra: ultra.vooi.io
• X: @vooi_io

---

License

MIT