mcp

KO | EN

gitlite — search

#python #hacktoberfest #react #nodejs #php #express #go #python3 #arduino #reactjs #telegram-bot #computer-vision

★ 12 Open GitHub ↗

MCP server for perpetual futures trading on Hyperliquid, Lighter, Aster, trade.xyz & Kinetiq through one API — funding arbitrage, cross-venue positions, and perp order routing from Claude, Cursor, or any MCP agent.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://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`:

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

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

Set your token first:
```bash
export VOOI_API_TOKEN=your-token-here
```

Verify connection:
```bash
claude mcp list
```

---

### Cursor

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

```json
{
  "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

```bash
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](https://ultra.vooi.io/api-tokens) and generate a new one.

---

## Related repos

- [vooi-funding-bot-example](https://github.com/vooi-app/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](https://github.com/vooi-app/vooi-signals-bot-example) — Telegram signals → LLM parser → VOOI Ultra API trade execution.

---

## Links

- VOOI Perps API docs: [perps-api.vooi.io/docs](https://perps-api.vooi.io/docs)
- MCP setup guide: [docs.vooi.io/vooi-ultra-v3/vooi_ultra-mcp](https://docs.vooi.io/vooi-ultra-v3/vooi_ultra-mcp)
- Get API token: [ultra.vooi.io/api-tokens](https://ultra.vooi.io/api-tokens)
- VOOI Ultra: [ultra.vooi.io](https://ultra.vooi.io)
- X: [@vooi_io](https://x.com/vooi_io)

---

## License

MIT

mcp

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README