# pathiel

> pathiel is an open-source MCP server for finance and payments. Hyperliquid perps from Claude Code with a stop and target on every order. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux
- **Repository:** https://github.com/julian-dev28/pathiel
- **MCP Registry name:** io.github.Julian-dev28/pathiel
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add pathiel -- docker run -i --rm ghcr.io/julian-dev28/pathiel-mcp:0.7.2
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pathiel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pathiel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pathiel": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pathiel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pathiel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/julian-dev28/pathiel-mcp:0.7.2"
      ]
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/pathiel
