# Hyperliquid Guide

> Hyperliquid Guide is an open-source MCP server for developer tools. Hyperliquid market specs, order rounding and funding lookups for trading agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://hyperliquidguide.com/build
- **Repository:** https://github.com/hyperliquidguide/hyperliquid-starter-bots
- **MCP Registry name:** io.github.Hyperliquidguide/hyperliquid-guide
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [trading analysis](https://ai-powered.com/categories/trading-analysis), [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-22

## About

This local MCP server comes with a set of open-source Hyperliquid starter bots written in Python. It lets a coding agent look up live market specs, round an order to valid tick and lot sizes, rank markets by funding and explain a rejected order, instead of guessing.

By default it holds no keys and places no orders; order tools load only if you opt in, and then only with an API wallet. The repository also includes five readable bots (market maker, scalper, grid, funding arbitrage and TWAP), each with dry-run mode, testnet by default and built-in risk limits.

The bots are teaching code with no promised returns, and real money can be lost.

## Features

- **Market specs lookup:** Fetches live specifications for Hyperliquid markets, including HIP-3 markets.
- **Order rounding:** Rounds prices and sizes correctly before an order is placed.
- **Funding ranking:** Ranks markets by funding rate.
- **Error explanations:** Explains why an order was rejected.
- **Opt-in order tools:** Order placement is off by default and needs an API wallet.
- **Starter bots:** Market maker, scalper, grid, funding arb and TWAP with risk guards.

## Good for

- Have a coding agent build a Hyperliquid strategy on testnet
- Get the correct rounding before placing an order
- Find markets with high funding for a basis trade
- Pull a starter bot's source to adapt it

## Install

### Claude Code (Terminal)

```sh
claude mcp add hyperliquid-guide -- uvx hyperliquid-starter-bots
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hyperliquid-guide": {
      "command": "uvx",
      "args": [
        "hyperliquid-starter-bots"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hyperliquid-guide": {
      "command": "uvx",
      "args": [
        "hyperliquid-starter-bots"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hyperliquid-guide": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hyperliquid-starter-bots"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hyperliquid-guide": {
      "command": "uvx",
      "args": [
        "hyperliquid-starter-bots"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hyperliquid-guide": {
      "command": "uvx",
      "args": [
        "hyperliquid-starter-bots"
      ]
    }
  }
}
```

## FAQ

### Does Hyperliquid Guide place orders by default?

No. It is read-only by default and holds no keys; order tools must be enabled.

### What does the setup need?

Python 3.10 or newer and testnet USDC for the testnet bots.

### Is Hyperliquid Guide free?

Yes, the bots and tooling are open source.

### Does Hyperliquid Guide promise returns?

No. The bots are teaching code and real money can be lost.

### How do I add Hyperliquid Guide to Claude Code?

Run this command in your terminal: claude mcp add hyperliquid-guide -- uvx hyperliquid-starter-bots

### What are the best alternatives to Hyperliquid Guide?

The closest alternatives to Hyperliquid Guide are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/hyperliquid-guide
