Liquid Agent
x402 money tools for agents: one-signature USDC bridge (Base-Arc), tokenized stocks, USDC gas.
我該用這個嗎
品質與安全性
A
發現項目（2）
- LOWTool 'stocks_basket' description lacks action verb在 stocks_basket 中
- LOWTool 'liquid_guide' description lacks action verb在 liquid_guide 中
根據工具定義與協定合規性的自動化分析。
上下文成本
~8,645Token（工具定義）
~3.1 KB典型回應大小
顯著的注意力影響（128k 上下文的 6.75%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"liquid-agent": {
"url": "https://api.liquidagent.ai/mcp"
}
}
}遠端端點
https://api.liquidagent.ai/mcpstreamable-http它能做什麼
工具清單
工具（24）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢bridge_quote(from, to, amount, ref)
Free. Exact price to move USDC between Base and Arc with the Liquid Bridge: what you pay, what you receive (exactly `amount`), the fee breakdown and the ETA. No payment, no wallet needed.
輸入結構描述
{
"type": "object",
"properties": {
"from": {
"description": "Chain you pay on. Omit to pick the live route to `to` (base -> arc, arc -> base).",
"type": "string",
"enum": [
"base",
"arc"
]
},
"to": {
"type": "string",
"enum": [
"arc",
"base"
],
"description": "Chain you receive on."
},
"amount": {
"type": "string",
"pattern": "^\\d+(\\.\\d{1,6})?$",
"description": "USDC to RECEIVE on the destination, e.g. \"1\" or \"25.5\". Minimum 1."
},
"ref": {
"description": "Optional referrer address: earns 20% of Liquid's fee. Omit if you have none.",
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
}
},
"required": [
"to",
"amount"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "Chain you pay on"
},
"to": {
"type": "string",
"description": "Chain you receive on"
},
"receive": {
"type": "string",
"description": "USDC you receive, exactly the requested amount"
},
"pay": {
"type": "string",
"description": "USDC you pay, all fees included"
},
"recipient": {
"type": "string",
"description": "Who receives: the payer's own address"
},
"breakdown": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "Fee breakdown: Circle network fee, Liquid fee, gas"
},
"allInCost": {
"type": "string",
"description": "Total cost in USDC"
},
"allInPct": {
"type": "string",
"description": "Total cost as a percentage"
},
"etaSeconds": {
"type": "number",
"description": "Typical delivery time"
},
"payTo": {
"type": "string",
"description": "Bridge contract that receives the x402 payment"
},
"network": {
"type": "string",
"description": "x402 network of the payment (CAIP-2)"
},
"note": {
"type": "string",
"description": "Notes"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢bridge_prepare_payment(from, to, amount, ref)
Returns the exact x402 payment request for a bridge (network, asset, payTo contract, amount, EIP-712 domain) and the URL to call. Pay it with your own x402 client: sign one EIP-3009 authorization and repeat the GET with the PAYMENT-SIGNATURE header. You receive exactly `amount` at your own address on the destination. This tool does not pay or sign anything.
輸入結構描述
{
"type": "object",
"properties": {
"from": {
"description": "Chain you pay on. Omit to pick the live route to `to` (base -> arc, arc -> base).",
"type": "string",
"enum": [
"base",
"arc"
]
},
"to": {
"type": "string",
"enum": [
"arc",
"base"
],
"description": "Chain you receive on."
},
"amount": {
"type": "string",
"pattern": "^\\d+(\\.\\d{1,6})?$",
"description": "USDC to RECEIVE on the destination, e.g. \"1\" or \"25.5\". Minimum 1."
},
"ref": {
"description": "Optional referrer address: earns 20% of Liquid's fee. Omit if you have none.",
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
}
},
"required": [
"to",
"amount"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "URL to call with the PAYMENT-SIGNATURE header"
},
"method": {
"type": "string",
"description": "HTTP method"
},
"x402": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "The x402 payment request (accepts: scheme, network, asset, payTo, amount, EIP-712 domain)"
},
"quote": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "The quote behind the price"
},
"howToPay": {
"type": "array",
"items": {},
"description": "Step-by-step signing instructions"
},
"note": {
"type": "string",
"description": "Notes"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢bridge_routes
Free. Every Liquid Bridge route with its live price for 1 USDC and whether it is open.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"routes": {
"type": "array",
"items": {},
"description": "Each route: from, to, live price for 1 USDC, open or not"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢bridge_status(burnTx, from)
Free. Circle attestation and mint state for a bridge, by its burn transaction hash (returned by the bridge call).
輸入結構描述
{
"type": "object",
"properties": {
"burnTx": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Burn transaction hash from the bridge response."
},
"from": {
"description": "Source chain, if known.",
"type": "string",
"enum": [
"base",
"arc"
]
}
},
"required": [
"burnTx"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"burnTx": {
"type": "string",
"description": "Burn transaction hash"
},
"from": {
"type": "string",
"description": "Source chain"
},
"state": {
"type": "string",
"description": "waiting | attested | minted | delayed"
},
"circleStatus": {
"type": "string",
"description": "Circle attestation status"
},
"forwardState": {
"type": "string",
"description": "Circle Forwarding state"
},
"mintTx": {
"type": "string",
"description": "Mint transaction on the destination, once minted"
},
"feeExecuted": {
"type": "string",
"description": "Circle fee actually charged"
},
"delayReason": {
"description": "Why it is delayed, if it is",
"type": [
"string",
"null"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢bridge_referral_earnings(address)
Free. Unclaimed Liquid Bridge referral earnings for an address on each chain, and how they are paid out. Earn by adding ref=<your address> to bridge calls: 20% of Liquid's fee.
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Referrer address."
}
},
"required": [
"address"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"referrer": {
"type": "string",
"description": "Referrer address"
},
"earnings": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "Unclaimed earnings per chain"
},
"payout": {
"type": "string",
"description": "How and when earnings are paid"
},
"note": {
"type": "string",
"description": "Notes"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_basket
Free. The on-chain tokenized US stock index on Base (NVDA, META, AAPL, GOOGL): live prices, fees, how to buy from $1.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"protocol": {
"type": "string",
"description": "Protocol name"
},
"tagline": {
"type": "string",
"description": "One-line summary"
},
"chain": {
"type": "string",
"description": "Chain"
},
"chainId": {
"type": "number",
"description": "Chain id"
},
"usdc": {
"type": "string",
"description": "USDC address"
},
"factory": {
"type": "string",
"description": "Vault factory address"
},
"fees": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "Fees"
},
"minDepositUsdc": {
"type": "string",
"description": "Minimum deposit (USDC, 6 decimals)"
},
"constituents": {
"type": "array",
"items": {},
"description": "Stocks in the basket with live prices"
},
"totalVaults": {
"type": "number",
"description": "Vaults created"
},
"flow": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "How to buy and exit"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_buy_quote(usdc)
Free. Preview buying the tokenized stock basket: shares you would get and the fee for a USDC amount (USDC 6 decimals: "2000000" = $2).
輸入結構描述
{
"type": "object",
"properties": {
"usdc": {
"type": "string",
"pattern": "^\\d+$",
"description": "Amount in USDC-6, e.g. \"2000000\" for $2."
}
},
"required": [
"usdc"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"usdcIn": {
"type": "string",
"description": "USDC in (6 decimals)"
},
"mintFeeUsdc": {
"type": "string",
"description": "Mint fee (6 decimals)"
},
"netUsdc": {
"type": "string",
"description": "USDC invested after the fee"
},
"note": {
"type": "string",
"description": "Notes"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_vault(address)
Free. A basket vault's value (NAV), holdings, current vs target weights and whether it needs rebalancing.
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Vault address."
}
},
"required": [
"address"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"vault": {
"type": "string",
"description": "Vault address"
},
"owner": {
"type": "string",
"description": "Owner"
},
"strategist": {
"type": "string",
"description": "Strategist"
},
"navUsdc": {
"type": "string",
"description": "Net asset value (USDC, 6 decimals)"
},
"nav": {
"type": "number",
"description": "NAV in dollars"
},
"totalSupply": {
"type": "string",
"description": "Shares outstanding"
},
"weightsBps": {
"type": "array",
"items": {},
"description": "Target weights in basis points"
},
"constituents": {
"type": "array",
"items": {},
"description": "Holdings with current weights"
},
"rebalanceNeeded": {
"type": "boolean",
"description": "True when weights drifted past the band"
},
"rebalanceBandBps": {
"type": "number",
"description": "Rebalance band"
},
"mintFeeBps": {
"type": "number",
"description": "Mint fee"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_portfolio(address)
Free. Everything an address owns in the tokenized stock basket: each vault, its shares and current USD value.
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Wallet address to look up."
}
},
"required": [
"address"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"agent": {
"type": "string",
"description": "Address"
},
"vaultCount": {
"type": "number",
"description": "Vaults held"
},
"vaults": {
"type": "array",
"items": {},
"description": "Each vault: address, shares, value in USDC"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_create_vault
Free. Opens your own vault for the tokenized US stock basket (NVDA, META, AAPL, GOOGL), controlled only by you. Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds. After it confirms, find the vault with stocks_portfolio.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"chainId": {
"type": "number",
"description": "Chain id (8453 = Base)"
},
"to": {
"type": "string",
"description": "Contract to call"
},
"data": {
"type": "string",
"description": "Calldata, sign and broadcast as-is"
},
"value": {
"type": "string",
"description": "Native value, always 0"
},
"steps": {
"type": "array",
"items": {},
"description": "When two transactions are needed (approve, then deposit), sign and send them in order"
},
"mode": {
"type": "string",
"description": "permit: sign typedData first"
},
"typedData": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "EIP-712 permit to sign off-chain (free, no gas)"
},
"next": {
"type": "string",
"description": "What to do next"
},
"after": {
"type": "string",
"description": "What to do after it confirms"
},
"attribution": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "ERC-8021 builder attribution suffix info"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_set_weights(vault, weightsBps)
Free. Sets your vault's target allocation across the 4 stocks in basis points (sum 10000), e.g. [4000, 3000, 2000, 1000]. Default is equal weight. Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds.
輸入結構描述
{
"type": "object",
"properties": {
"vault": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Your vault address."
},
"weightsBps": {
"minItems": 4,
"maxItems": 4,
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 10000
},
"description": "4 weights in basis points summing to 10000, in the basket's constituent order (see stocks_basket)."
}
},
"required": [
"vault",
"weightsBps"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"chainId": {
"type": "number",
"description": "Chain id (8453 = Base)"
},
"to": {
"type": "string",
"description": "Contract to call"
},
"data": {
"type": "string",
"description": "Calldata, sign and broadcast as-is"
},
"value": {
"type": "string",
"description": "Native value, always 0"
},
"steps": {
"type": "array",
"items": {},
"description": "When two transactions are needed (approve, then deposit), sign and send them in order"
},
"mode": {
"type": "string",
"description": "permit: sign typedData first"
},
"typedData": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "EIP-712 permit to sign off-chain (free, no gas)"
},
"next": {
"type": "string",
"description": "What to do next"
},
"after": {
"type": "string",
"description": "What to do after it confirms"
},
"attribution": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "ERC-8021 builder attribution suffix info"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_buy(vault, usdc, owner, minShares, usePermit, ...)
Free. Invest USDC into your vault from $1 (USDC 6 decimals: "1000000" = $1). Easiest: set usePermit=true with owner, sign the returned typedData off-chain (free), then call again with permitDeadline + permitSignature to get ONE deposit transaction. Without a permit you get two transactions (approve, then deposit). Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds.
輸入結構描述
{
"type": "object",
"properties": {
"vault": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Your vault address."
},
"usdc": {
"type": "string",
"pattern": "^\\d+$",
"description": "USDC to invest, 6 decimals, minimum \"1000000\" ($1)."
},
"owner": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Your wallet address (required with usePermit)."
},
"minShares": {
"type": "string",
"pattern": "^\\d+$",
"description": "Optional slippage floor: minimum shares to receive."
},
"usePermit": {
"description": "true = return an EIP-2612 permit to sign first (no approve transaction).",
"type": "boolean"
},
"permitDeadline": {
"description": "Deadline from the permit you signed (second call).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"permitSignature": {
"description": "Your signature of the permit typedData (second call).",
"type": "string",
"pattern": "^0x[0-9a-fA-F]+$"
}
},
"required": [
"vault",
"usdc"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"chainId": {
"type": "number",
"description": "Chain id (8453 = Base)"
},
"to": {
"type": "string",
"description": "Contract to call"
},
"data": {
"type": "string",
"description": "Calldata, sign and broadcast as-is"
},
"value": {
"type": "string",
"description": "Native value, always 0"
},
"steps": {
"type": "array",
"items": {},
"description": "When two transactions are needed (approve, then deposit), sign and send them in order"
},
"mode": {
"type": "string",
"description": "permit: sign typedData first"
},
"typedData": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "EIP-712 permit to sign off-chain (free, no gas)"
},
"next": {
"type": "string",
"description": "What to do next"
},
"after": {
"type": "string",
"description": "What to do after it confirms"
},
"attribution": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "ERC-8021 builder attribution suffix info"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_sell(vault, shares, minUsdcOut, inKind)
Free. Cash out: redeem basket shares to USDC, or take the raw stock tokens in-kind (works any block, no vault needed, anyone holding shares can sell). Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds.
輸入結構描述
{
"type": "object",
"properties": {
"vault": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Vault whose shares you hold."
},
"shares": {
"type": "string",
"pattern": "^\\d+$",
"description": "Shares to redeem (18 decimals; see stocks_portfolio)."
},
"minUsdcOut": {
"type": "string",
"pattern": "^\\d+$",
"description": "Optional slippage floor in USDC-6."
},
"inKind": {
"description": "true = receive the 4 stock tokens instead of USDC.",
"type": "boolean"
}
},
"required": [
"vault",
"shares"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"chainId": {
"type": "number",
"description": "Chain id (8453 = Base)"
},
"to": {
"type": "string",
"description": "Contract to call"
},
"data": {
"type": "string",
"description": "Calldata, sign and broadcast as-is"
},
"value": {
"type": "string",
"description": "Native value, always 0"
},
"steps": {
"type": "array",
"items": {},
"description": "When two transactions are needed (approve, then deposit), sign and send them in order"
},
"mode": {
"type": "string",
"description": "permit: sign typedData first"
},
"typedData": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "EIP-712 permit to sign off-chain (free, no gas)"
},
"next": {
"type": "string",
"description": "What to do next"
},
"after": {
"type": "string",
"description": "What to do after it confirms"
},
"attribution": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "ERC-8021 builder attribution suffix info"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_rebalance(vault)
Free. Brings your vault back to its target weights (check stocks_vault: rebalanceNeeded). Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds.
輸入結構描述
{
"type": "object",
"properties": {
"vault": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Your vault address."
}
},
"required": [
"vault"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"chainId": {
"type": "number",
"description": "Chain id (8453 = Base)"
},
"to": {
"type": "string",
"description": "Contract to call"
},
"data": {
"type": "string",
"description": "Calldata, sign and broadcast as-is"
},
"value": {
"type": "string",
"description": "Native value, always 0"
},
"steps": {
"type": "array",
"items": {},
"description": "When two transactions are needed (approve, then deposit), sign and send them in order"
},
"mode": {
"type": "string",
"description": "permit: sign typedData first"
},
"typedData": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "EIP-712 permit to sign off-chain (free, no gas)"
},
"next": {
"type": "string",
"description": "What to do next"
},
"after": {
"type": "string",
"description": "What to do after it confirms"
},
"attribution": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "ERC-8021 builder attribution suffix info"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_send(vault, to, shares)
Free. Transfer your tokenized stock basket shares to any wallet or another agent; they can hold, sell or forward them, no vault needed. Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds.
輸入結構描述
{
"type": "object",
"properties": {
"vault": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Vault whose shares you hold."
},
"to": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Recipient address."
},
"shares": {
"type": "string",
"pattern": "^\\d+$",
"description": "Shares to send (18 decimals)."
}
},
"required": [
"vault",
"to",
"shares"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"chainId": {
"type": "number",
"description": "Chain id (8453 = Base)"
},
"to": {
"type": "string",
"description": "Contract to call"
},
"data": {
"type": "string",
"description": "Calldata, sign and broadcast as-is"
},
"value": {
"type": "string",
"description": "Native value, always 0"
},
"steps": {
"type": "array",
"items": {},
"description": "When two transactions are needed (approve, then deposit), sign and send them in order"
},
"mode": {
"type": "string",
"description": "permit: sign typedData first"
},
"typedData": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "EIP-712 permit to sign off-chain (free, no gas)"
},
"next": {
"type": "string",
"description": "What to do next"
},
"after": {
"type": "string",
"description": "What to do after it confirms"
},
"attribution": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "ERC-8021 builder attribution suffix info"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_signals_prepare(vault)
Returns the x402 payment request for basket signals ($0.005 USDC on Base or Polygon): rebalancing signal, momentum and suggested weights for NVDA/META/AAPL/GOOGL in one call. Pay it with your own x402 client. This tool does not pay.
輸入結構描述
{
"type": "object",
"properties": {
"vault": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Optional vault to tailor the signal to."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "URL to call with the PAYMENT-SIGNATURE header"
},
"method": {
"type": "string",
"description": "HTTP method"
},
"body": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "JSON body to send, for POST"
},
"x402": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "The x402 payment request (scheme, network, asset, payTo, amount, EIP-712 domain)"
},
"alternatives": {
"type": "array",
"items": {},
"description": "Other accepted networks"
},
"howToPay": {
"type": "array",
"items": {},
"description": "Step-by-step signing instructions"
},
"note": {
"type": "string",
"description": "Notes"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢polymarket_prepare(market, start)
Returns the x402 payment request for Polymarket crypto Up/Down data (BTC, ETH, SOL, XRP; 5m and 15m; $0.002 USDC on Base or Polygon): the OFFICIAL price to beat for the live 5m or 15m window (matched to the cent against Polymarket's results), the live Chainlink price and its distance from the price to beat, seconds left, token ids and market prices. Pass start (unix) for a past window's official outcome. Pay it with your own x402 client. This tool does not pay.
輸入結構描述
{
"type": "object",
"properties": {
"market": {
"type": "string",
"enum": [
"btc-5m",
"btc-15m",
"eth-5m",
"eth-15m",
"sol-5m",
"sol-15m",
"xrp-5m",
"xrp-15m"
],
"description": "Which market: <asset>-<timeframe>."
},
"start": {
"description": "Optional unix start of a past window.",
"type": "string",
"pattern": "^\\d+$"
}
},
"required": [
"market"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "URL to call with the PAYMENT-SIGNATURE header"
},
"method": {
"type": "string",
"description": "HTTP method"
},
"body": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "JSON body to send, for POST"
},
"x402": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "The x402 payment request (scheme, network, asset, payTo, amount, EIP-712 domain)"
},
"alternatives": {
"type": "array",
"items": {},
"description": "Other accepted networks"
},
"howToPay": {
"type": "array",
"items": {},
"description": "Step-by-step signing instructions"
},
"note": {
"type": "string",
"description": "Notes"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢stocks_publish_prepare(vault, label)
Returns the x402 payment request to publish a live, shareable portfolio page for a vault for 24 hours ($0.01 USDC on Base or Polygon). Pay it with your own x402 client. This tool does not pay.
輸入結構描述
{
"type": "object",
"properties": {
"vault": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Vault to publish."
},
"label": {
"description": "Optional page title.",
"type": "string",
"maxLength": 60
}
},
"required": [
"vault"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "URL to call with the PAYMENT-SIGNATURE header"
},
"method": {
"type": "string",
"description": "HTTP method"
},
"body": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "JSON body to send, for POST"
},
"x402": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "The x402 payment request (scheme, network, asset, payTo, amount, EIP-712 domain)"
},
"alternatives": {
"type": "array",
"items": {},
"description": "Other accepted networks"
},
"howToPay": {
"type": "array",
"items": {},
"description": "Step-by-step signing instructions"
},
"note": {
"type": "string",
"description": "Notes"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢usdc_balances(address)
Free. USDC balance (and native gas balance) of an address on every CCTP chain at once: Ethereum, Avalanche, OP Mainnet, Arbitrum, Base, Polygon PoS, Unichain, Linea, Sonic, World Chain, Arc. Use it before paying or bridging to see where your money is.
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "EVM address."
}
},
"required": [
"address"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Address"
},
"totalUsdc": {
"type": "string",
"description": "USDC across all chains"
},
"chains": {
"type": "array",
"items": {},
"description": "Per chain: USDC and native gas balance"
},
"hints": {
"type": "array",
"items": {},
"description": "What to do next"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢cctp_status(txHash, from)
Free. Status of ANY Circle CCTP v2 USDC transfer (not only Liquid's) by its burn transaction hash: attestation, whether it was minted on the destination, and exactly how to finish a stuck one (receiveMessage with the message and attestation). Chains: Ethereum, Avalanche, OP Mainnet, Arbitrum, Base, Polygon PoS, Unichain, Linea, Sonic, World Chain, Arc.
輸入結構描述
{
"type": "object",
"properties": {
"txHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "Burn transaction hash on the source chain."
},
"from": {
"description": "Source chain, if known (faster).",
"type": "string",
"enum": [
"ethereum",
"avalanche",
"optimism",
"arbitrum",
"base",
"polygon",
"unichain",
"linea",
"sonic",
"worldchain",
"arc"
]
}
},
"required": [
"txHash"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"txHash": {
"type": "string",
"description": "Burn transaction"
},
"found": {
"type": "boolean",
"description": "Circle has a message for it"
},
"state": {
"type": "string",
"description": "not_found | pending_attestation | attested | minted"
},
"sourceChain": {
"type": "string",
"description": "Source chain"
},
"destinationChain": {
"type": "string",
"description": "Destination chain"
},
"amountUsdc": {
"type": "string",
"description": "Amount burned"
},
"feeExecutedUsdc": {
"type": "string",
"description": "Circle fee charged"
},
"mintRecipient": {
"type": "string",
"description": "Who receives"
},
"mintTx": {
"type": "string",
"description": "Mint transaction when forwarded"
},
"forwarding": {
"type": "boolean",
"description": "Uses Circle Forwarding"
},
"nextStep": {
"type": "string",
"description": "What to do now"
},
"receiveMessage": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "When attested but not minted: contract, message and attestation to finish it yourself"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢x402_check(url, method, body, requirement, payment)
Free. Decode any x402 payment request (from a URL, a PAYMENT-REQUIRED header or a 402 body) into plain English with warnings, and optionally verify a signed payment (PAYMENT-SIGNATURE / X-PAYMENT header) the way a facilitator would: recipient, amount, time window, EIP-712 signature against the token's real domain, nonce reuse and balance. Every failed check comes with the fix.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"description": "The paid endpoint URL (https). It is called once, without payment, to read its 402.",
"type": "string",
"format": "uri"
},
"method": {
"description": "HTTP method for url (default GET).",
"type": "string",
"enum": [
"GET",
"POST"
]
},
"body": {
"description": "JSON body for a POST url.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"requirement": {
"description": "Instead of url: the PAYMENT-REQUIRED header value (base64) or the 402 JSON body.",
"type": "string",
"maxLength": 20000
},
"payment": {
"description": "Optional signed payment header value to verify.",
"type": "string",
"maxLength": 20000
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"requirement": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "Decoded payment request: options in plain English, warnings"
},
"verification": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "If a payment was given: each facilitator check, pass/fail, and the fix"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢payment_readiness(address, url, method, body, requirement)
Free. One call to know if a wallet can pay an x402 endpoint right now: reads the endpoint's 402, checks the wallet's balance on each accepted network, and if it cannot pay, returns the cheapest fix (e.g. move USDC from the chain where it sits, with the exact bridge_quote arguments).
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "The paying wallet."
},
"url": {
"description": "The paid endpoint URL (https). It is called once, without payment, to read its 402.",
"type": "string",
"format": "uri"
},
"method": {
"description": "HTTP method for url (default GET).",
"type": "string",
"enum": [
"GET",
"POST"
]
},
"body": {
"description": "JSON body for a POST url.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"requirement": {
"description": "Instead of url: the PAYMENT-REQUIRED header value (base64) or the 402 JSON body.",
"type": "string",
"maxLength": 20000
}
},
"required": [
"address"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Payer"
},
"ready": {
"type": "boolean",
"description": "Can pay right now"
},
"options": {
"type": "array",
"items": {},
"description": "Each payment option with balance and whether it is enough"
},
"fix": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "Cheapest step to become able to pay"
},
"note": {
"type": "string",
"description": "Notes"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢gas_sponsor_info
Free. How to send a transaction on Base, Polygon or Solana with a wallet that holds USDC but no ETH/POL/SOL: the x402-paid gas sponsor, its price rule (from $0.03) and lanes.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"service": {
"type": "string",
"description": "Service name"
},
"what": {
"type": "string",
"description": "What it does"
},
"price": {
"type": "string",
"description": "Price rule"
},
"enabled": {
"type": "boolean",
"description": "Live or not"
},
"endpoint": {
"type": "string",
"description": "Paid endpoint"
},
"chains": {
"type": "array",
"items": {},
"description": "Supported chains"
},
"flow": {
"type": "array",
"items": {},
"description": "Steps"
},
"docs": {
"type": "string",
"description": "Docs URL"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢liquid_guide
Free. Overview of every Liquid Agent service for agents (bridge, stocks, signals, gas sponsor), prices and where the full docs are.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"services": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "Every service with price, tools and docs"
},
"referral": {
"type": "string",
"description": "How referrals earn"
},
"discovery": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "Machine-readable discovery URLs"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}社群
證據
近期觀測
已驗證未記錄版本24 個工具