MCP-Server
Der Hyperdrome MCP-Server steht auf der Roadmap und ist noch nicht live. Diese Seite dokumentiert die geplante Spezifikation.
Was ist MCP?
Model Context Protocol (MCP) ist ein offener Standard von Anthropic, der KI-Assistenten ermoeglicht, Tools auf externen Servern zu entdecken und aufzurufen. Es verwendet JSON-RPC 2.0 — der Assistent ruft tools/list auf, um verfuegbare Aktionen zu entdecken, dann tools/call, um sie auszufuehren.
MCP wird von Claude Desktop, Cursor, Opencode, Windsurf und einer wachsenden Zahl von KI-Coding- und Chat-Tools unterstuetzt.
Warum MCP fuer DeFi?
Heute erfordert die Interaktion mit DeFi:
- Browser oeffnen
- Wallet verbinden
- Komplexe UI navigieren
- Slippage, Routing, Gas verstehen
Mit dem MCP-Server von Hyperdrome kann jeder KI-Assistent direkt Token tauschen, Renditen pruefen, ueber Gauges abstimmen und Positionen verwalten — ohne dass der Nutzer jemals sein bevorzugtes Tool verlassen muss.
“Tausche 500 USDC in HYPE auf Hyperdrome” — eingegeben in Claude Desktop, Cursor oder einen beliebigen MCP-Client.
Der MCP-Server stellt das gesamte Hyperdrome-Protokoll als aufrufbare Tools bereit:
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 |
Jedes Tool folgt der MCP-Spezifikation mit einem JSON Schema fuer Eingaben:
{
"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"]
}
}
Verbindung
Claude Desktop / Cursor / Opencode
Zur MCP-Konfiguration hinzufuegen:
{
"mcpServers": {
"hyperdrome": {
"url": "https://mcp.hyperdrome.finance/sse"
}
}
}
Selbst gehostet
Der MCP-Server wird Open-Source sein. Eigene Instanz betreiben:
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
Sicherheitsmodell
| Eigenschaft | Detail |
|---|
| Standardmaessig schreibgeschuetzt | Portfolio-Abfragen und Pool-Daten benoetigen keine Wallet-Verbindung |
| Transaktionsgenehmigung | Alle Schreiboperationen geben unsignierte Transaktionen zur Ueberpruefung und Signierung durch den Nutzer zurueck |
| Keine Private Keys | Der gehostete MCP-Server beruehrt niemals Private Keys. Die Signierung erfolgt clientseitig. |
| Rate Limiting | Rate Limits pro IP und pro API-Key zur Missbrauchspraevention |
| Audit Trail | Jeder Tool-Aufruf wird mit Zeitstempel, Parametern und Ergebnis protokolliert |
Der MCP-Server fuehrt niemals Transaktionen in Ihrem Namen aus. Er baut die Transaktion und gibt sie zur Ihrer ausdruecklichen Genehmigung zurueck — genau wie jedes DeFi-Frontend.
Anwendungsfaelle
| Szenario | Wie |
|---|
| Entwickler baut ein DeFi-Dashboard | Pools, Renditen und Positionen ueber MCP-Tools abfragen |
| KI-Coding-Assistent | ”Hilf mir ein Skript zu schreiben, das alle meine Hyperdrome-Belohnungen einfordert” — der Assistent ruft get_pending_rewards dann claim_rewards auf |
| Autonomer Agent | Ein Portfolio-Management-Agent prueft stuendlich Renditen und rebalanciert ueber add_liquidity / remove_liquidity |
| Chat-Bot | Ein Telegram-Bot, der Nutzern ermoeglicht, ueber natuerliche Sprache zu tauschen, Portfolios zu pruefen und abzustimmen |
| Research | Ein Analyst fragt get_pools ab, um einen Renditevergleich ueber HyperEVM-DEXes zu erstellen |
