AntAlpha Skills MCP Server Setup

Connect your AI agent to Antalpha's Web3 unified gateway — 76 tools covering DEX swaps, smart money signals, Polymarket prediction markets, Hyperliquid perpetual trading, DeFi investment discovery, OKX spot/futures trading, Bitcoin mining management, and multi-chain asset queries.

⚡ Quick Install

Option 1: mcporter (Recommended)

npx mcporter list https://mcp-skills.ai.antalpha.com/mcp --name antalpha

Output:

✓ MCP server "antalpha" connected

→ Registering agent...
 ✓ agent_id: "a3f1c8e7-4d2b-4a9f-b6e5-7c8d9e0f1a2b"
 ✓ api_key: "sk_4f7a2e...b2c3d4e5f6a7b8c9d"

 76 tools ready.

Add the returned agent_id and api_key to your MCP client config.

Option 2: OpenClaw Skill Install

clawhub install antalpha-ai-setup

Prerequisites

• An MCP-compatible client (Claude Code, Claude Desktop, Cursor, Windsurf, OpenClaw, etc.)

Step 1 — Add the MCP Server

Claude.ai (web): This cannot be done programmatically. Instruct the user to:

1. Go to Customize → Connectors → Plus button → Add custom connector
2. Name: AntAlpha Skills
3. URL: https://mcp-skills.ai.antalpha.com/mcp
4. Click Add

Claude Code (run in terminal):

claude mcp add antalpha --transport http https://mcp-skills.ai.antalpha.com/mcp

Codex (run in terminal):

codex mcp add antalpha --url https://mcp-skills.ai.antalpha.com/mcp

Claude Desktop / Cursor / Windsurf (add to MCP config file):

{
  "mcpServers": {
    "antalpha": {
      "url": "https://mcp-skills.ai.antalpha.com/mcp"
    }
  }
}

Gemini CLI (add to MCP config file):

{
  "mcpServers": {
    "antalpha": {
      "httpUrl": "https://mcp-skills.ai.antalpha.com/mcp"
    }
  }
}

OpenCode (add to MCP config file):

{
  "mcp": {
    "antalpha": {
      "type": "remote",
      "url": "https://mcp-skills.ai.antalpha.com/mcp"
    }
  }
}

OpenClaw (native Streamable HTTP support, no bridge needed):

{
  "mcp": {
    "servers": {
      "antalpha": {
        "url": "https://mcp-skills.ai.antalpha.com/mcp"
      }
    }
  }
}

Step 2 — Register Your Agent

After adding the server, register your agent to receive an API key:

1. Ask your agent to call the registration tool
2. It will return an agent_id (UUID) and a one-time api_key
3. Save the api_key — it is shown only once

About API Key Authentication:

The server currently operates in open mode — most tools work without an API key. However, we recommend registering an agent anyway because:

• Some tools (especially smart-money-* with private watchlists) require authentication
• Rate limits are higher for authenticated agents
• Future updates may enforce authentication for all tools

If your agent supports MCP headers, configure the x-antalpha-agent-api-key header with the returned api_key for full access.

Step 3 — Verify

Ask your agent:

"Ping the server to verify the connection."

If it calls test-ping and returns { "ok": true }, you're connected.

Step 4 — Get Your First Result

Try one of these prompts:

Available Tools (76)

DEX Swaps (9)

Smart Money (5)

Polymarket / Poly Master (17)

Hyperliquid (13)

DeFi Analytics (3)

Multi-Chain Assets (2)

CEX Trading / OKX (15)

Bitcoin Mining / Nonce (11)

Utility (1)

Troubleshooting

• "Agent validation failed": Register your agent first and persist the returned agent_id and api_key. Then configure the x-antalpha-agent-api-key header with your api_key.
• No tools available: Verify the MCP server URL is exactly https://mcp-skills.ai.antalpha.com/mcp (note the /mcp path).
• Rate limited: The tool call frequency is limited per IP. Wait a moment and retry, or register an agent for higher limits.
• Smart Swap not filling: Smart Swap currently only supports chain_id=1 (Ethereum mainnet) with engine=1inch. The order uses a Dutch auction mechanism — it may take 3–10 minutes to fill or auto-expire.
• Hyperliquid write tools require a private key: Tools like hl-limit-order require your agent_key (Hyperliquid private key) and owner address in the input. The key is used only for signing the current request and is never stored server-side.
• Polymarket trades use signing pages: poly-buy and poly-sell generate EIP-712 signing pages. Open the returned preview_url in your wallet browser to sign — your private key never leaves your wallet.
• OKX tools need API credentials: Run cex-setup-save to configure your OKX API key, secret, and passphrase. Use cex-setup-verify to validate before trading.
• Mining tools need a Nonce API key: Ensure your Nonce workspace API key is configured. Use easy-mining-get-workspace to verify connectivity.

Maintainer: Antalpha AI Team
Registry: https://clawhub.com/skills/antalpha-ai-setup
License: MIT