Ctrlk
vooi.ioapp.vooi.iopro.vooi.io
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Ultra MCP

Connect AI agents and MCP-compatible tools to VOOI Perps API

Overview

VOOI MCP provides an agent-facing interface for working with VOOI Perps API through MCP-compatible clients.

Instead of integrating separately with each supported perpetual trading venue, an AI agent can connect to VOOI MCP and access VOOI Perps functionality through a single tool layer.

VOOI MCP can be used to interact with supported trading venues through tools exposed to compatible AI clients, IDEs, and coding agents.

What is VOOI MCP?

VOOI MCP is a Model Context Protocol server for VOOI Perps API.

It allows compatible AI agents to access VOOI trading tools through the MCP standard. The MCP client handles the agent interface, while VOOI MCP connects the agent to VOOI Perps API.

VOOI MCP is designed for workflows such as:

  • checking open positions;

  • reviewing balances and account data;

  • working with perpetual trading venues through one interface;

  • using VOOI Perps tools from coding agents or AI-enabled IDEs.

Supported clients

VOOI MCP can be connected to several MCP-compatible clients:

  • Codex CLI Terminal-based coding agent. Uses HTTP MCP configuration.

  • Claude Desktop Desktop AI assistant. Requires a local bridge because Claude Desktop uses stdio MCP configuration.

  • Claude Code Terminal-based coding agent. Supports HTTP MCP configuration.

  • Cursor AI-enabled IDE. Uses MCP configuration in mcp.json.

Before you start

Before connecting VOOI MCP, make sure you have:

  • a supported MCP client installed;

  • a VOOI API token;

  • access to the environment where the MCP client runs;

  • basic familiarity with editing config files or running CLI commands.

You can generate a VOOI API token from the VOOI Ultra user token page:

https://ultra.vooi.io/api-tokens

Store the token securely. Do not paste it into public chats, screenshots, logs, or shared config files.

MCP endpoint

Use the following VOOI MCP endpoint when configuring your client:

VOOI MCP uses Bearer token authentication.

Most clients should read the token from an environment variable instead of storing the raw token directly in the configuration file.

Recommended environment variable name: VOOI_API_TOKEN

Basic connection flow

The exact setup depends on the client, but the general flow is the same.

  1. Install or open the MCP-compatible client.

  2. Generate a VOOI API token.

  3. Store the token in an environment variable.

  4. Add the VOOI MCP server to the client configuration.

  5. Restart the client if required.

  6. Verify that the vooi-perps server is connected.

  7. Use the exposed VOOI tools from the AI agent.

Security recommendations

Keep your VOOI API token private.

Do not:

  • hard-code the token in shared config files;

  • commit config files containing raw tokens to git;

  • paste tokens into AI chats or support messages;

  • share screenshots that include tokens.

Use environment variables where supported.

If a token is exposed, revoke it and generate a new one.

Next steps

PreviousUltra OverviewNextConnect Codex CLI

Last updated