Alpaca Trading API integration for Model Context Protocol (MCP)
pathiel is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
AI trading agent for Hyperliquid: exact stop and target on every order. Mainnet; testnet opt-in.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user pathiel-mcp '--' docker run -i --rm -v '<pathiel_home>:/data' ghcr.io/julian-dev28/pathiel-mcp:0.7.1
# 2 — ask your agent for something these tools do
# state, market_get_asset_data, market_get_funding_regime and 48 more
Put your own value in place of <pathiel_home> before you run this.
pathiel costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts pathiel as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. It has not been scanned here, so read the surface, and its source, before you approve it.
This is a public server: you run it yourself and this marketplace is not in the path. You need Docker installed and running. Put your own value in place of <pathiel_home> before you run this. Only the required variables are passed into the container. To set an optional one (PATHIEL_NETWORK), add -e NAME before the image name and give it a value in the entry’s env: an unset -e would clear the default the image sets. Claude Code registers it in one command; --scope user makes it available in every project. The '--' is in quotes so that PowerShell passes it on.
claude mcp add --scope user pathiel-mcp '--' docker run -i --rm -v '<pathiel_home>:/data' ghcr.io/julian-dev28/pathiel-mcp:0.7.1Reconnect, or start a new session, and the tools appear in the model’s tool list.
Nothing is required, but it can take PATHIEL_NETWORK (Hyperliquid network: mainnet (the default; real money once a key is set) or testnet (test funds).) if you want to set it.
One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.
51 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Read from its source code. A server that builds its tool list when it starts can list more tools than this.
Get full agent state: mode, config, positions, recent trades, and account equity.
No parameter schema on file.
Get comprehensive asset data: candles + funding + OI.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| asset | string | yes | Coin ticker (e.g. BTC) |
| intervals | array | no | Candle intervals (default ["5m","15m","1h","4h"]) |
| count | integer | no | Newest candles kept per interval (default 48, max 500). |
Market-wide funding regime (crowded trades): overall and per asset
| Parameter | Type | Required | Notes |
|---|---|---|---|
| asset_class | string | no | Only list assets of this class. |
| limit | integer | no | Assets listed, most extreme funding first (default 25, max 1000). |
Tradable instruments (perps + spot), highest 24h volume first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | Substring of the symbol, e.g. "xyz:" or "OIL". |
| type | string | no | — |
| limit | integer | no | Max rows (default 50, max 1000). |
Close a position for a specific coin.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | Coin ticker (e.g. BTC, ETH) |
Get current mid price for a coin. Also answers get_coin_price.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | no | Coin ticker (default BTC) |
Candles for a coin and interval, lookback by count. Also answers
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | no | Coin ticker (default BTC) |
| interval | string | no | Candle interval (default 1h) |
| count | number | no | Number of candles (default 100) |
Set leverage for a coin. With an open position the position's own margin type (isolated or cross) is kept; flat, the market default applies. A venue refusal is an error.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | Coin ticker (e.g. BTC) |
| leverage | number | no | Leverage value (default 5) |
Cancel an open order by order ID and coin.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| order_id | number | yes | — |
| coin | string | no | e.g. xyz:BRENTOIL |
| asset | number | no | index, if no coin |
Get user fee tiers and rates. Also answers get_user_fees_detailed.
No parameter schema on file.
L2 order book for a coin. Also answers get_market_depth.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | Coin ticker (e.g. BTC) |
Raw clearinghouse state for ONE perp dex (default: main). HIP-3 money
| Parameter | Type | Required | Notes |
|---|---|---|---|
| dex | string | no | Perp dex name, e.g. "xyz" (default: main). |
This account's withdrawals, from the non-funding ledger.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| startTime | number | no | Start time, unix ms (default: all history) |
| limit | number | no | Max entries to return (default 100) |
| user | string | no | Account address (optional; defaults to this deployment's) |
Candles for a coin over a time window (default last 100 hours).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | Coin ticker |
| interval | string | no | Candle interval (default 1h) |
| start_time | number | no | Start, unix seconds or ms |
| end_time | number | no | End, unix seconds or ms (default now) |
This account's deposits, from the non-funding ledger.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| startTime | number | no | Start time, unix ms (default: all history) |
| limit | number | no | Max entries to return (default 100) |
| user | string | no | Account address (optional; defaults to this deployment's) |
This account's internal, spot, sub-account and vault transfers.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| startTime | number | no | Start time, unix ms (default: all history) |
| limit | number | no | Max entries to return (default 100) |
| user | string | no | Account address (optional; defaults to this deployment's) |
The MOST this account's margin allows on a coin (the coin's own dex
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | Coin ticker |
| is_buy | boolean | no | True to buy (default), False to sell |
Account value and PnL per HL window (day/week/month/allTime): latest
| Parameter | Type | Required | Notes |
|---|---|---|---|
| full | boolean | no | Return every point of every series (large). |
Get detailed info for a specific coin.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | Coin ticker |
Current mid prices, including HIP-3 (xyz:, vntl:, km:, ...). Prediction
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coins | array | no | Only these coins. |
| include_outcomes | boolean | no | Also return #id prediction markets. |
Order status by order ID. Also answers get_order_status.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| user | string | no | Account address (optional; defaults to this deployment's) |
| oid | number | yes | Order ID |
| orderId | number | no | Alias of oid |
Equity (main dex + HIP-3), available margin, withdrawable, notional, position count.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| user | string | no | Account address (optional; defaults to this deployment's) |
Open positions across main dex and HIP-3; pass coin to filter.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | no | Coin ticker (optional filter) |
| user | string | no | Account address (optional; defaults to this deployment's) |
Get 24-hour statistics for a coin.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | Coin ticker |
Current hourly funding for one coin, or the whole board sorted by
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | no | Coin ticker (optional) |
Unrealized pnl per open position plus HL's day/week/month/all-time pnl.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| user | string | no | Account address (optional; defaults to this deployment's) |
Equity across every dex, account leverage, main-dex cross margin ratio
| Parameter | Type | Required | Notes |
|---|---|---|---|
| user | string | no | Account address (optional; defaults to this deployment's) |
Open interest for a coin (HIP-3-aware), or the top 100 by OI when omitted.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | no | Coin ticker (optional) |
Get API rate limit status.
No parameter schema on file.
Get Hyperliquid server time.
No parameter schema on file.
Get user's order history with filtering.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | number | no | Max orders (default 100) |
Walk the live L2 book for a trade and report avg fill, worst price,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | Coin ticker |
| size | number | no | Trade size in COIN units |
| notionalUsd | number | no | Trade size in USD (overrides size) |
| is_buy | boolean | no | True to buy (default), False to sell |
Whether a withdrawal settled (by tx hash), or the 20 most recent withdrawals.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| withdrawal_id | string | no | Withdrawal tx hash (optional) |
| user | string | no | Account address (optional; defaults to this deployment's) |
Venue liquidation price for an open position (pass coin only), or HL's isolated-margin estimate for a hypothetical one (pass leverage + is_long).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | Coin ticker |
| leverage | number | no | Leverage (hypothetical position) |
| is_long | boolean | no | Side (hypothetical position) |
| entry_px | number | no | Entry price (default current mid) |
| size | number | no | Position size, echoed back; liquidation price does not depend on it |
| user | string | no | Account address (optional; defaults to this deployment's) |
Maximum allowed leverage for a coin (HIP-3-aware: xyz:CL, vntl:NVDA,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | Coin ticker |
Get user fills within a time window (unix ms).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| start_time | number | yes | Start time (unix ms) |
| end_time | number | no | End time (unix ms, optional) |
Historical (filled + cancelled) orders, newest first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | no | Only this coin. |
| limit | integer | no | Max orders (default 50, max 2000). |
| user | string | no | Account address (default: the trading account). |
Order status by client order ID (0x-prefixed 16-byte hex).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| user | string | no | Account address (optional; defaults to this deployment's) |
| cloid | string | yes | Client order ID |
Every desk's one-line card: tagline, primary coin, mid, 1d return,
No parameter schema on file.
One desk's current call. mode=quick (default): short markdown, the
| Parameter | Type | Required | Notes |
|---|---|---|---|
| desk | string | yes | Desk id, e.g. "oil" |
| mode | string | no | — |
Refresh a desk: market data, news/policy/odds, then a NEW thesis via
| Parameter | Type | Required | Notes |
|---|---|---|---|
| desk | string | yes | Desk id, e.g. "oil" |
| force | boolean | no | Rewrite the thesis even if nothing material changed |
Record your own trade call on a desk (author=user), journaled
| Parameter | Type | Required | Notes |
|---|---|---|---|
| desk | string | yes | Desk id, e.g. "oil" |
| call | object | yes | The trade in one shot. |
| scenarios | array | no | Optional probability-weighted outcome scenarios, must sum to 1 |
| notes | string | no | — |
Graded-thesis track record for one desk: hit rate, mean Brier, mean
| Parameter | Type | Required | Notes |
|---|---|---|---|
| desk | string | yes | Desk id, e.g. "oil" |
Grade now: expired theses, then accounts' trades vs each call. desk
| Parameter | Type | Required | Notes |
|---|---|---|---|
| desk | string | no | — |
The active account's money: total equity, where it sits (each perp
No parameter schema on file.
Hyperliquid accounts registered in pathiel (connected wallets, API
No parameter schema on file.
What the account may trade under its risk profile: positions at once,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| equity_usd | number | no | — |
| preset | string | no | — |
Size ONE trade for the active account: size, margin, $ at risk, payoff
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | e.g. xyz:CL (WTI), BTC |
| entry_px | number | yes | — |
| stop_px | number | yes | Below entry = long, above = short. |
| leverage | number | no | Capped by coin and profile max. |
| targets | array | no | — |
| equity_usd | number | no | What-if equity (default: live). |
One trade with exact stop and take-profit, sized like
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | e.g. xyz:BRENTOIL |
| entry_px | number | no | — |
| stop_px | number | yes | — |
| tp_px | number | yes | — |
| leverage | number | no | — |
| min_r | number | no | — |
| dry_run | boolean | no | — |
| add | boolean | no | Top up an open same-side position to the full-port size; the stop may not be wider than the one resting. |
Flat: cancel leftover reduce-only orders (sibling of a fired
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | — |
Move an open position's take-profit: one limit target for the whole
| Parameter | Type | Required | Notes |
|---|---|---|---|
| coin | string | yes | — |
| tp_px | number | yes | — |
- Every tool, no call limit
- No card, and mcprush charges nothing for it
- Source published under MIT
- Runs on your machine — nothing of it reaches our gateway
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install pathiel or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing ships as a container image. The scanner reads packages on npm and PyPI and public source; an image is neither, so there is no grade here — not a withheld one, an unmeasured one.
Release history
It installs from a container image rather than from a versioned package, so the command cannot be pinned to a release. The history below is for reading; the current release on file is 0.7.0.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish pathiel can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.