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
