Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

pathiel

OCI · GHCR.IO/JULIAN-DEV28/PATHIEL-MCP

AI trading agent for Hyperliquid: exact stop and target on every order. Mainnet; testnet opt-in.

0 this week 35 Trust /100

Last scanned (26 minutes ago)

Scores higher than 34% of OCI servers

Category Finance and Payments

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security0
  • No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.Unverified
  • Known CVEs could not be checked: this artifact ships no SBOM or dependency manifest, so there is no dependency list to read.Unverified
  • Install-script risk not yet assessed.Unverified
  • Dependency health could not be checked: this artifact ships no SBOM or dependency manifest, so there is no dependency list to read.Unverified
Provenance & Transparency35
Schema Quality & AI Usability65
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 8022 tokens (~267/item across 30 items; 30 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability check failed: the tool surface changed between 0.6.0 and 0.9.0: 59 tool removals, 1 breaking changes, 24 additions. See how to fix → Fail
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 30 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 31 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities60
  • Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28. See how to fix → Fail

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

What we tested

Checks we ran (12)

  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Checks we could not complete (4)

These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.

  • Malware scan in Supply Chain Security (scores 0 for this)No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.
  • Known CVEs in Supply Chain Security (scores 0 for this)Known CVEs could not be checked: this artifact ships no SBOM or dependency manifest, so there is no dependency list to read.
  • Install scripts in Supply Chain Security (scores 0 for this)Install-script risk not yet assessed.
  • Dependency health in Supply Chain Security (scores 0 for this)Dependency health could not be checked: this artifact ships no SBOM or dependency manifest, so there is no dependency list to read.

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Nov 26 0
    • Package version: 0.7.2 → 0.9.0 functional
    • Package version: 0.7.2 → 0.8.0 functional
  • 17 Nov 26 0
    • Package version: 0.7.1 → 0.7.2 functional
  • 14 Nov 26 −1
    • Stability: 0.00 → fail ▼ security
    • Schema quality: pass → fail ▼ functional
    • Tool coverage: 82% → 100% ▲ functional
    • Schema quality: good → excellent functional
    • Package version: 0.6.0 → 0.7.1 functional
    • Package version: 0.6.0 → 0.7.0 functional
  • 13 Nov 26 36

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed oci/ghcr.io/julian-dev28/pathiel-mcp@0.9.0

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem oci
Reason No attestation published

Background: How many MCP packages publish verified provenance →

MCP tools · 30 exposed · ~7,430 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
cancel_order ~210

LIVE MONEY: acts on the real account. Cancel one resting order by its order id. order_id comes from get_orders; pass coin with it (asset, the numeric index, only when coin is unknown). Cancelling a position's only stop leaves it unprotected: to move a stop use set_stop, and to clear leftover orders on a flat coin use sweep_brackets. Orders cannot be modified in place: to change a resting entry, cancel it here and place a new one with place_bracket. Use for a stale entry or a mistaken order. Needs a trading key. Returns {ok}; an order already filled or cancelled, or a missing coin and asset, returns the venue's {error} with isError true.

NameTypeReqDescription
assetnumber–Numeric asset index, only when coin is unknown.
coinstring–The order's coin, as in get_orders (BTC or xyz:GOLD).
order_idnumberyesThe order id (oid) from get_orders.

No output schema declared.

No examples provided.

close_position ~296

LIVE MONEY: acts on the real account. Close a coin's open position now with one reduce-only market order. Omit fraction (or pass 1) to close it all: the stop and target are then cancelled. fraction between 0 and 1 closes that share (0.5 = half) and keeps the stop and target, which still cover what is left; a share worth under the venue's $10 minimum closes $10 worth. Like any market order it pays the spread and slippage of the book. A flat coin returns ok=true with noop already_flat and sends nothing; closes are never refused for a delisted coin. Afterwards run sweep_brackets on the coin. Use when the user asks to exit now, fully or in part; to exit at a price instead, move the level with set_stop or set_target. Needs a trading key. Returns {closed, result: {total_sz, avg_px, partial, fraction}} or {error} with isError true; a fraction outside (0, 1] is refused with nothing sent.

NameTypeReqDescription
coinstringyesCoin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL).
fractionnumber–Share of the position to close, e.g. 0.5 for half. Omit to close it all.

No output schema declared.

No examples provided.

connect_wallet ~262

Connect the user's Hyperliquid wallet so pathiel can trade: makes a new API wallet key on this machine, opens a local page where the user's browser wallet approves it with one signature, and saves the key to ~/.pathiel/.env.local. The API wallet can trade and never withdraw. status=true reports a connect in progress (waiting, done or failed) and starts nothing; cancel=true stops a waiting one; replace=true swaps a key already set, only when the user said so; open_browser=false prints the page link instead of opening it. Call only when the user asked; get_status shows whether trading is enabled. It returns at once and does not wait for the signature: poll with status=true. With a key already set it keeps that key unless replace=true. A failure returns {ok: false, state: failed, code, error, next} saying what to do. Returns the connect state (waiting, done or failed) and the page link.

NameTypeReqDescription
cancelboolean–stop a waiting connect
open_browserboolean–open the page (default true)
replaceboolean–swap out the key already set; only when the user said so
statusboolean–report the current connect, start nothing

No output schema declared.

No examples provided.

get_account ~249

Get the account's money in one call: total equity across the main perp dex, every HIP-3 dex and spot USDC, withdrawable, whether it can trade (and what blocks it), open positions in brief, plus risk: account leverage, cross margin ratio (1.0 = liquidation) and distance to liquidation. detail=full adds PnL per window (day, week, month, all time), the fee tier and API rate-limit use, for the configured account only. address reads any wallet instead. Use for balance and liquidation-risk questions. For each position in detail use get_positions; for what the risk profile allows use get_risk_limits. Needs a configured account or an address, never a key; with neither it returns {error, no_account: true}. Returns {account, risk}, plus {pnl, fees, rate_limits} with detail=full (ignored with address).

NameTypeReqDescription
addressstring–Any 0x address to read instead of the configured account (read-only; needs no key).
detailstring–summary: equity, margin, risk. full: also PnL history, fees, rate limits (configured account only).

No output schema declared.

No examples provided.

get_candles ~355

Get OHLCV candles for one coin. Returns [{t, o, h, l, c, v}], oldest first, t in unix ms. Two modes: the last `count` candles at `interval` (default 100 x 1h; the newest one may still be forming, so one extra can come back), or a fixed window when start_time is given (end_time defaults to now; count is then ignored). interval is one of Hyperliquid's: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, 1M. Use for trend, levels, volatility and backtests. For the price right now use get_market; for depth use get_order_book. Read-only; needs no key. Window mode returns {coin, interval, start, end, count, candles[]}.

NameTypeReqDescription
coinstringyesCoin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL).
countinteger–How many recent candles (default 100; ignored with start_time).
end_timenumber–Window end (default now). Unix time in milliseconds.
intervalstring–Candle size: 1m, 5m, 15m, 1h, 4h, 1d, ... (default 1h).
start_timenumber–Window start; switches to window mode. Unix time in milliseconds.

No output schema declared.

No examples provided.

get_config ~110

Get the trading config from ~/.pathiel/.agent-config.json: mode (LIVE or OFF), HIP-3 on or off, coin and HIP-3 dex allow and block lists, the risk profile when set, and every other top-level key. Changes nothing. Use before update_config to see current values and key names; for what the risk profile allows in dollars use get_risk_limits, and for whether trading is enabled use get_status. A missing file reads as the defaults. Returns the config object.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_desk_brief ~230

Get one desk's current trade call to trade from: side, entry, stop and targets, the reasoning, and your_size, the size this account would take at those levels under its risk profile and desk share. mode=quick (default) is short markdown with the call first; mode=full adds the evidence (news, levels, scenarios). stale lists what is out of date; when the thesis is stale or its target was hit, call refresh_desk. Use before placing a desk trade with place_bracket. Not for the desk's past accuracy (get_desk_record) or the list of desks (list_desks). Read-only; needs no key. An unknown desk id returns {error: no such desk}. Returns {desk, mode, markdown, your_size: {side, size, notional_usd, leverage, margin_usd}, stale[]}.

NameTypeReqDescription
deskstringyesDesk id from list_desks (oil, metals, ...).
modestring–quick (default): short markdown, the call first. full: adds the evidence.

No output schema declared.

No examples provided.

get_desk_record ~173

Get a desk's graded track record: calls graded, direction hit rate, mean Brier score, mean return, results by outcome, machine calls vs the user's own, and trades taken against each call. grade=true first grades expired calls and closed trades (writes the local journal, places no order); use it when calls have expired since the last grading, else leave it off and read. Use to judge whether a desk's calls deserve trust; for the current call use get_desk_brief. A desk with nothing graded yet returns n_graded 0. Returns {desk, track_record}, or {graded, record} with grade=true.

NameTypeReqDescription
deskstringyesDesk id from list_desks (oil, metals, ...).
gradeboolean–Grade expired calls and trades before reading.

No output schema declared.

No examples provided.

get_funding_regime ~196

Get the market-wide funding regime: whether longs or shorts are paying to hold (crowded) overall and per asset class (crypto, equity, commodity), with the coins whose funding is most extreme (funding as the hourly rate). asset_class narrows the coin list to one class; limit caps it (default 25, max 1000), most extreme first. Use to judge crowding before taking a side. For one coin's funding use get_market; for every coin ranked by funding use list_markets view=funding. Read-only; needs no key. Returns {regime, regimes_by_class, assets[]: {asset, asset_class, funding_rate, regime, oi, volume_24h}, assets_total}.

NameTypeReqDescription
asset_classstring–Only list assets of this class.
limitinteger–Assets listed, most extreme funding first (default 25, max 1000).

No output schema declared.

No examples provided.

get_history ~357

Get the account's ledger, one kind per call. kind=fills (default): executed trades with price, size, side, fee and closed PnL, the latest fills by default, narrowed by coin and limit; start_time and end_time cut a time window (for another wallet, within its newest 2000 fills, the venue's cap). kind=funding: funding paid or received per coin between start_time and end_time. kind=deposits, withdrawals or transfers: money in, out and between perp, spot, sub-accounts and vaults since start_time; withdrawal_id checks one withdrawal's settlement. pathiel cannot move funds (its API wallet can trade, never withdraw), so these are records only. address reads any wallet. Rows come oldest first; limit (default 100, max 2000) keeps the newest. Use for PnL review and audits; for resting or cancelled orders use get_orders. Needs a configured account or an address; with neither it returns {error, no_account: true}. Returns {count, fills[]} for fills and {count, rows[]} for the other kinds.

NameTypeReqDescription
addressstring–Any 0x address to read instead of the configured account (read-only; needs no key).
coinstring–kind=fills or funding: only this coin.
end_timenumber–Until this time (fills and funding). Unix time in milliseconds.
kindstring–Which ledger.
limitinteger–Most rows to return.
start_timenumber–From this time. Unix time in milliseconds.
withdrawal_idstring–kind=withdrawals: the tx hash of one withdrawal to check.

No output schema declared.

No examples provided.

get_market ~237

Get one coin's market snapshot in a single call: mid, mark and oracle price, current funding and the predicted next funding per venue, open interest, 24h volume, previous-day price and max leverage. Use it for any question about one coin right now. Not for many coins at once (list_markets), price over time (get_candles) or depth and slippage (get_order_book). Read-only; needs no key or account. A HIP-3 coin (xyz:GOLD) is read from its own dex. Returns {coin, mid: {price}, context: {funding, openInterest, markPx, oraclePx, midPx, dayNtlVlm, prevDayPx}, funding_next: {venues[]}, max_leverage}; a part the venue cannot answer carries its own error while the rest still returns, and an unknown coin returns {error} with isError true.

NameTypeReqDescription
coinstringyesCoin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL).

No output schema declared.

No examples provided.

get_order_book ~276

Get the live L2 order book for one coin: levels [bids, asks], up to 20 each, every level {px, sz, n orders}. Give size (in coins) or notional_usd, not both, to also walk the book for a market order of that size: average fill, worst price, slippage % and any unfilled amount; is_buy picks the side (default buy). Use before a large entry or exit to judge slippage. For the mid price alone use get_market. Read-only; needs no key. Returns {coin, time, levels}, or {book, impact: {avg_fill_px, worst_px, slippage_pct, filled_usd, unfilled_usd, book_exhausted}} when a size is given; an unknown coin returns {error}.

NameTypeReqDescription
coinstringyesCoin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL).
is_buyboolean–Side of the simulated order (default true: buy).
notional_usdnumber–Order size in USD to simulate (or use size).
sizenumber–Order size in coins to simulate (or use notional_usd).

No output schema declared.

No examples provided.

get_orders ~328

Get orders, one query per call. status=open (default): resting orders on every dex with order type (Stop Market, Take Profit Limit, Limit), trigger price, size and reduce-only flag; this is how to see a position's stop and target. status=history: filled and cancelled orders, newest first. oid or cloid looks up one order and overrides status. coin and limit narrow the list (limit default 100 open, 50 history, max 2000); address reads any wallet. Use before cancel_order (it needs the oid) and to check a position is protected. For executed trades use get_history. Needs a configured account or an address; with neither it returns {error, no_account: true}. Returns {count, orders[]: {coin, oid, side, sz, limitPx, triggerPx, orderType, reduceOnly}} or one order's status.

NameTypeReqDescription
addressstring–Any 0x address to read instead of the configured account (read-only; needs no key).
cloidstring–One order by client order id, 0x + 32 hex (overrides status).
coinstring–Coin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL).
limitinteger–Most rows to return.
oidinteger–One order by order id (overrides status).
statusstring–open: resting now. history: filled and cancelled.

No output schema declared.

No examples provided.

get_pool_status ~160

Get this account's research pool status (the pool is mainnet only): joined or not (and when), what is published and what stays private, the pool's latest counts, the scoreboard URL and how to join or leave. report=true adds your own graded report from your public fills since joining: win rate, mean R with ranges, labelled fluke or edge (members only). Use before join_pool or leave_pool and to see your grade; not for market data or balances (get_account) or your fills (get_history). Reads local files (the report also reads your public fills); signs and publishes nothing. Returns the status object, or {status, report}.

NameTypeReqDescription
reportboolean–Add your own graded trade report (members only).

No output schema declared.

No examples provided.

get_positions ~222

Get open perp positions on every dex (main and HIP-3): coin, signed size (negative = short), entry, position value, unrealized PnL, margin, leverage and liquidation price. coin narrows to one position and, for the configured account, adds the venue's liquidation price for it. address reads any wallet. Use to see what is open before placing, moving or closing anything. For balances use get_account; for the resting stop and target use get_orders. Needs a configured account or an address; with neither it returns {error, no_account: true}. Returns {count, positions[]} (count 0 when flat), or {positions, liquidation: {source, liquidation_price}} with coin.

NameTypeReqDescription
addressstring–Any 0x address to read instead of the configured account (read-only; needs no key).
coinstring–Coin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL).

No output schema declared.

No examples provided.

get_risk_limits ~206

Get what this account may trade under its saved risk profile: positions at once, dollars at risk per trade at the stop, max leverage, the minimum equity to trade and whether each book can trade now, with a one-line headline. equity_usd and preset answer what-if questions (a different account size or preset) and change nothing. Use to explain the limits, or before changing the profile with update_config. To size one specific trade use size_trade; for the raw config use get_config. Needs a configured account unless equity_usd is given (else {error, no_account: true}). A book is one strategy slot the profile allows (desk or manual). Returns {headline, can_trade, max_open_positions, risk_per_trade_usd, max_leverage, books[], notes[]}.

NameTypeReqDescription
equity_usdnumber–What-if equity in USD instead of the account's own.
presetstring–What-if risk preset instead of the saved one.

No output schema declared.

No examples provided.

get_status ~175

Start here. Get the install's status: the trading mode, equity with open positions in brief, and the registered accounts with the one that trades; on a public install also the network (mainnet or testnet), whether trading is enabled (an API wallet key is configured) or read-only, and the builder fee. Use first in a session and whenever an order is refused as read-only. For full balances and liquidation risk use get_account; for settings use get_config. Read-only. With no wallet connected it still answers, showing trading as read-only; a venue that cannot be reached shows in the equity fields. Returns {status: {mode, equity, equity_by_dex, positions, install (public installs): {network, trading, builder_fee}}, accounts: {count, accounts[], bot_trades_with}}.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

join_pool ~183

Join the research pool, which grades your public fills on a public scoreboard. Two steps: without confirm it shows the exact statement and signs nothing; with confirm=true and the joined_at that first call returned, it SIGNS that statement with your key and writes the member file for a pull request. No order is placed and no money moves. Call only when the user asked to join, and confirm only after they read the statement. Check get_pool_status first. Needs a trading key and mainnet: on testnet it returns {error, code: testnet} and signs nothing. The user opens the pull request; leave_pool undoes it. Returns the statement, then the signed member file path.

NameTypeReqDescription
confirmboolean–true only after the user read the statement and said yes
joined_atstring–the joined_at value the dry run returned

No output schema declared.

No examples provided.

leave_pool ~196

Leave the research pool: the next scoreboard build drops your address and every row of it, and the leave stays in force until a later join. Two steps: without confirm it shows the exact statement and signs nothing; with confirm=true and the left_at that first call returned, it SIGNS that statement with your key and writes the leave file, which the user opens a pull request with, as for join_pool. No order is placed and no money moves. Call only when the user asked to leave, and confirm only after they read the statement; check membership first with get_pool_status. Needs a trading key and mainnet: on testnet it returns {error, code: testnet} and signs nothing. Returns the statement, then the signed leave file path.

NameTypeReqDescription
confirmboolean–true only after the user read the statement and said yes
left_atstring–the left_at value the dry run returned

No output schema declared.

No examples provided.

list_desks ~111

List every trading desk (crude oil, metals, ...) as a one-line card: id, primary coin, mid, 1-day return, the latest call's side and one-liner, how old the thesis is, the next catalyst and the track record. Use first to pick a desk, then get_desk_brief for its full call; for raw market listings use list_markets instead. Reads the local desk journal and live mids; needs no key. Returns {count, desks[]}.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_markets ~285

List many coins at once, one board per call, to scan or rank the market. view=instruments (default): tradable perps and spot, highest 24h volume first, each with max leverage, funding, open interest and mid; query, type and limit narrow this view only. view=mids: every mid price (coins narrows it). view=funding: every coin by hourly funding. view=open_interest: the top 100 by open interest. view=assets: size decimals and max leverage per main-dex perp, for order sizing. limit defaults to 50 (max 1000). For one coin's full snapshot use get_market instead; for price history use get_candles. Read-only; needs no key. Returns {instruments[], counts, matched} for instruments, {count, mids} for mids, {count, rows[]} for funding and open_interest, and {count, assets[]} for assets; a venue failure returns {error} with isError true.

NameTypeReqDescription
coinsarray–view=mids: only these coins.
limitinteger–view=instruments: most rows to return.
querystring–view=instruments: keep names containing this text.
typestring–view=instruments: perps or spot only.
viewstring–Which board to return.

No output schema declared.

No examples provided.

place_bracket ~539

LIVE MONEY: acts on the real account. Open one trade as a bracket: an entry plus an exact stop-loss and take-profit, sized by the risk profile exactly as size_trade reports. The side follows the levels (stop below the entry or mark is a long). entry_px rests a limit order and the stop and target attach when it fills; omit entry_px to enter at market now. The take-profit is placed 0.5% inside tp_px so it fills before the level (the result shows both). leverage defaults to the profile's max and is set on the coin first. Refused, with nothing sent: reward to risk under min_r (never below 2R), a stop outside half the distance to liquidation, a coin not listed on this network, or a second position or resting entry on the coin, unless add=true, which tops an open same-side position up to full size with a stop no wider than the current one. dry_run=true runs every check and returns the sizing without placing. Call only when the user asked for this trade; size it first with size_trade, adjust it later with set_stop or set_target, exit with close_position. Needs a trading key. Returns {ok, placed, mode, entry_px, stop_px, tp_px, size, leverage, result, network, builder_fee}; a refusal is ok=false, placed=false with the reason. If a market entry fills but the venue refuses the stop, the result is ok=false, placed=true, reason "FILLED WITHOUT A STOP": place one at once with set_stop.

NameTypeReqDescription
addboolean–Top up an open same-side position to full size; the new stop may not be wider than the current one.
coinstringyesCoin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL).
dry_runboolean–true: size and check the order, place nothing.
entry_pxnumber–Limit entry price: the order rests there and the stop and target attach on fill. Omit to enter at market.
leveragenumber–Leverage for the coin, capped by the risk profile's max leverage.
min_rnumber–Least reward-to-risk to accept; never below the 2R floor.
stop_pxnumberyesStop-loss price: below the entry for a long, above it for a short.
tp_pxnumberyesTake-profit price: above the entry for a long, below it for a short.

No output schema declared.

No examples provided.

refresh_desk ~172

Write a NEW thesis for one desk: pulls fresh market data, news, policy and odds, then makes one local Claude Code call (about a minute, billed to the local Claude Code plan; needs the claude CLI on PATH, else it fails fast). A refresh already running for the desk is joined, not repeated; force=true refreshes even when the desk's data is still fresh. Writes only the local desk journal; places no order. Use when get_desk_brief says the thesis is stale or its target was hit; otherwise read the current call with get_desk_brief. Returns the new call or the error.

NameTypeReqDescription
deskstringyesDesk id from list_desks (oil, metals, ...).
forceboolean–true: refresh even when a recent refresh exists.

No output schema declared.

No examples provided.

set_leverage ~219

LIVE MONEY: acts on the real account. Set a coin's leverage, a whole number from 1 up to the coin's max (default 5 when omitted). It is capped by the risk profile's max_leverage and refused above it (raise the cap with update_config first). An open position keeps its own margin type (cross or isolated); a venue refusal, such as leverage too low for the margin in use, comes back as an error. place_bracket already sets leverage when given one, so call this alone only to change an open position or prepare a coin. Confirm with get_positions. Needs a trading key. Returns {ok, coin, leverage} or the error.

NameTypeReqDescription
coinstringyesCoin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL).
leveragenumber–Whole number from 1 to the coin's max, at most the profile cap (default 5 when omitted).

No output schema declared.

No examples provided.

set_stop ~307

LIVE MONEY: acts on the real account. Move an open position's stop-loss tighter, toward the mark, to lock in gains or cut risk; never wider. One stop for the whole position goes on first, then every older stop on the coin is cancelled, so the position is never unprotected and a refused new order leaves the old one in place. Refused: no open position, a stop past the mark (it would fire at once), or a stop wider than or equal to the current one (a long's new stop must be above it, a short's below). With no stop at all, any stop on the right side of the mark is placed. Never changes the target or the size. To widen a stop, close and re-enter with place_bracket; to move the target use set_target; to fold duplicate stops left by several fills use sweep_brackets. Needs a trading key. Returns {ok, stop_px, size, mark, replaced: old stop prices}; a refusal is {ok: false, reason, mark, current_stop} with isError true and nothing sent.

NameTypeReqDescription
coinstringyesCoin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL).
stop_pxnumberyesNew stop: above the current stop for a long, below it for a short, and on the safe side of the mark.

No output schema declared.

No examples provided.

set_target ~240

LIVE MONEY: acts on the real account. Move an open position's take-profit to tp_px. One limit take-profit for the whole position goes on first, then every older target on the coin is cancelled, so the position always has a target and a refused new order leaves the old one in place. Refused: no open position, or a target on the losing side of the mark (it would fill at once). Never changes the stop or the size. Use to raise or lower a target. To move the stop use set_stop; to exit now use close_position; to fold duplicate targets left by several fills use sweep_brackets. Needs a trading key. Returns {ok, tp_px, size, replaced: old target prices}; a refusal is {ok: false, reason} with isError true and nothing sent.

NameTypeReqDescription
coinstringyesCoin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL).
tp_pxnumberyesNew target: above the mark for a long, below it for a short.

No output schema declared.

No examples provided.

size_trade ~345

Size one trade before placing it, with the rules place_bracket uses: size, notional, leverage, margin, dollars at risk at the stop, payoff at each target and the liquidation price, plus the most this account's margin allows on the coin. The side follows the levels: stop below entry is a long, above is a short. targets adds a payoff per target price; leverage overrides the default (capped by the profile); equity_usd sizes a what-if account and skips the margin check. Use before every place_bracket; never size a trade by hand. Places nothing. Needs a configured account unless equity_usd is given. Returns {sizing: {side, size, notional_usd, leverage, margin_usd, risk_usd, risk_pct, targets[], liq_px, reason, warnings[]}, max_by_margin}, or the sizing alone for a what-if. A trade that cannot be sized (stop at the entry, equity too small) comes back can_trade false with size null and the reason.

NameTypeReqDescription
coinstringyesCoin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL).
entry_pxnumberyesPlanned entry price.
equity_usdnumber–What-if equity in USD instead of the account's own.
leveragenumber–Leverage to size at (capped by the profile).
stop_pxnumberyesPlanned stop: below entry for a long, above for a short.
targetsarray–Target prices to report the payoff for.

No output schema declared.

No examples provided.

submit_desk_call ~241

Record the user's own trade call on a desk in the local journal (author=user), graded later beside the machine's theses in get_desk_record. call needs side (long, short, flat or pair), instrument, a one-liner of at most 160 characters, confidence from 0 to 1 and the invalidation; entry_px (or an entry_zone [lo, hi]), stop_px, targets and leverage are optional. scenarios, when given, are {name, probability, move_lo_pct, move_hi_pct (percent moves), description, triggers[]} whose probabilities sum to 1; a call that breaks a rule returns {error} naming it. Places no order and changes no config. Use when the user states a view they want tracked; to trade it use place_bracket. Returns the journaled call.

NameTypeReqDescription
callobjectyesThe trade in one shot.
deskstringyesDesk id from list_desks (oil, metals, ...).
notesstring–Free-text notes kept with the call.
scenariosarray–Optional probability-weighted outcome scenarios, must sum to 1

No output schema declared.

No examples provided.

sweep_brackets ~259

LIVE MONEY: acts on the real account. Tidy one coin's protective orders (one coin per call). On a flat coin it cancels stops and targets left behind after a stop or target fired (a resting entry's own attached stop and target are kept) and lists resting entries. With an open position it checks the stop covers the full size and folds several stops or targets at one price (one per fill) into a single pair, placing the new order before cancelling the old ones. Never opens, closes or moves a level. Run it after every close or fill; to move a level use set_stop or set_target. Needs a trading key. Returns {ok, position, stop_px[], tp_px[], stop_covers} with an open position, or {ok, position: 0, cancelled_stranded, resting_entries[]: {oid, px, sz}} when flat; ok=false with reason "POSITION NOT FULLY COVERED BY A STOP" means place one now with set_stop.

NameTypeReqDescription
coinstringyesCoin: a main-dex perp by name (BTC, ETH) or a HIP-3 perp as dex:SYMBOL (xyz:GOLD, xyz:BRENTOIL). One coin per call.

No output schema declared.

No examples provided.

update_config ~291

Change the trading config on this machine; it applies at once to every later order. Pass only the keys to change: mode (LIVE or OFF), enable_hip3, coin_allowlist, coin_blocklist, hip3_dex_allowlist, hip3_dex_blocklist, or any other top-level key get_config shows, such as risk_profile; nested objects merge into the current ones and a list replaces the old list. mode is a label only: OFF does not stop the live-money tools. A call with nothing to change is refused. Read current values with get_config first, and call only when the user asked for this exact change. Not for one coin's leverage (set_leverage) or for sizing questions (get_risk_limits). Returns the updated config.

NameTypeReqDescription
coin_allowlistarray–Only these coins (empty: all).
coin_blocklistarray–Never these coins.
enable_hip3boolean–Allow HIP-3 markets (xyz:, vntl:, ...).
hip3_dex_allowlistarray–Only these HIP-3 dexes (empty: all).
hip3_dex_blocklistarray–Never these HIP-3 dexes.
modestring–Agent mode label, LIVE or OFF, read by the preflight check and metrics. The live-money tools here do not refuse on OFF.

No output schema declared.

No examples provided.

Install

How do I install the pathiel MCP server?

pathiel runs locally as a container image, launched with docker run --rm -i -e PATHIEL_NETWORK ghcr.io/julian-dev28/pathiel-mcp:0.9.0, plus the required -v, which you supply. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

oci · ghcr.io/julian-dev28/pathiel-mcp

# add to Claude Code
claude mcp add julian-dev28-pathiel -- docker run --rm -i -e PATHIEL_NETWORK ghcr.io/julian-dev28/pathiel-mcp:0.9.0

This image reads PATHIEL_NETWORK. Set it in your client's env block for this server; docker run -e passes it through to the container. Incomplete: the registry marks -v as required and gives no value we can show, so it is not in this command. Add it before you run it.

Common questions

What is the pathiel MCP server?

pathiel is an MCP server listed in the public MCP registry as io.github.Julian-dev28/pathiel. AI trading agent for Hyperliquid: exact stop and target on every order. Mainnet; testnet opt-in. This page covers its container image (ghcr.io/julian-dev28/pathiel-mcp).

Is the pathiel MCP server safe to use?

pathiel scores 35 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the pathiel MCP server expose?

pathiel exposes 30 tools: get_market, list_markets, get_candles, get_order_book, get_funding_regime, and 25 more. Their descriptions and schemas cost roughly 7,430 tokens of context every time the server is loaded.

Is the pathiel MCP server still maintained?

pathiel is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What did VerifyMCP test on the pathiel MCP server?

VerifyMCP ran 12 checks on pathiel, covering Source repository, Provenance, License, Maintenance and 8 more. 4 items could not be completed, a gap on our side rather than a finding about pathiel: Malware scan, Known CVEs, Install scripts and Dependency health. One category scores 0 for that reason, because we only credit what we can confirm. Endpoint Security and Transport & Reachability do not apply to a container image, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.