10/Documentation/MCP API

Connect to the KAIROXO MCP API

Create an access token in the console, then connect compatible AI clients through the KAIROXO Streamable HTTP MCP endpoint.

01key

Create an access token

Open Dashboard → Developer Access → MCP API and create a token. The complete token is shown only once.

02link

Use the MCP endpoint

Use https://www.kairoxo.com/mcp with the HTTP transport in your chosen client.

03vpn_key

Add Bearer authentication

Set the Authorization header to Bearer followed by one space and your token.

04fact_check

Verify the connection

Restart the client, approve the MCP server if prompted, and confirm that the kairoxo tools are available.

hub

Endpoint & Authentication

The MCP service uses Streamable HTTP and accepts a standard Bearer token in the Authorization request header. Do not put the token in the URL.

MCP connection values

URL: https://www.kairoxo.com/mcp
Transport: Streamable HTTP
Authorization: Bearer <YOUR_KAIROXO_TOKEN>

10/MCP API

What the MCP API can do

KAIROXO MCP currently provides 9 tools. Every tool is scoped to the account that owns the access token, so an AI client can only view that account's data and generate credentials from its available dynamic proxy resources.

dns

Proxy assets

View your static residential, daily static residential, and datacenter proxies, including status, region, expiry, notes, and complete connection addresses.

get_static_proxiesget_daily_static_proxiesget_datacenter_proxies

account_balance_wallet

Account data

Search orders and wallet transactions by status, keyword, or time range, and check the current USDT balance without exposing passwords or other sensitive account fields.

get_ordersget_wallet_transactionsget_user_balance

data_usage

Dynamic usage

Check total, used, and remaining traffic for dynamic residential and dynamic mobile proxy products. Values are returned in GB.

get_dynamic_usage

auto_awesome

Smart proxy generation

Generate dynamic residential or mobile proxy credentials by region, gateway, protocol, output format, and sticky-session duration. The service checks the remaining traffic before generation.

generate_dynamic_residential_proxiesgenerate_dynamic_mobile_proxies

Limits & Safety Boundaries

Rate and paging

All MCP tokens for one account share a limit of 30 requests per minute. List queries default to 20 records per page and allow up to 50.

Generation rules

Each dynamic generation request can create 1–1000 credentials. A session time of 0 rotates the exit per request; 5–120 minutes requests sticky behavior.

Not available through MCP

MCP cannot purchase, pay, recharge, renew, delete, update proxies, reset keys, or switch exit IPs. It does not deduct balance or crawler points, while actual proxy traffic is still measured under your plan.

Example prompts for your AI client

chat

Show my currently available static proxies.

chat

Show my orders from the last 30 days.

chat

What is my current USDT balance?

chat

Show the remaining traffic for dynamic residential and mobile proxies.

chat

Generate 5 US dynamic residential proxies with the US gateway and a 30-minute session.

chat

Generate 3 dynamic mobile proxies in SOCKS5 format.

Client Configuration

Choose your client and paste the matching configuration. Replace <YOUR_KAIROXO_TOKEN> with the token that you created in the dashboard.

Codex

Add this to ~/.codex/config.toml for a global setup, or .codex/config.toml in a trusted project. Restart Codex, then run codex mcp list or use /mcp to verify.

Codex — config.toml

[mcp_servers.kairoxo]
url = "https://www.kairoxo.com/mcp"
http_headers = { Authorization = "Bearer <YOUR_KAIROXO_TOKEN>" }

Claude Code

Create .mcp.json in the project root, paste this configuration, and approve the project MCP server when Claude Code prompts. Verify with claude mcp list or /mcp.

Claude Code — .mcp.json

{
  "mcpServers": {
    "kairoxo": {
      "type": "http",
      "url": "https://www.kairoxo.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KAIROXO_TOKEN>"
      }
    }
  }
}

Cursor

Create .cursor/mcp.json in your project, or ~/.cursor/mcp.json for a global setup. Then enable kairoxo in Cursor Settings → Tools & MCP.

Cursor — mcp.json

{
  "mcpServers": {
    "kairoxo": {
      "type": "http",
      "url": "https://www.kairoxo.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KAIROXO_TOKEN>"
      }
    }
  }
}

VS Code / GitHub Copilot

Create .vscode/mcp.json in your workspace, then run MCP: List Servers and start kairoxo. Check Chat → Configure Tools to confirm the tools.

VS Code — .vscode/mcp.json

{
  "servers": {
    "kairoxo": {
      "type": "http",
      "url": "https://www.kairoxo.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KAIROXO_TOKEN>"
      }
    }
  }
}

shield_lock

Keep your token private

Your access token and any proxy connection address returned by MCP are sensitive credentials. Store them only in trusted local configuration files, never send them in chats, tickets, screenshots, logs, or public repositories, and revoke the token immediately if exposed.