Serveur MCP
Le serveur MCP d’Hyperdrome est sur la feuille de route et n’est pas encore en production. Cette page documente la specification prevue.
Qu’est-ce que MCP ?
Model Context Protocol (MCP) est un standard ouvert d’Anthropic qui permet aux assistants IA de decouvrir et d’appeler des outils sur des serveurs externes. Il utilise JSON-RPC 2.0 — l’assistant appelle tools/list pour decouvrir les actions disponibles, puis tools/call pour les executer.
MCP est supporte par Claude Desktop, Cursor, Opencode, Windsurf, et un nombre croissant d’outils IA de codage et de chat.
Pourquoi MCP pour la DeFi ?
Aujourd’hui, interagir avec la DeFi necessite de :
- Ouvrir un navigateur
- Connecter un portefeuille
- Naviguer dans une interface complexe
- Comprendre le slippage, le routage, le gas
Avec le serveur MCP d’Hyperdrome, n’importe quel assistant IA peut directement echanger des tokens, consulter les rendements, voter sur les gauges et gerer les positions — sans que l’utilisateur quitte jamais son outil prefere.
“Swap 500 USDC to HYPE on Hyperdrome” — tape dans Claude Desktop, Cursor, ou tout client MCP.
Outils disponibles
Le serveur MCP expose l’ensemble du protocole Hyperdrome sous forme d’outils appelables :
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 |
Exemple de schema d’outil
Chaque outil suit la specification MCP avec un JSON Schema pour les entrees :
{
"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"]
}
}
Connexion
Claude Desktop / Cursor / Opencode
Ajoutez a votre configuration MCP :
{
"mcpServers": {
"hyperdrome": {
"url": "https://mcp.hyperdrome.finance/sse"
}
}
}
Auto-heberge
Le serveur MCP sera open-source. Executez votre propre 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
Modele de securite
| 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 |
Le serveur MCP n’execute jamais de transactions en votre nom. Il construit la transaction et la renvoie pour votre approbation explicite — comme n’importe quel frontend DeFi.
Cas d’utilisation
| Scenario | Comment |
|---|
| Developpeur construisant un dashboard DeFi | Interroger les pools, rendements et positions via les outils MCP |
| Assistant IA de codage | ”Aide-moi a ecrire un script qui reclame toutes mes recompenses Hyperdrome” — l’assistant appelle get_pending_rewards puis claim_rewards |
| Agent autonome | Un agent de gestion de portefeuille verifie les rendements toutes les heures et reequilibre via add_liquidity / remove_liquidity |
| Chat bot | Un bot Telegram qui permet aux utilisateurs d’echanger, consulter leur portefeuille et voter en langage naturel |
| Recherche | Un analyste interroge get_pools pour construire une comparaison de rendements entre les DEX HyperEVM |
