pathiel
Hyperliquid perps from Claude Code with a stop and target on every order
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.7.2
- Listing updated
- today
Similar MCP servers
About pathiel
pathiel is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Orders go through one entry path, place_bracket, which sends the entry, stop-loss and take-profit together. It refuses a bracket that pays under 2R and a stop outside half the distance to liquidation, and set_stop only moves a stop tighter. The default risk profile is 3x leverage, 1% of equity per trade and one position at a time, changed only through update_config.
Without a key the server only reads markets. With an API wallet key it trades real money on mainnet, or test funds when PATHIEL_NETWORK=testnet. The README says the API wallet key can trade but never withdraw. The server signs with a single key, so it cannot touch other accounts, though account read tools accept an address to view any wallet.
Desk briefs for crude oil (Brent and WTI) and metals (gold and silver) on Hyperliquid's HIP-3 markets give a written call to trade from; nothing trades unless you ask. It installs as a Claude Code plugin or runs as the container ghcr.io/julian-dev28/pathiel-mcp over stdio.
Install
Run in a terminal
claude mcp add pathiel -- docker run -i --rm ghcr.io/julian-dev28/pathiel-mcp:0.7.2Add to claude_desktop_config.json
{
"mcpServers": {
"pathiel": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"pathiel": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"pathiel": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"pathiel": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"pathiel": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PATHIEL_NETWORKHyperliquid network: mainnet (the default; real money once a key is set) or testnet (test funds).
Tools this server provides (30)
Taken from the project documentation; the running server may differ.
- get_market
- Market data
- list_markets
- List markets
- get_candles
- Candles
- get_order_book
- Order book
- get_funding_regime
- Funding regime
- get_account
- Account
- get_positions
- Positions
- get_orders
- Orders
- get_history
- History
- get_risk_limits
- Risk limits
- size_trade
- Size a trade
- place_bracket
- Place entry, stop and target
- set_stop
- Tighten a stop
- set_target
- Set a target
- cancel_order
- Cancel an order
- close_position
- Close a position
- set_leverage
- Set leverage
- sweep_brackets
- Check open positions for stops
- list_desks
- List desks
- get_desk_brief
- Desk brief
- refresh_desk
- Refresh a desk
- submit_desk_call
- Submit a desk call
- get_desk_record
- Desk record
- get_status
- Status
- get_config
- Config
- update_config
- Update config
- connect_wallet
- Approve an API wallet
- get_pool_status
- Research pool status
- join_pool
- Join the research pool
- leave_pool
- Leave the research pool
What it does
- Bracket orders
- Entry, stop and target are placed together in a single call.
- Risk sizing
- size_trade sizes a position from the configured risk profile.
- Dry-run mode
- place_bracket with dry_run judges and sizes without sending.
- Desk briefs
- Written calls for oil and metals desks on HIP-3 markets.
- Testnet option
- Practice with test funds by setting PATHIEL_NETWORK=testnet.
- Wallet connect
- connect_wallet makes an API wallet approved with one browser signature.
Good for
- Check order book and funding for a market
- Size a long position against a stop level
- Dry-run a bracket before risking money
- Review open positions and orders for an account
- Run the oil desk's brief and decide on a trade
Pricing
Open source
Free and open source; trading uses your own Hyperliquid account
pathiel FAQ
Does it trade real money?
On mainnet with a key, yes. With no key it only reads, and testnet is one environment variable away.
Can it withdraw funds?
The README says the API wallet key can trade and never withdraw.
How many tools are there?
The README says 30 tools in the plugin install.
How do I run it outside Claude Code?
Use the published container with docker run, or register scripts/pathiel-mcp from a clone.
Is pathiel free?
Yes. pathiel is open source, so you can use and self-host it for free.
How do I add pathiel to Claude Code?
Run this command in your terminal: claude mcp add pathiel -- docker run -i --rm ghcr.io/julian-dev28/pathiel-mcp:0.7.2
What are the best alternatives to pathiel?
The closest alternatives to pathiel are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

