Antalpha Ai Setup

---

name: antalpha-ai-setup description: > Install and configure the Antalpha Skills MCP server. Provides 76 Web3 tools for DEX swaps, smart money tracking, Polymarket prediction markets, Hyperliquid perpetuals, CEX trading, Bitcoin mining, and DeFi analytics. version: 1.3.0 author: antalpha homepage: https://www.antalpha.com/

---

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:

| What to Say | Tools Used | |-------------|------------| | "What's the current quote for 1 ETH to USDC on Ethereum?" | swap-quote | | "Show me the latest high-confidence smart money signals" | smart-money-signal | | "What are the hottest crypto markets on Polymarket right now?" | poly-trending | | "Show me my Hyperliquid positions at 0x\" | hl-positions | | "Discover DeFi opportunities with low risk and APY above 5%" | investor_discover | | "Show all token balances for 0x\ across every chain" | multi-source-token-list | | "Show me my OKX account summary" | cex-account-get-info | | "Place a spot buy for 0.01 BTC on OKX" | cex-spot-place-order | | "What are my futures positions on OKX?" | cex-futures-get-positions | | "List all miners in my farm with real-time status" | easy-mining-list-miners | | "Get historical hashrate for my farm" | easy-mining-list-metrics-history |

Available Tools (76)

DEX Swaps (9)

| Tool | Description | |------|-------------| | swap-quote | Real-time DEX swap quote via 0x | | swap-create-page | Firm 0x quote + cyberpunk swap page HTML | | swap-full | One-shot: quote + swap page + tx data | | swap-tokens | List supported tokens | | swap-gas | Indicative gas price from 0x probe | | smart-swap-create | Create 1inch Fusion Dutch auction order + signing page | | smart-swap-list | List Smart Swap orders for a wallet | | smart-swap-status | Get order status by hash | | smart-swap-cancel | Check Fusion order cancellation status |

Smart Money (5)

| Tool | Description | |------|-------------| | smart-money-signal | Trading signals from smart money wallets | | smart-money-watch | Recent activity for a specific wallet | | smart-money-list | List all monitored wallets (public + private) | | smart-money-custom | Add/remove private watchlist addresses | | smart-money-scan | On-demand scan of private watchlist |

Polymarket / Poly Master (17)

| Tool | Description | |------|-------------| | poly-master-traders | Discover top Polymarket traders | | poly-master-follow | Follow/unfollow a trader for copy trading | | poly-master-status | Copy-trading status and risk config | | poly-master-risk | View/update risk management params | | poly-master-pnl | Copy-trading PnL report | | poly-master-orders | List copy-trading orders | | poly-trending | Trending Polymarket markets by 24h volume | | poly-new | Recently created Polymarket markets | | poly-market-info | Detailed info for a specific market | | poly-positions | Current Polymarket positions for a wallet | | poly-history | Recent trade activity for a wallet | | poly-buy | Buy outcome tokens via EIP-712 signing page | | poly-sell | Sell outcome tokens via EIP-712 signing page | | poly-confirm | Check poly-buy/sell order status |

Hyperliquid (13)

| Tool | Description | |------|-------------| | hl-price | Get asset prices (Top 10 if no coin) | | hl-account | Hyperliquid account summary | | hl-book | L2 order book depth | | hl-orders | Open orders | | hl-positions | Open perpetual positions | | hl-funding | Funding rates sorted by magnitude | | hl-balance-check | Pre-check sufficient balance | | hl-limit-order | Place a limit order | | hl-market-order | Place a market order | | hl-close | Close position at market | | hl-cancel | Cancel an order | | hl-leverage | Set leverage | | hl-tp-sl | Place take-profit / stop-loss order | | hl-modify-order | Modify an existing order |

DeFi Analytics (3)

| Tool | Description | |------|-------------| | investor_discover | Discover DeFi investment opportunities | | investor_analyze | Deep analysis of a DeFi product | | investor_compare | Compare multiple DeFi products |

Multi-Chain Assets (2)

| Tool | Description | |------|-------------| | multi-source-token-list | Aggregate token balances across all EVM chains | | wallet-balance-query | Query native balance for non-EVM chains |

CEX Trading / OKX (15)

| Tool | Description | |------|-------------| | cex-setup-check | Check OKX API credentials status | | cex-setup-save | Save OKX API credentials | | cex-setup-verify | Verify OKX API credentials | | cex-account-get-info | OKX account summary (equity, PnL, balance) | | cex-account-get-balance | Detailed per-currency balance | | cex-spot-place-order | ⚠️ Place a spot order | | cex-spot-cancel-order | ⚠️ Cancel a spot order | | cex-spot-get-orders | Get spot orders (pending/history) | | cex-futures-place-order | ⚠️ Place a futures/swap order | | cex-futures-cancel-order | ⚠️ Cancel a futures order | | cex-futures-get-positions | Current futures positions + margin alerts | | cex-futures-set-leverage | ⚠️ Set leverage for an instrument | | cex-futures-close-position | ⚠️ Close position via market order | | cex-market-get-ticker | Real-time ticker (price, volume, bid/ask) | | cex-market-get-kline | OHLCV candlestick data | | cex-market-get-orderbook | Order book (bids + asks) | | cex-market-get-instruments | List available instruments |

Bitcoin Mining / Nonce (11)

| Tool | Description | |------|-------------| | easy-mining-get-workspace | Get workspace info (connectivity check) | | easy-mining-list-farms | List all mining farms | | easy-mining-list-agents | List all Nonce Agents | | easy-mining-list-miners | Real-time miner status (hashrate, temp, power) | | easy-mining-list-metrics-history | Historical farm metrics | | easy-mining-list-pool-diffs | Mining pool change records | | easy-mining-list-history | Historical miner performance | | easy-mining-list-miner-tasks | Miner task execution history | | easy-mining-list-task-batches | List task batches | | easy-mining-create-task-batch | ⚠️ Create batch task (reboot, firmware, etc) | | easy-mining-get-task-batch | Get task batch status |

Utility (1)

| Tool | Description | |------|-------------| | test-ping | Verify server connectivity |

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

"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