Hyperliquid MCP Servers: Connect Claude, Codex or Cursor to Hyperliquid
Table of Contents
If you ask a coding agent to write a Hyperliquid bot, it will often guess. It remembers a tick size that changed, a market name that needs a prefix, or a fee that is out of date. An MCP server fixes that by letting the agent look the answer up live instead of recalling it. This guide explains what MCP is, how to connect Claude, Codex or Cursor to Hyperliquid, which servers exist, and how to keep your funds safe while you try them.
What MCP is and why it helps
MCP, the Model Context Protocol, is an open standard for connecting AI applications to outside data, tools and workflows. Its own docs compare it to a USB-C port for AI apps: one connector, many devices. Claude, ChatGPT, Cursor and Visual Studio Code are among the clients its site lists as supporting it.
For trading code, the useful part is simple. Without a server, an agent writes exchange.order("BTC", True, 0.001, 97123.456789, ...) from memory and you find out about the bad price when Hyperliquid rejects it. With a server, the agent can call a tool first, read the real size decimals and price rules for that market, and write code that matches. It can also read an exact error message back to a tool and get a cause and fix instead of a guess.
A server runs one of two ways. A local server starts as a process on your machine, usually through uvx or npx, and talks to your agent over standard input and output. A hosted server lives at a URL and your client connects to it. The first kind runs code you can read on your own disk. The second sends your requests to someone else's service.
The Hyperliquid Guide MCP server
We publish an open-source MCP server in the starter bots repository. It is read-only. It holds no keys and places no orders. Its job is to give your agent accurate Hyperliquid facts while it writes code. We are independent and not affiliated with Hyperliquid or the Hyper Foundation.
It exposes seven tools:
| Tool | What it returns |
|---|---|
market_specs | Size decimals, max price decimals, max leverage, mark and mid price, hourly funding and its APR, open interest, and growth mode fields for HIP-3 markets |
round_order | A price and size rounded to what Hyperliquid accepts for that market, plus a check against the $10 minimum |
top_funding | Markets ranked by absolute funding APR |
explain_error | A cause and fix for a Hyperliquid rejection message |
account_status | Equity, open positions, fee rates and referral status for a public address |
quickstart | Our agent quickstart: endpoints, API wallets, rounding, error text, fees and rate limits |
starter_bot | Source of one starter bot (market maker, scalper, grid or funding arb) with how to run it |
Market and funding tools read Hyperliquid's public info endpoint, on mainnet by default or on testnet if you ask for it. account_status takes a wallet address, never a key.
Install it
The server runs through uv, so install uv first. Then pick the line that matches your agent. These are copied from the repository README.
Claude Code (plugin: skill and MCP in one step)
/plugin install hyperliquid-guide --marketplace Hyperliquidguide/hyperliquid-starter-bots
Claude Code (MCP only)
claude mcp add hyperliquid-guide -- uvx --from hyperliquid-starter-bots hl-guide-mcp
Codex
codex mcp add hyperliquid-guide -- uvx --from hyperliquid-starter-bots hl-guide-mcp
Cursor, Claude Desktop and other MCP clients (add to mcp.json or claude_desktop_config.json)
{
"mcpServers": {
"hyperliquid-guide": {
"command": "uvx",
"args": ["--from", "hyperliquid-starter-bots", "hl-guide-mcp"]
}
}
}
Agent Skill only (Claude Code, Codex, Cursor and other skills-compatible agents)
npx skills add Hyperliquidguide/hyperliquid-starter-bots
The skill is a set of written instructions your agent loads on its own, and the MCP server supplies the live data. Use either one or both.
Need a Hyperliquid account first?
Sign up with the Hyperliquid Guide link for 4% off fees on your first $25M of volume.
Join HyperliquidWhat it looks like in use
Here are four prompts and the tool the agent would reach for. The agent chooses the tool itself, so the exact calls can vary.
- "What price and size rules apply to ETH, and what is its leverage cap?" The agent calls
market_specs("ETH")and answers from the live result, not from memory. - "I want to buy 0.00123 BTC near 97123.456789. Is that a valid order?" The agent calls
round_order("BTC", 97123.456789, 0.00123). Size is rounded down, so it never exceeds what you asked for. - "My order failed with 'Order must have minimum value of $10'. Fix it." The agent calls
explain_errorwith the exact text and gets the cause and the fix. - "Which perps have the most extreme funding right now?" The agent calls
top_funding(limit=10)and ranks the result. Pair it with our funding rates explainer if you want the mechanics.
Here is real output from the server on November 21, 2026. market_specs("BTC") returned, among other fields:
{
"coin": "BTC",
"network": "mainnet",
"szDecimals": 5,
"maxPriceDecimals": 1,
"priceRule": "max 5 significant figures and maxPriceDecimals decimals; integer prices always valid",
"minOrderUsd": 10,
"maxLeverage": 40,
"markPx": 60091.0,
"fundingHourly": 6.6752e-06,
"fundingApr": 5.85
}
And round_order("BTC", 97123.456789, 0.00123) returned a price of 97123.0, a size of 0.00123 and a notional of about $119.46, marked valid. Those are live values at the moment we ran it, so yours will differ. The point is that the agent now has numbers it did not have to invent. Our leverage guide explains why the cap varies by market.
If you want the agent to go further and write a strategy, the build page has prompts and the repository's AGENTS.md, and our trading bot setup guide walks through the same flow by hand.
Other Hyperliquid MCP servers
We are not the only ones building these. The list below comes from each project's own README or docs as we read them on November 21, 2026. These projects change quickly, so confirm the current details on their pages before you connect anything. We have not audited their code and this is not an endorsement.
Bitquery's Hyperliquid MCP server is hosted. Its docs say it reads data only, cannot place, change or cancel orders, and never touches a key. You connect to a remote URL over Streamable HTTP and sign in with a Bitquery account through OAuth. Its docs cover markets, funding, open interest, liquidations and wallet-level positions and fills.
kitsune-de/hyperliquid-mcp is a local server run through npx. Its README says it uses only the public info API and cannot trade. Account tools take a public address.
erscoder/hyperliquid-mcp runs locally over stdio. Its README says that setting only a wallet address gives read-only access, and that trading tools need a private key, supplied as an environment variable in your client config. It recommends a dedicated trading wallet with limited funds.
midodimori/hyperliquid-mcp is self-run, with stdio as the default and HTTP options for remote setups. Its README lists order tools and account tools, including withdraw. Without a private key it starts in read-only mode for market data. A testnet switch is available.
Dakkshin/hyperliquid-mcp is a local server whose README describes signed access to perps, including order and bracket-order tools. It documents an agent mode where an API wallet signs and your main address is supplied separately, and it advises starting on testnet. It warns that the key in your MCP config can sign orders, so that file should be protected like the key itself.
| Server | Reads data | Can place orders | Runs | Key handling per its docs |
|---|---|---|---|---|
| Hyperliquid Guide | Yes | No | Local | Holds no keys; public address only |
| Bitquery | Yes | No | Hosted | No key; OAuth sign-in to Bitquery |
| kitsune-de | Yes | No | Local | No keys or signing; public address only |
| erscoder | Yes | Yes, with a key | Local | Private key in an environment variable; address-only gives read-only |
| midodimori | Yes | Yes, with a key | Local by default | Private key in an environment variable; read-only without it |
| Dakkshin | Yes | Yes | Local | API wallet key in config; main address separate |
"Can place orders" reflects what each README says the tools do, not a test we ran. We wrote the Hyperliquid Guide server, so weigh that when you read the comparison.
For tools that are not MCP servers at all, such as terminals, dashboards and Telegram bots, see our Hyperliquid trading tools roundup.
Safety: read this before you connect anything
An MCP server that can sign orders gives a language model a way to move money. A model can misread a prompt, and a prompt can come from content you did not write. Plan for the day it gets one wrong.
- Never give an MCP server or a chat your main wallet key. Not in a prompt, not in a config, not in a pasted log.
- Use an API wallet for anything that trades. On app.hyperliquid.xyz you can approve one from your main wallet. It can place and cancel orders but cannot withdraw. Our API guide shows how, and the trading bot setup guide covers wallet handling in detail.
- Protect the config file. If a key sits in your MCP config, that file can sign orders. Keep it out of git and out of screenshots.
- Start on testnet. Testnet has fake money, a separate ledger and its own API wallet approvals. Prove the whole loop there first.
- Keep size small on mainnet. Start with an amount you would shrug off losing, and set loss limits in code, not in the prompt. Our order types guide covers stops and reduce-only orders.
- Review the tools before you connect. Read the README and look at the tool list. A server with
withdraw,place_orderorcancel_all_ordersis a different risk from one that only reads. - Prefer a read-only server while you are learning. You can have an agent write and explain code without it ever holding authority over funds.
Nothing here is financial advice, and no setup removes the risk of losing money.
Disclosure: referral code in the starter repo
The MCP server itself never sets a referral or changes anything on your account. It is read-only. account_status only reports whether a code can still be added.
The separate starter bots do something different. If your account has no referrer yet and has traded less than about $10K, the repo's setup_wallet script and the bots apply the Hyperliquid Guide referral code. Under Hyperliquid's referral program that is 4% off trading fees on your first $25M of volume, and Hyperliquid pays this site a share of the fees you pay. It never replaces an existing referrer, and it is skipped on testnet. Set HL_REFERRAL=off in .env to opt out. The full terms are in our referral guide.
Trade Hyperliquid with 4% off fees
Create your account, approve an API wallet and point your agent at testnet first.
Join HyperliquidWhere to go next
Install the read-only server and ask your agent about a market you trade. You will see the difference in the code it writes. When you want a working strategy to edit, the starter bots on our build page include a market maker, scalper, grid and funding arb, and the agent quickstart is a plain-text file your agent can read directly. For the underlying endpoints, see the Hyperliquid API guide. If you are thinking about quoting two-sided markets, our market making guide and strategies overview are the next reads.
Frequently Asked Questions
It is a small program that exposes Hyperliquid data or actions as tools an AI agent can call over the Model Context Protocol. Claude, Codex and Cursor can all use MCP servers. Some Hyperliquid servers only read market data, and some can also place orders if you give them a signing key.
It is read-only. It holds no keys, places no orders and never asks for a private key. Its account_status tool takes a public address only. You should still read the source before running any MCP server, and you should never paste a private key into a chat.
Some MCP servers can place orders when you supply a signing key, according to their own documentation. If you try one, use an API wallet, which can trade but cannot withdraw, keep the size small, and start on testnet. The Hyperliquid Guide server does not trade.
Not for market data. Read-only servers only need public data and, for account lookups, a public address. Trading servers need a key to sign orders. In that case use a dedicated API wallet, never your main wallet key.
Any client that supports MCP, including Claude Code, Claude Desktop, Codex and Cursor. Local servers start as a process on your machine, and hosted servers connect over a URL. Check each server's README for the exact install command.
Independent resource: Hyperliquid Guide is an independent, third-party resource operated by Concept211. It is not affiliated with, produced by, reviewed by or endorsed by Hyper Foundation, Hyperliquid Labs or any other Hyperliquid-ecosystem entity. "Hyperliquid" and related names and marks belong to their respective owners and are used here only to identify the platform this site documents. Read the full disclaimer.
Not advice: Nothing on this site is legal, tax, financial or investment advice. Descriptions of regulatory status, tax treatment and market availability are general information that varies by jurisdiction and changes over time. Confirm anything that matters to you with a qualified professional and against primary sources. Trading perpetual futures involves substantial risk of loss, and past performance does not indicate future results.
Disclosure: this site contains referral links. Signing up through the 4% fee discount link earns us a share of the trading fee Hyperliquid already charges, at no extra cost to you.
Ready to Start Trading?
Join Hyperliquid with our referral link and get a 4% fee discount on your first $25M of volume. No KYC, no email - just connect your wallet and trade.
Start Trading - Save 4%