Skip to content
MCP server

pathiel

Hyperliquid perps from Claude Code with a stop and target on every order

Runs locallyStatus and history
Install
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.2

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pathiel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pathiel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers