Liquid Agent

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Money tools for AI agents over x402: USDC bridge to 16 chains, Polymarket data, stocks, USDC gas.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Liquid Agent": {
      "url": "https://api.liquidagent.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (32)

• bridge_quote read-only

  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.

  Parameters:

  • to (required) — string — 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).
  • amount (required) — string — USDC to RECEIVE on the destination, e.g. "1" or "25.5". Minimum 1.
  • ref — string — Optional referrer address: earns 20% of Liquid's fee. Omit if you have none.
  • from — string — Chain you pay on. Omit to pick the live route to `to` (Base to any listed chain; Arc to Base).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• bridge_prepare_payment read-only

  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.

  Parameters:

  • to (required) — string — 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).
  • amount (required) — string — USDC to RECEIVE on the destination, e.g. "1" or "25.5". Minimum 1.
  • ref — string — Optional referrer address: earns 20% of Liquid's fee. Omit if you have none.
  • from — string — Chain you pay on. Omit to pick the live route to `to` (Base to any listed chain; Arc to Base).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• bridge_routes read-only

  Free. Every Liquid Bridge route with its live price for 1 USDC and whether it is open.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• bridge_status read-only

  Free. Circle attestation and mint state for a bridge, by its burn transaction hash (returned by the bridge call).

  Parameters:

  • burnTx (required) — string — Burn transaction hash from the bridge response.
  • from — string — Source chain, if known.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• bridge_referral_earnings read-only

  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.

  Parameters:

  • address (required) — string — Referrer address.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• stocks_basket read-only

  Free. The on-chain tokenized US stock index on Base (NVDA, META, AAPL, GOOGL): live prices, fees, how to buy from $1.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• stocks_buy_quote read-only

  Free. Preview buying the tokenized stock basket: shares you would get and the fee for a USDC amount (USDC 6 decimals: "2000000" = $2).

  Parameters:

  • usdc (required) — string — Amount in USDC-6, e.g. "2000000" for $2.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• stocks_vault read-only

  Free. A basket vault's value (NAV), holdings, current vs target weights and whether it needs rebalancing.

  Parameters:

  • address (required) — string — Vault address.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• stocks_portfolio read-only

  Free. Everything an address owns in the tokenized stock basket: each vault, its shares and current USD value.

  Parameters:

  • address (required) — string — Wallet address to look up.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• stocks_create_vault read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• stocks_set_weights read-only

  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.

  Parameters:

  • vault (required) — string — Your vault address.
  • weightsBps (required) — array — 4 weights in basis points summing to 10000, in the basket's constituent order (see stocks_basket).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• stocks_buy read-only

  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.

  Parameters:

  • vault (required) — string — Your vault address.
  • usdc (required) — string — USDC to invest, 6 decimals, minimum "1000000" ($1).
  • owner — string — Your wallet address (required with usePermit).
  • minShares — string — Optional slippage floor: minimum shares to receive.
  • usePermit — boolean — true = return an EIP-2612 permit to sign first (no approve transaction).
  • permitDeadline — integer — Deadline from the permit you signed (second call).
  • permitSignature — string — Your signature of the permit typedData (second call).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• stocks_sell read-only

  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.

  Parameters:

  • vault (required) — string — Vault whose shares you hold.
  • shares (required) — string — Shares to redeem (18 decimals; see stocks_portfolio).
  • inKind — boolean — true = receive the 4 stock tokens instead of USDC.
  • minUsdcOut — string — Optional slippage floor in USDC-6.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• stocks_rebalance read-only

  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.

  Parameters:

  • vault (required) — string — Your vault address.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• stocks_send read-only

  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.

  Parameters:

  • vault (required) — string — Vault whose shares you hold.
  • to (required) — string — Recipient address.
  • shares (required) — string — Shares to send (18 decimals).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• stocks_signals_prepare read-only

  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.

  Parameters:

  • vault — string — Optional vault to tailor the signal to.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• polymarket_prepare read-only

  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.

  Parameters:

  • market (required) — string — Which market: <asset>-<timeframe>.
  • start — string — Optional unix start of a past window.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• polymarket_price_to_beat read-only

  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.

  Parameters:

  • market (required) — string — Which market: <asset>-<timeframe>.
  • free — boolean — Use your one free call (per agent) instead of paying.
  • start — string — Optional unix start of a past window (official outcome).

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• shop_info read-only

  Free. What the Mint & Marquee partner shop sells (custom 3D printed figurines, statues, keychains, bag tags; soccer, anime, crypto collections), its product count and price range, and how to search it.

  Parameters:

  • shop — string — Which partner shop.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• shop_search read-only

  PAID over x402 inside this tool call ($0.001 USDC on Arc, Base or Polygon): search the Mint & Marquee partner shop for gifts and collectibles. Returns products with price, photo, a short description and a link to buy. Show the person each product with its link, then the foundWith line once. Call once without payment to get the x402 PaymentRequired, then call again with the signed payment in _meta["x402/payment"].

  Parameters:

  • q — string — What to find, in words (e.g. soccer gift).
  • max — number — Optional price ceiling in USD.
  • limit — integer — How many products, 1 to 10 (default 5).

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• leads_count read-only

  Free. How many local businesses match a category and place, how many have an email at each grade (A/B/C), the top cities, and the exact price of the next page. Run this before leads_search.

  Parameters:

  • category (required) — string — Business type in plain words: dentist, plumber, hvac, roofing, hair salon, law firm, med spa, restaurant.
  • zip — string — 5-digit ZIP (a prefix works).
  • city — string — City, e.g. Atlanta, Savannah, Macon. Give city, county, zip or near.
  • near — string — lat,lng to search around.
  • email — string — required (default), any, or none (phone-only businesses).
  • limit — integer — How many leads, 1-1,000 (default 3 = $0.09); $0.03 per lead.
  • county — string — County, e.g. Gwinnett, Chatham.
  • hiring — boolean — Only businesses whose site says they are hiring.
  • offset — integer — Skip this many, for the next page.
  • sample — boolean — true = 3 free leads to judge quality (3 a day), no payment.
  • booking — string — Online booking tool: yes, none, vagaro, square_appointments, calendly, booksy, mindbody, acuity, opentable, housecall_pro, jobber, servicetitan, zocdoc.
  • website — string — needs = no working website (a sales signal).
  • minGrade — string — Email grade floor (A best). Default C.
  • payments — string — Payment system on their site: yes, none, square, toast, clover, stripe, paypal.
  • radiusKm — number — Radius for near, default 5.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• leads_search read-only

  PAID over x402 inside this tool call (USDC on Base or Arc, $0.03 per lead returned, flat, with or without an email; default 3 leads = $0.09; set sample=true for 3 free leads first; the PaymentRequired quotes the exact total; no leads, no charge): local businesses by category and place with a graded email (A/B/C), a contact name when the email shows one, phone, website, socials and buying signals (no website, booking tool, payment system, hiring). Call once without payment to get the x402 PaymentRequired, then call again with the signed payment in _meta["x402/payment"].

  Parameters:

  • category (required) — string — Business type in plain words: dentist, plumber, hvac, roofing, hair salon, law firm, med spa, restaurant.
  • zip — string — 5-digit ZIP (a prefix works).
  • city — string — City, e.g. Atlanta, Savannah, Macon. Give city, county, zip or near.
  • near — string — lat,lng to search around.
  • email — string — required (default), any, or none (phone-only businesses).
  • limit — integer — How many leads, 1-1,000 (default 3 = $0.09); $0.03 per lead.
  • county — string — County, e.g. Gwinnett, Chatham.
  • hiring — boolean — Only businesses whose site says they are hiring.
  • offset — integer — Skip this many, for the next page.
  • sample — boolean — true = 3 free leads to judge quality (3 a day), no payment.
  • booking — string — Online booking tool: yes, none, vagaro, square_appointments, calendly, booksy, mindbody, acuity, opentable, housecall_pro, jobber, servicetitan, zocdoc.
  • website — string — needs = no working website (a sales signal).
  • minGrade — string — Email grade floor (A best). Default C.
  • payments — string — Payment system on their site: yes, none, square, toast, clover, stripe, paypal.
  • radiusKm — number — Radius for near, default 5.

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• leads_lookup read-only

  PAID over x402 inside this tool call ($0.01 USDC on Base or Arc per lookup that finds a business; no match, no charge): give a US phone number or a website and get the local business behind it: name, address, category, the best email graded A/B/C, a contact name when the email shows one, socials and buying signals. A website only matches when it carries the business's own phone number. Call once without payment to get the x402 PaymentRequired, then again with the signed payment in _meta["x402/payment"].

  Parameters:

  • phone — string — A US phone number, any format: 4043552001, (404) 355-2001, +14043552001. Give phone or domain.
  • domain — string — Or a website: example.com or https://www.example.com/contact.

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• leads_tech read-only

  PAID over x402 inside this tool call ($0.005 USDC on Base or Arc per lookup that finds a verified site; no match, no charge): give a website or a US phone number and get the site platform (WordPress, Wix, Squarespace, Shopify...), online booking tool (Square Appointments, Vagaro, Calendly, Zocdoc...), payment system (Square, Toast, Clover, Stripe...), hiring and socials, read from the business's own verified website. Call once without payment to get the x402 PaymentRequired, then again with the signed payment in _meta["x402/payment"].

  Parameters:

  • phone — string — A US phone number, any format: 4043552001, (404) 355-2001, +14043552001. Give phone or domain.
  • domain — string — Or a website: example.com or https://www.example.com/contact.

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• stocks_signals read-only

  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"].

  Parameters:

  • vault — string — Optional vault to tailor the signal to.

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• stocks_publish_prepare read-only

  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.

  Parameters:

  • vault (required) — string — Vault to publish.
  • label — string — Optional page title.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• usdc_balances read-only

  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.

  Parameters:

  • address (required) — string — EVM address.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• cctp_status read-only

  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.

  Parameters:

  • txHash (required) — string — Burn transaction hash on the source chain.
  • from — string — Source chain, if known (faster).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• x402_check read-only

  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.

  Parameters:

  • url — string — The paid endpoint URL (https). It is called once, without payment, to read its 402.
  • body — object — JSON body for a POST url.
  • method — string — HTTP method for url (default GET).
  • payment — string — Optional signed payment header value to verify.
  • requirement — string — Instead of url: the PAYMENT-REQUIRED header value (base64) or the 402 JSON body.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• payment_readiness read-only

  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).

  Parameters:

  • address (required) — string — The paying wallet.
  • url — string — The paid endpoint URL (https). It is called once, without payment, to read its 402.
  • body — object — JSON body for a POST url.
  • method — string — HTTP method for url (default GET).
  • requirement — string — Instead of url: the PAYMENT-REQUIRED header value (base64) or the 402 JSON body.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• gas_sponsor_info read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• liquid_guide read-only

  Free. Overview of every Liquid Agent service for agents (bridge, stocks, signals, gas sponsor), prices and where the full docs are.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.