Julian-dev28/pathiel

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: 64 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:
bash
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 with an API wallet. 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.
bash
docker run -i --rm --user "$(id -u):$(id -g)" -v "$HOME/.pathiel:/data" \
ghcr.io/julian-dev28/pathiel-mcp:0.5.0
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.
| you type | what answers |
| What's the oil desk's call right now? | desk_brief: direction, entry, stop, target, the R it pays, and "Your size" |
| Show me BTC's order book and funding. | get_l2_book, get_funding_rate |
| What's my balance and what's open? | account_overview |
| What are my risk limits? | risk_limits |
| Size a long on gold with the stop under today's low. | risk_size_trade |
| Dry-run that as a bracket. | place_bracket with dry_run: true: judged and sized, nothing sent |