BlogFor analysts, researchers and AI agents

A Read-Only Hyperliquid MCP Server for Claude and Cursor

Connect Claude or Cursor to Hyperliquid's full history: read-only tools, no wallet and no private key, hosted or local, every answer traceable.

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:

FamilyToolsWhat they read
HIP-311DEXes, assets, auctions, OHLCV, oracle, traders
HIP-410Questions, markets, outcomes, fills, settlements
Market and analytics10Market history, candles, fill and liquidation stats, priority fees
Trading history10Fills, completed trades, orders, funding, liquidations
Live feed9Order books to L4, mids, trades, user fills
Traders8Profiles, coins, funding, vault equity, leaderboards
Hyperliquid public8Keyless venue calls
HyperEVM8Blocks, transactions, logs, transfers, bridge
Elysium8Blocks, batches, bridge, tokens, accounts
RPC6JSON-RPC on HyperEVM and Elysium
Vaults and TWAPs6Vault details and snapshots, TWAP search
Builders and accounts5Builder 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:

json
{
  "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:

json
{
  "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.

your agentMCP serverHyperCoreHyperEVMElysium
returnedhd_analytics_liquidations_statsthe answer comes back with the call

What 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.

Keep reading.

  • For bots, dashboards and data pipelines

    Hyperliquid API Limits: Rate Limits, WebSocket, History

    Hyperliquid's API rate limits, WebSocket limits and history caps, quoted from the official docs, and what changes on a Hypedexer key.

    • REST: a weight budget per IP
    • History: the most recent items only
    • WebSocket limits
    • +2

    4 min read

  • Start here: every dataset, since when

    Hyperliquid Historical Data: What Exists and How to Get It

    Where Hyperliquid historical trades, fills, funding and order book data live, how far back each goes, and how to download it, from January 2024 to today.

    • The short answer
    • What the official Hyperliquid API gives you
    • What the public S3 archive gives you
    • +2

    5 min read

  • For HIP-3 deployers, traders and analysts

    Hyperliquid HIP-3 Data: DEXes, Markets, Auctions, Fills

    What HIP-3 is, what Hyperliquid's registry shows, and how to get each DEX's volume, open interest, fills, traders and auctions over one API.

    • What HIP-3 is
    • What the public registry tells you
    • The same DEXes, with their activity
    • +2

    3 min read

Start free: 5,000 credits a month, no card.