Skip to content

MCP tool reference ​

Complete, source-verified inventory of both MCP servers. Audited 2026-11-17 against src/mcp/server.ts (TypeScript execution server) and lib/mcp.js (JavaScript research server). Nothing on this page is aspirational: a tool listed here is registered in the source, and its schema is the registered schema.

Two surfaces, one rule ​

ServerStart withToolsFile
TypeScript execution serverfurlpay mcp --wallet <name>35src/mcp/server.ts
JavaScript research serverfurlpay mcp29lib/mcp.js

A default install cannot move funds on either surface. Every value-moving tool is structurally ABSENT from tools/list until the operator starts the server with --enable-execution AND a configured agent policy exists — execution mode refuses to start (exit 47) without one. Even in execution mode, mutating tools cannot be called directly: they require the two-phase protocol (preview → confirm). This is proven at the process level by test/mcp-hardening.test.js (spawn-level E2E).

Two-phase execution protocol ​

  1. furlpay_preview_execution { tool, args } — sanitizes arguments (control-char/ANSI stripping, length caps), binds them to a one-time executionHash, returns the net effect. Executes nothing.
  2. furlpay_confirm_execution { executionHash } — executes the stored arguments. Single-use, 10-minute TTL, agent-policy gate re-run on the STORED amount (a confirm call can never smuggle a bigger number past the spend caps). Attempts count against the rolling 30/min mutating rate limit even when refused; every call — allowed or refused — appends an audit line (agent, mode, tool, args hash only) to ~/.furlpay/mcp-audit.jsonl.

Direct dispatch of a mutating tool errors with EXECUTION_MODE_REQUIRED (read-only mode) or TWO_PHASE_REQUIRED (execution mode).


TypeScript execution server — 35 tools ​

Always available (read-only) ​

ToolRequiredOptionalWhat it doesStatus
furlpay_get_hlp_yield——Live HLP vault equity/APY/PnL from the live /info response; unreported fields → null, never fabricatedLIVE
furlpay_balance—accountBalances across Stellar native assets, USDC, RWAs. Unauthenticated mode returns sample fixtures flagged simulated: trueSIMULATED (unauthenticated)
furlpay_get_quotesourceAsset, targetAsset, amount—Multi-hop quotes across SDEX and Soroban AMMsSIMULATED
furlpay_list_chains——Chain registryLOCAL
furlpay_list_exchanges——Exchange/adapter registryLOCAL
furlpay_market_searchquerychainMarket search across venuesLIVE (venue data)
furlpay_get_market_datasymbol—Mark price, funding, OI for a perpetual marketLIVE
furlpay_get_orderbooksymboldepthLevelsL2 book snapshotLIVE
furlpay_get_fundingsymbol—Funding rate historyLIVE
furlpay_get_market_analysissymbol—Microstructure analysis (OBI, micro-price)LIVE (feed)
furlpay_compare_marketsasset—Cross-venue comparison for an assetLIVE
furlpay_positions—userAddressClearinghouse positionsLIVE (read)
furlpay_open_orders—userAddressResting ordersLIVE (read)
furlpay_portfolio_risk——Margin ratio / account risk evaluationLIVE (read)
furlpay_preview_tradesymbol, side, sizeleverage, pricePre-trade risk evaluation of a hypothetical order — executes nothingLIVE (evaluation)
furlpay_get_rwa_assets——Tokenized securities catalog; SEP-8 status is never claimedLOCAL registry
furlpay_get_rwa_quoteasset, amount—Indicative RWA quoteSIMULATED
furlpay_finance_overview——Read-only finance layer overview (accounts, spend limits, settlement capabilities)LOCAL ledger
furlpay_finance_ledger—reconcile, limitLedger view or full reconciliation report (balanced count, chain integrity)LOCAL ledger
furlpay_finance_spend—unitSpend report: window usage against limitsLOCAL ledger
furlpay_finance_treasury——Treasury balances (available vs reserved), inflow/outflowLOCAL ledger
furlpay_finance_billing—sinceIsoBilling summary; fees reported separately from volumeLOCAL ledger
furlpay_finance_payments—limit, inspectPayment history; states are the ledger's own (submission ≠ settlement)LOCAL ledger
furlpay_oracle_priceasset—Multi-source USD quote (Coinbase/Kraken/Binance/Jupiter), median + cross-source agreement gate. DISAGREEMENT/UNAVAILABLE carry a null priceLIVE (read-only)
furlpay_solana_cluster_status——Live Solana RPC reads (epoch/slot/block height). No signing path existsLIVE (read-only)
furlpay_preview_executiontool, args—Two-phase step 1: bind args to a one-time hash, show net effectGATE (executes nothing)

Hidden by default — execution mode + policy + two-phase required ​

ToolRequiredOptionalWhat it doesStatus
furlpay_settle_invoicechallengeHeadermaxCostSettle an x402 HTTP 402 challenge behind agent-policy checks (OFAC/SDN, velocity, spend caps). Policy gate records the spend atomicallySIMULATED (SIMULATED / LOCAL_SIMULATION labels)
furlpay_sweep_treasuryamountUsdtarget (HLP default / FOBXX)Idle-USDC sweep. HLP: real signed vault transfer (policy-gated). FOBXX: labeled simulated. A missing amountUsd is refused, never defaultedLIVE (HLP) / SIMULATED (FOBXX)
furlpay_tradeside, asset, amount, pricesponsorStellar limit orders with delegated budget enforcementSIMULATED
furlpay_trade_perpsymbol, side, size, leveragepriceHyperliquid L1 perpetual order (EIP-712 signed), risk engine enforcedLIVE (signed)
furlpay_execute_tradesymbol, side, sizeleverage, price, orderTypeExecute a perp orderLIVE (signed)
furlpay_cancel_ordersymbol, orderId—Cancel a resting perp orderLIVE (signed)
furlpay_emergency_stop—symbolKill-switch; symbol-scoped when given (M-05 fix)LIVE (signed)
furlpay_payrecipient, amounttoken, mandatePlatform A2A paymentHosted API
furlpay_confirm_executionexecutionHash—Two-phase step 2: execute the previewed call exactly onceGATE

JavaScript research server — 29 tools ​

Registered in lib/mcp.js; served by plain furlpay mcp. Same read-only default: its value-moving tools are hidden from tools/list without the startup policy gate passing.

ToolCategoryStatus
fork_list_networksFork assets (read-only)IMPLEMENTED
fork_inspect_networkFork assets (read-only)IMPLEMENTED
fork_replay_checkFork assets (read-only)IMPLEMENTED
microstructure_analyticsQuant research (read-only)IMPLEMENTED (offline)
microstructure_vpinQuant research (read-only)IMPLEMENTED (offline)
microstructure_quotesQuant research (read-only)IMPLEMENTED (offline)
algo_glft_quotesQuant engines (read-only)IMPLEMENTED (offline)
algo_breakevenQuant engines (read-only)IMPLEMENTED (offline)
algo_cascadeQuant engines (read-only)IMPLEMENTED (offline)
chain_statusPlatform viewHosted API
get_balance / get_portfolio / get_net_worthPlatform viewHosted API
get_quote / swap_tokens / send_stablecoinPayments (mutating ones gated)Hosted API
place_order / earn_deposit / earn_withdraw / furlpay_pay / set_card_controls / book_travelMutating — hidden by defaultHosted API
list_cards / list_transactions / list_trips / search_travel / earn_overview / market_moversRead viewsHosted API

Mutating tools on this surface (send_stablecoin, earn_withdraw, place_order, swap_tokens, earn_deposit, book_travel, set_card_controls, furlpay_pay) carry honest annotations and are structurally filtered in read-only mode exactly like the TS server.


Client configuration ​

Claude Desktop / Cursor (claude_desktop_config.json):

json
{
  "mcpServers": {
    "furlpay-execution": {
      "command": "furlpay",
      "args": ["mcp", "--wallet", "agent-alpha"]
    }
  }
}

Read-only-only setups (research assistants, CI inspection) simply omit the wallet: plain furlpay mcp or furlpay mcp --wallet <name> without --enable-execution can quote, inspect and analyze, but never transact.

Agent rules (load-bearing):

  • Read-only by default; never assume execution permissions exist.
  • Never invent payment completion — a preview is not a settlement, a SIMULATED label is not a transaction.
  • Never bypass Agent Trust: the policy gate runs before signing, on stored amounts, under an OS file lock.
  • Never expose credentials; keys arrive via environment/stdin, never argv.
  • Never retry a value-moving operation without respecting idempotency and the transaction status the ledger reports.

FurlPay CLI is non-custodial software. Every execution surface is labeled live or simulated at runtime.