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…

LLM Mart 1 views 97 listing impressions

An AI trading agent for Hyperliquid: Claude trades perps from Claude Code, with an exact stop and target on every order.

Claude Code plugin pathiel MCP server – quality and maintenance score on Glama Listed on mcpservers.org Version 0.7.1 MCP server CI License: MIT

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.

Related servers

Fetch Official

Fetch a web page and hand the agent readable text instead of raw HTML.

stdio
mcp-server-fetch 33 views
Filesystem Official

Give an agent scoped read and write access to directories you choose.

stdio
@modelcontextprotocol/server-filesystem 29 views
Git Official

Read repository history, diffs and branches as tools an agent can call.

stdio
mcp-server-git 27 views

Read-only MCP server for the OrchestKit docs: full-text search + Markdown fetch. No auth.

24 views