Servidor MCP
El servidor MCP de Hyperdrome esta en la hoja de ruta y aun no esta activo. Esta pagina documenta la especificacion planificada.
Que es MCP?
Model Context Protocol (MCP) es un estandar abierto de Anthropic que permite a los asistentes de IA descubrir y llamar herramientas en servidores externos. Utiliza JSON-RPC 2.0 — el asistente llama a tools/list para descubrir las acciones disponibles, y luego tools/call para ejecutarlas.
MCP es compatible con Claude Desktop, Cursor, Opencode, Windsurf y un numero creciente de herramientas de IA para programacion y chat.
Por Que MCP para DeFi?
Hoy, interactuar con DeFi requiere:
- Abrir un navegador
- Conectar una billetera
- Navegar una interfaz compleja
- Entender slippage, enrutamiento, gas
Con el servidor MCP de Hyperdrome, cualquier asistente de IA puede directamente intercambiar tokens, consultar rendimientos, votar en gauges y gestionar posiciones — sin que el usuario salga de su herramienta preferida.
“Swap 500 USDC to HYPE on Hyperdrome” — escrito en Claude Desktop, Cursor o cualquier cliente MCP.
Herramientas Disponibles
El servidor MCP expone el protocolo completo de Hyperdrome como herramientas invocables:
Trading
| Tool | Description | Parameters |
|---|
swap | Intercambiar tokens con enrutamiento multi-salto optimizado | fromToken, toToken, amount, slippageBps? |
get_quote | Obtener cotizacion de intercambio sin ejecutar | fromToken, toToken, amount |
Liquidity
| Tool | Description | Parameters |
|---|
add_liquidity | Depositar par de tokens en un pool | tokenA, tokenB, amountA, amountB, stable |
remove_liquidity | Retirar de un pool | tokenA, tokenB, stable, liquidity |
stake_lp | Hacer staking de tokens LP en un gauge | pool, amount |
unstake_lp | Retirar staking de tokens LP de un gauge | pool, amount |
Locking & Voting
| Tool | Description | Parameters |
|---|
lock | Bloquear HDROME para crear o extender un veNFT | amount, duration |
vote | Asignar votos veHDROME entre gauges | tokenId, pools[], weights[] |
reset_votes | Reiniciar votos de un veNFT | tokenId |
Rewards
| Tool | Description | Parameters |
|---|
claim_rewards | Reclamar todas las recompensas pendientes | tokenId? |
claim_fees | Reclamar comisiones de trading de un gauge especifico | gauge |
claim_bribes | Reclamar sobornos externos | gauge, tokens[] |
Read-Only
| Tool | Description | Parameters |
|---|
get_pools | Listar todos los pools con TVL, APR, volumen | sortBy?, limit? |
get_portfolio | Analisis completo de billetera | address |
get_yields | Mejores oportunidades de rendimiento | limit?, minTvl? |
get_venft | Obtener detalles de veNFT | tokenId |
get_pending_rewards | Verificar recompensas no reclamadas | address |
Ejemplo de Esquema de Herramienta
Cada herramienta sigue la especificacion MCP con un JSON Schema para las entradas:
{
"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"]
}
}
Conexion
Claude Desktop / Cursor / Opencode
Agrega a tu configuracion MCP:
{
"mcpServers": {
"hyperdrome": {
"url": "https://mcp.hyperdrome.finance/sse"
}
}
}
Self-Hosted
El servidor MCP sera open-source. Ejecuta tu propia instancia:
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
Modelo de Seguridad
| Property | Detail |
|---|
| Read-only by default | Las consultas de portafolio y datos de pools no requieren conexion de billetera |
| Transaction approval | Todas las operaciones de escritura devuelven transacciones sin firmar para que el usuario revise y firme |
| No private keys | El servidor MCP hospedado nunca toca claves privadas. La firma ocurre del lado del cliente. |
| Rate limiting | Limites de tasa por IP y por API key para prevenir abuso |
| Audit trail | Cada llamada a herramienta se registra con timestamp, parametros y resultado |
El servidor MCP nunca ejecuta transacciones en tu nombre. Construye la transaccion y la devuelve para tu aprobacion explicita — igual que cualquier frontend DeFi.
Casos de Uso
| Scenario | How |
|---|
| Desarrollador construyendo un dashboard DeFi | Consulta pools, rendimientos y posiciones via herramientas MCP |
| Asistente de programacion IA | ”Ayudame a escribir un script que reclame todas mis recompensas de Hyperdrome” — el asistente llama a get_pending_rewards y luego claim_rewards |
| Agente autonomo | Un agente de gestion de portafolio verifica rendimientos cada hora y rebalancea via add_liquidity / remove_liquidity |
| Chat bot | Un bot de Telegram que permite a los usuarios intercambiar, consultar portafolio y votar a traves de lenguaje natural |
| Investigacion | Un analista consulta get_pools para construir una comparacion de rendimientos entre DEXes de HyperEVM |
