MCP, the Model Context Protocol, lets an AI assistant call tools: instead of guessing from what it read in training, Claude or Cursor asks a server and answers from the result. For Hyperliquid, that means asking "how much was liquidated in the last day, and on what?" and getting the figure from the data, with the call that produced it.
This guide covers what the Hypedexer MCP server does, why it never needs a wallet, and how to connect it in a minute.
Read-only, and no private key
Several Hyperliquid MCP servers are built to trade: they place orders, change leverage and close positions, so their setup asks for a wallet's private key. That is a lot to hand to an assistant.
The Hypedexer server is the other kind. Its tools are all read-only, as its documentation states: it reads data and cannot sign, send or trade. Its configuration takes one secret, a Hypedexer API key, and no wallet key at all.
What the agent can reach
The npm package, @hypedexer/mcp-server 2.2.0, has 99 tools in twelve families:
| Family | Tools | What they read |
|---|---|---|
| HIP-3 | 11 | DEXes, assets, auctions, OHLCV, oracle, traders |
| HIP-4 | 10 | Questions, markets, outcomes, fills, settlements |
| Market and analytics | 10 | Market history, candles, fill and liquidation stats, priority fees |
| Trading history | 10 | Fills, completed trades, orders, funding, liquidations |
| Live feed | 9 | Order books to L4, mids, trades, user fills |
| Traders | 8 | Profiles, coins, funding, vault equity, leaderboards |
| Hyperliquid public | 8 | Keyless venue calls |
| HyperEVM | 8 | Blocks, transactions, logs, transfers, bridge |
| Elysium | 8 | Blocks, batches, bridge, tokens, accounts |
| RPC | 6 | JSON-RPC on HyperEVM and Elysium |
| Vaults and TWAPs | 6 | Vault details and snapshots, TWAP search |
| Builders and accounts | 5 | Builder codes, their users, account state |
The hosted server can run a release behind the package; the docs give its current count. The history behind the tools is the Data API's: fills since January 2024, funding since May 2023, the order book since April 2024. Coverage per family is on Research.
Connect it: hosted, nothing to install
Put the endpoint and your key in the client's MCP configuration, then restart the client:
{
"mcpServers": {
"hypedexer": {
"url": "https://mcp.hypedexer.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}The same block works in Claude and in Cursor. The client guide covers each one.
Or run it locally
The same server runs on your machine over stdio, so the key never leaves it:
{
"mcpServers": {
"hypedexer": {
"command": "npx",
"args": ["-y", "@hypedexer/[email protected]"],
"env": {
"HYPEDEXER_API_KEY": "YOUR_API_KEY"
}
}
}
}With no key and HYPEDEXER_MCP_TOOLS set to public, it enables only the eight keyless Hyperliquid tools: a way to try it with nothing to sign up for.
Questions to ask
- Which builder codes earned the most on Hyperliquid in the last 24 hours?
- How busy was Hyperliquid over the last 24 hours?
- How much was liquidated in the last day, and on what?
- What did this wallet trade in Q2 2024?
- Which HIP-3 DEX did the most volume this week?
The answer names the tools it called and their arguments, so any figure can be checked or re-run. Three real exchanges, replayed as they were answered, are on the MCP page.
hd_analytics_liquidations_statsthe answer comes back with the callWhat it costs
- Free trial: 100 tool calls a day, no card.
- Pro: 10,000 tool calls a month, $19.
- Team: 100,000 tool calls a month, $99.
- On a Data API plan: each tool call spends the credits of the requests it makes, from the same balance.
When the trial runs out, the error carries the plan, what is left and an upgrade link the assistant can show you. Cancelling never deletes the key: it drops back to the free trial, so a configured agent keeps working.
FAQ
Is there an MCP server for Hyperliquid? Yes. The Hypedexer MCP server is hosted at https://mcp.hypedexer.com/mcp and on npm as @hypedexer/mcp-server.
Can it trade or move funds? No. Every tool is read-only, and it never asks for a private key or a wallet signature.
Does it work with Claude and Cursor? Yes, and with any client that speaks MCP: the hosted server takes a URL and a bearer token.
Can I use it without an API key? Locally, yes, with the eight keyless Hyperliquid tools. The archive tools and the hosted server need a key; the free trial gives 100 tool calls a day.