MCP Server
The Hyperdrome MCP server is on the roadmap and not yet live. This page documents the planned specification.
What is MCP?
Model Context Protocol (MCP) is an open standard by Anthropic that lets AI assistants discover and call tools on external servers. It uses JSON-RPC 2.0 — the assistant calls tools/list to discover available actions, then tools/call to execute them.
MCP is supported by Claude Desktop, Cursor, Opencode, Windsurf, and a growing number of AI coding and chat tools.
Why MCP for DeFi?
Today, interacting with DeFi requires:
- Opening a browser
- Connecting a wallet
- Navigating a complex UI
- Understanding slippage, routing, gas
With Hyperdrome’s MCP server, any AI assistant can directly swap tokens, check yields, vote on gauges, and manage positions — without the user ever leaving their preferred tool.
“Swap 500 USDC to HYPE on Hyperdrome” — typed into Claude Desktop, Cursor, or any MCP client.
The MCP server exposes the full Hyperdrome protocol as callable tools:
Trading
| Tool | Description | Parameters |
|---|
swap | Swap tokens with optimized multi-hop routing | fromToken, toToken, amount, slippageBps? |
get_quote | Get a swap quote without executing | fromToken, toToken, amount |
Liquidity
| Tool | Description | Parameters |
|---|
add_liquidity | Deposit token pair into a pool | tokenA, tokenB, amountA, amountB, stable |
remove_liquidity | Withdraw from a pool | tokenA, tokenB, stable, liquidity |
stake_lp | Stake LP tokens in a gauge | pool, amount |
unstake_lp | Unstake LP tokens from a gauge | pool, amount |
Locking & Voting
| Tool | Description | Parameters |
|---|
lock | Lock HDROME to create or extend a veNFT | amount, duration |
vote | Allocate veHDROME votes across gauges | tokenId, pools[], weights[] |
reset_votes | Reset votes for a veNFT | tokenId |
Rewards
| Tool | Description | Parameters |
|---|
claim_rewards | Claim all pending rewards | tokenId? |
claim_fees | Claim trading fees for a specific gauge | gauge |
claim_bribes | Claim external bribes | gauge, tokens[] |
Read-Only
| Tool | Description | Parameters |
|---|
get_pools | List all pools with TVL, APR, volume | sortBy?, limit? |
get_portfolio | Full wallet analysis | address |
get_yields | Top yield opportunities | limit?, minTvl? |
get_venft | Get veNFT details | tokenId |
get_pending_rewards | Check unclaimed rewards | address |
Each tool follows the MCP specification with a JSON Schema for inputs:
{
"name": "swap",
"description": "Swap tokens on Hyperdrome (HyperEVM). Finds the optimal route across volatile and stable pools. Returns unsigned transaction for user approval.",
"inputSchema": {
"type": "object",
"properties": {
"fromToken": {
"type": "string",
"description": "Token symbol or address to sell (e.g. 'USDC' or '0xb883...')"
},
"toToken": {
"type": "string",
"description": "Token symbol or address to buy (e.g. 'HYPE')"
},
"amount": {
"type": "string",
"description": "Amount to swap in human-readable units (e.g. '100')"
},
"slippageBps": {
"type": "number",
"description": "Max slippage in basis points (default: 50 = 0.5%)"
}
},
"required": ["fromToken", "toToken", "amount"]
}
}
Connection
Claude Desktop / Cursor / Opencode
Add to your MCP configuration:
{
"mcpServers": {
"hyperdrome": {
"url": "https://mcp.hyperdrome.finance/sse"
}
}
}
Self-Hosted
The MCP server will be open-source. Run your own instance:
git clone https://github.com/hyperdrome/mcp-server
cd mcp-server
npm install
PRIVATE_KEY=0x... RPC_URL=https://rpc.hyperliquid.xyz/evm npm start
Security Model
| Property | Detail |
|---|
| Read-only by default | Portfolio queries and pool data require no wallet connection |
| Transaction approval | All write operations return unsigned transactions for the user to review and sign |
| No private keys | The hosted MCP server never touches private keys. Signing happens client-side. |
| Rate limiting | Per-IP and per-API-key rate limits to prevent abuse |
| Audit trail | Every tool call is logged with timestamp, parameters, and result |
The MCP server never executes transactions on your behalf. It builds the transaction and returns it for your explicit approval — just like any DeFi frontend.
Use Cases
| Scenario | How |
|---|
| Developer building a DeFi dashboard | Query pools, yields, and positions via MCP tools |
| AI coding assistant | ”Help me write a script that claims all my Hyperdrome rewards” — the assistant calls get_pending_rewards then claim_rewards |
| Autonomous agent | A portfolio management agent checks yields hourly and rebalances via add_liquidity / remove_liquidity |
| Chat bot | A Telegram bot that lets users swap, check portfolio, and vote through natural language |
| Research | An analyst queries get_pools to build a yield comparison across HyperEVM DEXes |
