Pathiel
AI trading agent for Hyperliquid: Claude trades perps through MCP with an exact stop and target on every order, 3x / 1% risk by default, oil and metals desk bri…
An AI trading agent for Hyperliquid: Claude trades perps from Claude Code, with an exact stop and target on every order.
Real money. A public install runs on Hyperliquid mainnet. With no key it only reads; once you add a key, orders are real. Read Before you trade first. Practice on testnet with one line:
PATHIEL_NETWORK=testnet.
What it does
pathiel is a free, open-source Hyperliquid MCP server and Claude Code plugin: 30 tools that read Hyperliquid perpetual futures (perps) markets and your account, and place orders, from Claude Code, Claude Desktop, Cursor or any MCP client. Every trade is one bracket order: an entry, a stop-loss and a take-profit target, sized from your risk profile (3x and 1% of equity per trade by default). Desk briefs for crude oil (Brent and WTI) and metals (gold and silver) on Hyperliquid's HIP-3 markets give Claude a written call to trade from; nothing trades unless you ask.
Install in 30 seconds
In Claude Code:
/plugin marketplace add Julian-dev28/pathiel
/plugin install pathiel@pathiel
/pathiel:setup
From a shell instead:
claude plugin marketplace add Julian-dev28/pathiel
claude plugin install pathiel@pathiel
Claude Code v2.1.275 or later also takes the first two lines as one:
/plugin install pathiel --marketplace Julian-dev28/pathiel. If Claude Code
says Run /reload-plugins to apply, do that, then run /pathiel:setup.
/pathiel:setup shows the network and the risks, builds a private Python
environment, creates ~/.pathiel/.env.local (mode 600) for your keys, seeds
the default risk profile, checks the install without printing any key, and
connects the MCP server. The steps are in commands/setup.md.
You need Claude Code, Python 3.11 or later, and for trading a Hyperliquid account and a browser wallet (or an API wallet you make in the Hyperliquid app). Reading markets needs no account. docs/GETTING_STARTED.md walks through the account setup.
Other MCP clients
Cursor, Claude Desktop, Pathiel Agent and any other MCP client register the
launcher scripts/pathiel-mcp from a clone as the server command, or run the
published container (amd64 and arm64). It is listed in the official MCP
registry as io.github.Julian-dev28/pathiel.
docker run -i --rm --user "$(id -u):$(id -g)" -v "$HOME/.pathiel:/data" \
ghcr.io/julian-dev28/pathiel-mcp:0.7.1
To build it yourself: docker build -f Dockerfile.mcp -t pathiel-mcp .
Both are the public install: keys and config come from ~/.pathiel, with
the same default network, profile and fee rules as the plugin. Starting
scripts/pathiel-mcp-server.py directly, or accepting the repo .mcp.json
when you open a clone in Claude Code, is the maintainer path (see
Maintainer setup).
First prompts to try
Paste these into Claude Code once /mcp shows pathiel connected.
From the project's README.