MCP Server
Liquid Agent
ai.liquidagent.api/liquid-agent
What this MCP does
Provides USDC bridge quotes and tracking, cross-chain balance checks, gas sponsorship information, tokenized stock portfolio operations, and x402 payment preparation.
Capabilities
Tools
26
tools
bridge_prepare_payment
Prepare a bridge payment (x402)
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['to', 'amount'], 'properties': {'to': {'enum': ['base', 'arc', 'optimism', 'unichain', 'sonic', 'world', 'monad', 'sei', 'xdc', 'ink', 'plume', 'polygon', 'avalanche', 'arbitrum', 'codex', 'hyperevm', 'linea'], 'type': 'string', 'description': 'Chain you receive on: arc, arbitrum, optimism, polygon, avalanche, unichain, linea, world, sonic, monad, sei, ink, hyperevm, xdc, plume, codex (from Base) or base (from Arc).'}, 'ref': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': "Optional referrer address: earns 20% of Liquid's fee. Omit if you have none."}, 'from': {'enum': ['base', 'arc'], 'type': 'string', 'description': 'Chain you pay on. Omit to pick the live route to `to` (Base to any listed chain; Arc to Base).'}, 'amount': {'type': 'string', 'pattern': '^\\d+(\\.\\d{1,6})?$', 'description': 'USDC to RECEIVE on the destination, e.g. "1" or "25.5". Minimum 1.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'URL to call with the PAYMENT-SIGNATURE header'}, 'note': {'type': 'string', 'description': 'Notes'}, 'x402': {'type': 'object', 'properties': {}, 'description': 'The x402 payment request (accepts: scheme, network, asset, payTo, amount, EIP-712 domain)', 'additionalProperties': {}}, 'quote': {'type': 'object', 'properties': {}, 'description': 'The quote behind the price', 'additionalProperties': {}}, 'method': {'type': 'string', 'description': 'HTTP method'}, 'howToPay': {'type': 'array', 'items': {}, 'description': 'Step-by-step signing instructions'}}, 'additionalProperties': {}}
bridge_quote
Bridge quote (Base to 16 chains, Arc to Base)
Free. Exact price to move USDC with the Liquid Bridge (Base to Arc, Arbitrum, OP, Polygon, Avalanche, Unichain, Linea, World Chain, Sonic, Monad, Sei, Ink, HyperEVM, XDC, Plume, Codex; or Arc to Base): what you pay, what you receive (exactly `amount`), the fee breakdown and the ETA. No payment, no wallet needed.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['to', 'amount'], 'properties': {'to': {'enum': ['base', 'arc', 'optimism', 'unichain', 'sonic', 'world', 'monad', 'sei', 'xdc', 'ink', 'plume', 'polygon', 'avalanche', 'arbitrum', 'codex', 'hyperevm', 'linea'], 'type': 'string', 'description': 'Chain you receive on: arc, arbitrum, optimism, polygon, avalanche, unichain, linea, world, sonic, monad, sei, ink, hyperevm, xdc, plume, codex (from Base) or base (from Arc).'}, 'ref': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': "Optional referrer address: earns 20% of Liquid's fee. Omit if you have none."}, 'from': {'enum': ['base', 'arc'], 'type': 'string', 'description': 'Chain you pay on. Omit to pick the live route to `to` (Base to any listed chain; Arc to Base).'}, 'amount': {'type': 'string', 'pattern': '^\\d+(\\.\\d{1,6})?$', 'description': 'USDC to RECEIVE on the destination, e.g. "1" or "25.5". Minimum 1.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Chain you receive on'}, 'pay': {'type': 'string', 'description': 'USDC you pay, all fees included'}, 'from': {'type': 'string', 'description': 'Chain you pay on'}, 'note': {'type': 'string', 'description': 'Notes'}, 'payTo': {'type': 'string', 'description': 'Bridge contract that receives the x402 payment'}, 'network': {'type': 'string', 'description': 'x402 network of the payment (CAIP-2)'}, 'receive': {'type': 'string', 'description': 'USDC you receive, exactly the requested amount'}, 'allInPct': {'type': 'string', 'description': 'Total cost as a percentage'}, 'allInCost': {'type': 'string', 'description': 'Total cost in USDC'}, 'breakdown': {'type': 'object', 'properties': {}, 'description': 'Fee breakdown: Circle network fee, Liquid fee, gas', 'additionalProperties': {}}, 'recipient': {'type': 'string', 'description': "Who receives: the payer's own address"}, 'etaSeconds': {'type': 'number', 'description': 'Typical delivery time'}}, 'additionalProperties': {}}
bridge_referral_earnings
Referral earnings
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Referrer address.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string', 'description': 'Notes'}, 'payout': {'type': 'string', 'description': 'How and when earnings are paid'}, 'earnings': {'type': 'object', 'properties': {}, 'description': 'Unclaimed earnings per chain', 'additionalProperties': {}}, 'referrer': {'type': 'string', 'description': 'Referrer address'}}, 'additionalProperties': {}}
bridge_routes
Bridge routes
Free. Every Liquid Bridge route with its live price for 1 USDC and whether it is open.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'routes': {'type': 'array', 'items': {}, 'description': 'Each route: from, to, live price for 1 USDC, open or not'}}, 'additionalProperties': {}}
bridge_status
Track a bridge
Free. Circle attestation and mint state for a bridge, by its burn transaction hash (returned by the bridge call).
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['burnTx'], 'properties': {'from': {'enum': ['base', 'arc'], 'type': 'string', 'description': 'Source chain, if known.'}, 'burnTx': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': 'Burn transaction hash from the bridge response.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'from': {'type': 'string', 'description': 'Source chain'}, 'state': {'type': 'string', 'description': 'waiting | attested | minted | delayed'}, 'burnTx': {'type': 'string', 'description': 'Burn transaction hash'}, 'mintTx': {'type': 'string', 'description': 'Mint transaction on the destination, once minted'}, 'delayReason': {'type': ['string', 'null'], 'description': 'Why it is delayed, if it is'}, 'feeExecuted': {'type': 'string', 'description': 'Circle fee actually charged'}, 'circleStatus': {'type': 'string', 'description': 'Circle attestation status'}, 'forwardState': {'type': 'string', 'description': 'Circle Forwarding state'}}, 'additionalProperties': {}}
cctp_status
Track any Circle CCTP transfer
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['txHash'], 'properties': {'from': {'enum': ['ethereum', 'avalanche', 'optimism', 'arbitrum', 'base', 'polygon', 'unichain', 'linea', 'sonic', 'worldchain', 'arc'], 'type': 'string', 'description': 'Source chain, if known (faster).'}, 'txHash': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': 'Burn transaction hash on the source chain.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'found': {'type': 'boolean', 'description': 'Circle has a message for it'}, 'state': {'type': 'string', 'description': 'not_found | pending_attestation | attested | minted'}, 'mintTx': {'type': 'string', 'description': 'Mint transaction when forwarded'}, 'txHash': {'type': 'string', 'description': 'Burn transaction'}, 'nextStep': {'type': 'string', 'description': 'What to do now'}, 'amountUsdc': {'type': 'string', 'description': 'Amount burned'}, 'forwarding': {'type': 'boolean', 'description': 'Uses Circle Forwarding'}, 'sourceChain': {'type': 'string', 'description': 'Source chain'}, 'mintRecipient': {'type': 'string', 'description': 'Who receives'}, 'receiveMessage': {'type': 'object', 'properties': {}, 'description': 'When attested but not minted: contract, message and attestation to finish it yourself', 'additionalProperties': {}}, 'feeExecutedUsdc': {'type': 'string', 'description': 'Circle fee charged'}, 'destinationChain': {'type': 'string', 'description': 'Destination chain'}}, 'additionalProperties': {}}
gas_sponsor_info
Gas sponsor (pay gas in USDC)
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'docs': {'type': 'string', 'description': 'Docs URL'}, 'flow': {'type': 'array', 'items': {}, 'description': 'Steps'}, 'what': {'type': 'string', 'description': 'What it does'}, 'price': {'type': 'string', 'description': 'Price rule'}, 'chains': {'type': 'array', 'items': {}, 'description': 'Supported chains'}, 'enabled': {'type': 'boolean', 'description': 'Live or not'}, 'service': {'type': 'string', 'description': 'Service name'}, 'endpoint': {'type': 'string', 'description': 'Paid endpoint'}}, 'additionalProperties': {}}
liquid_guide
What Liquid Agent offers
Free. Overview of every Liquid Agent service for agents (bridge, stocks, signals, gas sponsor), prices and where the full docs are.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'referral': {'type': 'string', 'description': 'How referrals earn'}, 'services': {'type': 'object', 'properties': {}, 'description': 'Every service with price, tools and docs', 'additionalProperties': {}}, 'discovery': {'type': 'object', 'properties': {}, 'description': 'Machine-readable discovery URLs', 'additionalProperties': {}}}, 'additionalProperties': {}}
payment_readiness
Can this wallet pay this endpoint?
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).
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The paid endpoint URL (https). It is called once, without payment, to read its 402.'}, 'body': {'type': 'object', 'description': 'JSON body for a POST url.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'method': {'enum': ['GET', 'POST'], 'type': 'string', 'description': 'HTTP method for url (default GET).'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'The paying wallet.'}, 'requirement': {'type': 'string', 'maxLength': 20000, 'description': 'Instead of url: the PAYMENT-REQUIRED header value (base64) or the 402 JSON body.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'fix': {'type': 'object', 'properties': {}, 'description': 'Cheapest step to become able to pay', 'additionalProperties': {}}, 'note': {'type': 'string', 'description': 'Notes'}, 'ready': {'type': 'boolean', 'description': 'Can pay right now'}, 'address': {'type': 'string', 'description': 'Payer'}, 'options': {'type': 'array', 'items': {}, 'description': 'Each payment option with balance and whether it is enough'}}, 'additionalProperties': {}}
polymarket_prepare
Prepare a Polymarket price-to-beat call ($0.004)
Returns the x402 payment request for Polymarket crypto Up/Down data (BTC, ETH, SOL, XRP; 5m and 15m; $0.004 USDC on Base, Polygon or Arc): 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. First call free: add ?free=1 to the URL for one live answer at no charge (one per agent). Pay it with your own x402 client. This tool does not pay.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['market'], 'properties': {'start': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Optional unix start of a past window.'}, 'market': {'enum': ['btc-5m', 'btc-15m', 'eth-5m', 'eth-15m', 'sol-5m', 'sol-15m', 'xrp-5m', 'xrp-15m'], 'type': 'string', 'description': 'Which market: <asset>-<timeframe>.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'URL to call with the PAYMENT-SIGNATURE header'}, 'body': {'type': 'object', 'properties': {}, 'description': 'JSON body to send, for POST', 'additionalProperties': {}}, 'note': {'type': 'string', 'description': 'Notes'}, 'x402': {'type': 'object', 'properties': {}, 'description': 'The x402 payment request (scheme, network, asset, payTo, amount, EIP-712 domain)', 'additionalProperties': {}}, 'method': {'type': 'string', 'description': 'HTTP method'}, 'howToPay': {'type': 'array', 'items': {}, 'description': 'Step-by-step signing instructions'}, 'alternatives': {'type': 'array', 'items': {}, 'description': 'Other accepted networks'}}, 'additionalProperties': {}}
polymarket_price_to_beat
Polymarket price to beat (paid, $0.004)
PAID over x402 inside this tool call ($0.004 USDC on Base, Polygon or Arc): the OFFICIAL Polymarket price to beat for the live BTC, ETH, SOL or XRP 5m/15m Up/Down window (matched to every decimal against Polymarket), the live Chainlink price and its distance, seconds left, token ids and market prices. Call it once without payment to get the x402 PaymentRequired; your x402 wallet signs it and you call again with the payment in _meta["x402/payment"]. Set free=true for one free answer per agent.
Read only
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['market'], 'properties': {'free': {'type': 'boolean', 'description': 'Use your one free call (per agent) instead of paying.'}, 'start': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Optional unix start of a past window (official outcome).'}, 'market': {'enum': ['btc-5m', 'btc-15m', 'eth-5m', 'eth-15m', 'sol-5m', 'sol-15m', 'xrp-5m', 'xrp-15m'], 'type': 'string', 'description': 'Which market: <asset>-<timeframe>.'}}}
stocks_basket
Tokenized stock basket
Free. The on-chain tokenized US stock index on Base (NVDA, META, AAPL, GOOGL): live prices, fees, how to buy from $1.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'fees': {'type': 'object', 'properties': {}, 'description': 'Fees', 'additionalProperties': {}}, 'flow': {'type': 'object', 'properties': {}, 'description': 'How to buy and exit', 'additionalProperties': {}}, 'usdc': {'type': 'string', 'description': 'USDC address'}, 'chain': {'type': 'string', 'description': 'Chain'}, 'chainId': {'type': 'number', 'description': 'Chain id'}, 'factory': {'type': 'string', 'description': 'Vault factory address'}, 'tagline': {'type': 'string', 'description': 'One-line summary'}, 'protocol': {'type': 'string', 'description': 'Protocol name'}, 'totalVaults': {'type': 'number', 'description': 'Vaults created'}, 'constituents': {'type': 'array', 'items': {}, 'description': 'Stocks in the basket with live prices'}, 'minDepositUsdc': {'type': 'string', 'description': 'Minimum deposit (USDC, 6 decimals)'}}, 'additionalProperties': {}}
stocks_buy
Buy tokenized stocks with USDC
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['vault', 'usdc'], 'properties': {'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).'}, 'vault': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Your vault address.'}, 'minShares': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Optional slippage floor: minimum shares to receive.'}, 'usePermit': {'type': 'boolean', 'description': 'true = return an EIP-2612 permit to sign first (no approve transaction).'}, 'permitDeadline': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Deadline from the permit you signed (second call).'}, 'permitSignature': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]+$', 'description': 'Your signature of the permit typedData (second call).'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Contract to call'}, 'data': {'type': 'string', 'description': 'Calldata, sign and broadcast as-is'}, 'mode': {'type': 'string', 'description': 'permit: sign typedData first'}, 'next': {'type': 'string', 'description': 'What to do next'}, 'after': {'type': 'string', 'description': 'What to do after it confirms'}, 'steps': {'type': 'array', 'items': {}, 'description': 'When two transactions are needed (approve, then deposit), sign and send them in order'}, 'value': {'type': 'string', 'description': 'Native value, always 0'}, 'chainId': {'type': 'number', 'description': 'Chain id (8453 = Base)'}, 'typedData': {'type': 'object', 'properties': {}, 'description': 'EIP-712 permit to sign off-chain (free, no gas)', 'additionalProperties': {}}, 'attribution': {'type': 'object', 'properties': {}, 'description': 'ERC-8021 builder attribution suffix info', 'additionalProperties': {}}}, 'additionalProperties': {}}
stocks_buy_quote
Stock basket buy quote
Free. Preview buying the tokenized stock basket: shares you would get and the fee for a USDC amount (USDC 6 decimals: "2000000" = $2).
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['usdc'], 'properties': {'usdc': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Amount in USDC-6, e.g. "2000000" for $2.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string', 'description': 'Notes'}, 'usdcIn': {'type': 'string', 'description': 'USDC in (6 decimals)'}, 'netUsdc': {'type': 'string', 'description': 'USDC invested after the fee'}, 'mintFeeUsdc': {'type': 'string', 'description': 'Mint fee (6 decimals)'}}, 'additionalProperties': {}}
stocks_create_vault
Open your own stock 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Contract to call'}, 'data': {'type': 'string', 'description': 'Calldata, sign and broadcast as-is'}, 'mode': {'type': 'string', 'description': 'permit: sign typedData first'}, 'next': {'type': 'string', 'description': 'What to do next'}, 'after': {'type': 'string', 'description': 'What to do after it confirms'}, 'steps': {'type': 'array', 'items': {}, 'description': 'When two transactions are needed (approve, then deposit), sign and send them in order'}, 'value': {'type': 'string', 'description': 'Native value, always 0'}, 'chainId': {'type': 'number', 'description': 'Chain id (8453 = Base)'}, 'typedData': {'type': 'object', 'properties': {}, 'description': 'EIP-712 permit to sign off-chain (free, no gas)', 'additionalProperties': {}}, 'attribution': {'type': 'object', 'properties': {}, 'description': 'ERC-8021 builder attribution suffix info', 'additionalProperties': {}}}, 'additionalProperties': {}}
stocks_portfolio
Stock portfolio of an address
Free. Everything an address owns in the tokenized stock basket: each vault, its shares and current USD value.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Wallet address to look up.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'agent': {'type': 'string', 'description': 'Address'}, 'vaults': {'type': 'array', 'items': {}, 'description': 'Each vault: address, shares, value in USDC'}, 'vaultCount': {'type': 'number', 'description': 'Vaults held'}}, 'additionalProperties': {}}
stocks_publish_prepare
Prepare a paid portfolio page ($0.01)
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['vault'], 'properties': {'label': {'type': 'string', 'maxLength': 60, 'description': 'Optional page title.'}, 'vault': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Vault to publish.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'URL to call with the PAYMENT-SIGNATURE header'}, 'body': {'type': 'object', 'properties': {}, 'description': 'JSON body to send, for POST', 'additionalProperties': {}}, 'note': {'type': 'string', 'description': 'Notes'}, 'x402': {'type': 'object', 'properties': {}, 'description': 'The x402 payment request (scheme, network, asset, payTo, amount, EIP-712 domain)', 'additionalProperties': {}}, 'method': {'type': 'string', 'description': 'HTTP method'}, 'howToPay': {'type': 'array', 'items': {}, 'description': 'Step-by-step signing instructions'}, 'alternatives': {'type': 'array', 'items': {}, 'description': 'Other accepted networks'}}, 'additionalProperties': {}}
stocks_rebalance
Rebalance your 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['vault'], 'properties': {'vault': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Your vault address.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Contract to call'}, 'data': {'type': 'string', 'description': 'Calldata, sign and broadcast as-is'}, 'mode': {'type': 'string', 'description': 'permit: sign typedData first'}, 'next': {'type': 'string', 'description': 'What to do next'}, 'after': {'type': 'string', 'description': 'What to do after it confirms'}, 'steps': {'type': 'array', 'items': {}, 'description': 'When two transactions are needed (approve, then deposit), sign and send them in order'}, 'value': {'type': 'string', 'description': 'Native value, always 0'}, 'chainId': {'type': 'number', 'description': 'Chain id (8453 = Base)'}, 'typedData': {'type': 'object', 'properties': {}, 'description': 'EIP-712 permit to sign off-chain (free, no gas)', 'additionalProperties': {}}, 'attribution': {'type': 'object', 'properties': {}, 'description': 'ERC-8021 builder attribution suffix info', 'additionalProperties': {}}}, 'additionalProperties': {}}
stocks_sell
Sell (redeem) basket shares
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['vault', 'shares'], 'properties': {'vault': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Vault whose shares you hold.'}, 'inKind': {'type': 'boolean', 'description': 'true = receive the 4 stock tokens instead of USDC.'}, '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.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Contract to call'}, 'data': {'type': 'string', 'description': 'Calldata, sign and broadcast as-is'}, 'mode': {'type': 'string', 'description': 'permit: sign typedData first'}, 'next': {'type': 'string', 'description': 'What to do next'}, 'after': {'type': 'string', 'description': 'What to do after it confirms'}, 'steps': {'type': 'array', 'items': {}, 'description': 'When two transactions are needed (approve, then deposit), sign and send them in order'}, 'value': {'type': 'string', 'description': 'Native value, always 0'}, 'chainId': {'type': 'number', 'description': 'Chain id (8453 = Base)'}, 'typedData': {'type': 'object', 'properties': {}, 'description': 'EIP-712 permit to sign off-chain (free, no gas)', 'additionalProperties': {}}, 'attribution': {'type': 'object', 'properties': {}, 'description': 'ERC-8021 builder attribution suffix info', 'additionalProperties': {}}}, 'additionalProperties': {}}
stocks_send
Send basket shares to anyone
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['vault', 'to', 'shares'], 'properties': {'to': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Recipient address.'}, 'vault': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Vault whose shares you hold.'}, 'shares': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Shares to send (18 decimals).'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Contract to call'}, 'data': {'type': 'string', 'description': 'Calldata, sign and broadcast as-is'}, 'mode': {'type': 'string', 'description': 'permit: sign typedData first'}, 'next': {'type': 'string', 'description': 'What to do next'}, 'after': {'type': 'string', 'description': 'What to do after it confirms'}, 'steps': {'type': 'array', 'items': {}, 'description': 'When two transactions are needed (approve, then deposit), sign and send them in order'}, 'value': {'type': 'string', 'description': 'Native value, always 0'}, 'chainId': {'type': 'number', 'description': 'Chain id (8453 = Base)'}, 'typedData': {'type': 'object', 'properties': {}, 'description': 'EIP-712 permit to sign off-chain (free, no gas)', 'additionalProperties': {}}, 'attribution': {'type': 'object', 'properties': {}, 'description': 'ERC-8021 builder attribution suffix info', 'additionalProperties': {}}}, 'additionalProperties': {}}
stocks_set_weights
Set your stock allocation
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['vault', 'weightsBps'], 'properties': {'vault': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Your vault address.'}, 'weightsBps': {'type': 'array', 'items': {'type': 'integer', 'maximum': 10000, 'minimum': 0}, 'maxItems': 4, 'minItems': 4, 'description': "4 weights in basis points summing to 10000, in the basket's constituent order (see stocks_basket)."}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Contract to call'}, 'data': {'type': 'string', 'description': 'Calldata, sign and broadcast as-is'}, 'mode': {'type': 'string', 'description': 'permit: sign typedData first'}, 'next': {'type': 'string', 'description': 'What to do next'}, 'after': {'type': 'string', 'description': 'What to do after it confirms'}, 'steps': {'type': 'array', 'items': {}, 'description': 'When two transactions are needed (approve, then deposit), sign and send them in order'}, 'value': {'type': 'string', 'description': 'Native value, always 0'}, 'chainId': {'type': 'number', 'description': 'Chain id (8453 = Base)'}, 'typedData': {'type': 'object', 'properties': {}, 'description': 'EIP-712 permit to sign off-chain (free, no gas)', 'additionalProperties': {}}, 'attribution': {'type': 'object', 'properties': {}, 'description': 'ERC-8021 builder attribution suffix info', 'additionalProperties': {}}}, 'additionalProperties': {}}
stocks_signals
Basket signals (paid, $0.007)
PAID over x402 inside this tool call ($0.007 USDC on Base, Polygon or Arc): the whole stock basket's rebalancing signal in one call (returns, volatility, RSI, trend, relative strength and inverse-volatility target weights for NVDA, META, AAPL, GOOGL). Call once without payment to get the x402 PaymentRequired, then call again with the signed payment in _meta["x402/payment"].
Read only
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'vault': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Optional vault to tailor the signal to.'}}}
stocks_signals_prepare
Prepare a paid signals call ($0.007)
Returns the x402 payment request for basket signals ($0.007 USDC on Base, Polygon or Arc): 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'vault': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Optional vault to tailor the signal to.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'URL to call with the PAYMENT-SIGNATURE header'}, 'body': {'type': 'object', 'properties': {}, 'description': 'JSON body to send, for POST', 'additionalProperties': {}}, 'note': {'type': 'string', 'description': 'Notes'}, 'x402': {'type': 'object', 'properties': {}, 'description': 'The x402 payment request (scheme, network, asset, payTo, amount, EIP-712 domain)', 'additionalProperties': {}}, 'method': {'type': 'string', 'description': 'HTTP method'}, 'howToPay': {'type': 'array', 'items': {}, 'description': 'Step-by-step signing instructions'}, 'alternatives': {'type': 'array', 'items': {}, 'description': 'Other accepted networks'}}, 'additionalProperties': {}}
stocks_vault
Stock vault state
Free. A basket vault's value (NAV), holdings, current vs target weights and whether it needs rebalancing.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Vault address.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'nav': {'type': 'number', 'description': 'NAV in dollars'}, 'owner': {'type': 'string', 'description': 'Owner'}, 'vault': {'type': 'string', 'description': 'Vault address'}, 'navUsdc': {'type': 'string', 'description': 'Net asset value (USDC, 6 decimals)'}, 'mintFeeBps': {'type': 'number', 'description': 'Mint fee'}, 'strategist': {'type': 'string', 'description': 'Strategist'}, 'weightsBps': {'type': 'array', 'items': {}, 'description': 'Target weights in basis points'}, 'totalSupply': {'type': 'string', 'description': 'Shares outstanding'}, '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'}}, 'additionalProperties': {}}
usdc_balances
USDC balances on every chain
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hints': {'type': 'array', 'items': {}, 'description': 'What to do next'}, 'chains': {'type': 'array', 'items': {}, 'description': 'Per chain: USDC and native gas balance'}, 'address': {'type': 'string', 'description': 'Address'}, 'totalUsdc': {'type': 'string', 'description': 'USDC across all chains'}}, 'additionalProperties': {}}
x402_check
x402 debugger
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The paid endpoint URL (https). It is called once, without payment, to read its 402.'}, 'body': {'type': 'object', 'description': 'JSON body for a POST url.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'method': {'enum': ['GET', 'POST'], 'type': 'string', 'description': 'HTTP method for url (default GET).'}, 'payment': {'type': 'string', 'maxLength': 20000, 'description': 'Optional signed payment header value to verify.'}, 'requirement': {'type': 'string', 'maxLength': 20000, 'description': 'Instead of url: the PAYMENT-REQUIRED header value (base64) or the 402 JSON body.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'requirement': {'type': 'object', 'properties': {}, 'description': 'Decoded payment request: options in plain English, warnings', 'additionalProperties': {}}, 'verification': {'type': 'object', 'properties': {}, 'description': 'If a payment was given: each facilitator check, pass/fail, and the fix', 'additionalProperties': {}}}, 'additionalProperties': {}}
History
Recent tool changes
Added
stocks_signals
Oct. 2, 2026, 2:40 a.m.
Added
polymarket_price_to_beat
Oct. 2, 2026, 2:40 a.m.
Changed
polymarket_prepare
Oct. 2, 2026, 2:40 a.m.
Changed
stocks_signals_prepare
Oct. 2, 2026, 2:40 a.m.
Added
liquid_guide
Sept. 30, 2026, 2:40 a.m.
Added
gas_sponsor_info
Sept. 30, 2026, 2:40 a.m.
Added
payment_readiness
Sept. 30, 2026, 2:40 a.m.
Added
x402_check
Sept. 30, 2026, 2:40 a.m.
Added
cctp_status
Sept. 30, 2026, 2:40 a.m.
Added
usdc_balances
Sept. 30, 2026, 2:40 a.m.
Added
stocks_publish_prepare
Sept. 30, 2026, 2:40 a.m.
Added
polymarket_prepare
Sept. 30, 2026, 2:40 a.m.
Added
stocks_signals_prepare
Sept. 30, 2026, 2:40 a.m.
Added
stocks_send
Sept. 30, 2026, 2:40 a.m.
Added
stocks_rebalance
Sept. 30, 2026, 2:40 a.m.
Added
stocks_sell
Sept. 30, 2026, 2:40 a.m.
Added
stocks_buy
Sept. 30, 2026, 2:40 a.m.
Added
stocks_set_weights
Sept. 30, 2026, 2:40 a.m.
Added
stocks_create_vault
Sept. 30, 2026, 2:40 a.m.
Added
stocks_portfolio
Sept. 30, 2026, 2:40 a.m.
Added
stocks_vault
Sept. 30, 2026, 2:40 a.m.
Added
stocks_buy_quote
Sept. 30, 2026, 2:40 a.m.
Added
stocks_basket
Sept. 30, 2026, 2:40 a.m.
Added
bridge_referral_earnings
Sept. 30, 2026, 2:40 a.m.
Added
bridge_status
Sept. 30, 2026, 2:40 a.m.
Added
bridge_routes
Sept. 30, 2026, 2:40 a.m.
Added
bridge_prepare_payment
Sept. 30, 2026, 2:40 a.m.
Added
bridge_quote
Sept. 30, 2026, 2:40 a.m.
Discover
Similar MCP servers
FortFi Treasury MCP
io.github.rebelArtists/fortfi-treasury-mcp
Provides policy-controlled crypto treasury operations across chains, including wallets, payments, token discovery, swaps, bridges…
Gate DEX MCP
io.github.gateio-dev/gate-dex
Supports wallet authentication, blockchain RPC access, token and market data, transaction construction, transfers, swaps, approva…
Tokenbooks - crypto and fiat accounting and payments
io.tokenbooks/tokenbooks
Maintains double-entry accounting for crypto and fiat portfolios, including wallet synchronization, transaction classification, c…
xrploracle
io.tooloracle/xrploracle
Provides XRPL intelligence for payments, accounts, DEX and AMM liquidity, escrows, NFTs, validators, issued-token compliance, and…
Inferventis MCP Server
ai.bankee/inferventis-mcp
Provides financial calculations, stock and cryptocurrency prices, currency conversion, banking transactions, and Stripe payment d…
Bity
io.github.mcp-dir/bity-mcp
Connects to Bity accounts for cryptocurrency and fiat balances, market tickers, order books, trades, open orders, executed orders…
wallet
lol.metamuse/wallet
Provides account balances, stock-token prices and quotes, USDG trade information, and on-chain payment settlement records.
SAP MCP Server
ai.oobeprotocol.sap.mcp/sap-mcp
Provides an MCP gateway connecting SAP-related tools with Solana, DeFi, decentralized identity, and x402 payments.