Warden MCP

What this connected wallet has authorised agents to do, whether an unattended trading session is open, and the daily limits that apply.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "agent_permissions",
    "arguments": {}
  }
}

Sign and broadcast a swap from the user’s wallet without asking them. Only works while the user has hands-free trading on (agent_permissions → handsFree), and within the same limits as prepare_swap; if it is off, tell the user how to turn it on (handsFree.tellUser). Spends real funds: check agent_permissions first, and reuse the idempotencyKey on any retry. Sell the native coin by its address from list_chains. If the wallet has no gas coin (see get_wallet), sell an ERC-20 with gasless=true. Set buyChainId to land the bought token on another chain; then follow the trade with swap_status.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "execute_swap",
    "arguments": {
      "chainId": 0,
      "sellToken": "...",
      "buyToken": "...",
      "sellAmount": "...",
      "idempotencyKey": "..."
    }
  }
}

The connected wallet, its X handle if linked, and everything it holds on every chain: the gas coin and each token, with the exact raw amount to use as sellAmount and a USD value where Warden can price it. A chain with no gas coin means: sell an ERC-20 with gasless=true where gaslessAvailable, or fund it first. Tokens under unrecognised were sent to the wallet unasked (not listed, not bought): never count them as money or suggest selling them unless the person names one.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_wallet",
    "arguments": {}
  }
}

Chains Warden supports, with each chain’s native coin, dollar stable and gasless support.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_chains",
    "arguments": {}
  }
}

Build a swap for the user to sign. Does not broadcast. Requires the "swap" permission. Native coin, cross-chain (buyChainId) and gasless (typed-data payloads instead of calldata) are all supported. Give the user reviewUrl: it opens the app with this exact trade filled in, ready to sign. If hands-free trading is on, use execute_swap instead.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "prepare_swap",
    "arguments": {
      "chainId": 0,
      "sellToken": "...",
      "buyToken": "...",
      "sellAmount": "..."
    }
  }
}

Candles for a token on its deepest pool, oldest first, priced in USD: time (unix seconds), open, high, low, close, volume. Also returns a summary: the change over the window, its high and low, and how far the last close sits below the high and above the low, to judge a pullback or a breakout before buying. Read-only.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "price_history",
    "arguments": {
      "chainId": 0,
      "token": "..."
    }
  }
}

Price a swap without committing to it. Read-only. Works for the native coin (use its address from list_chains) and across chains (buyChainId).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "quote_swap",
    "arguments": {
      "chainId": 0,
      "sellToken": "...",
      "buyToken": "...",
      "sellAmount": "..."
    }
  }
}

Ask the wallet owner to turn on hands-free trading, so execute_swap works. Returns an approveUrl and a code: give both to the person and ask them to open the link and check the code matches. They approve with one tap in Warden; nothing changes until they do. Then poll session_request_status every few seconds (the request lasts 10 minutes). hours is how long the session lasts. limits is optional and replaces the wallet's daily and per-trade limits in whole dollars; leave it out to keep them.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "request_session",
    "arguments": {
      "hours": "..."
    }
  }
}

Find tokens by name, ticker or contract address across the supported chains. Tickers are not unique: many contracts call themselves USDC, USDT or ETH. Prefer rows with verifiedByWarden true (Warden reviewed the team, or it is a Warden token) or establishedAsset true (a well-known token at its genuine contract, not reviewed by Warden); never trade a row that carries a warning as if it were the real asset, and for dollars and gas use `cash` and `native` from list_chains.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_tokens",
    "arguments": {
      "query": "..."
    }
  }
}

Whether the person has answered a request_session: pending, approved, denied or expired. Once approved, execute_swap works until the session ends.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "session_request_status",
    "arguments": {
      "code": "..."
    }
  }
}

Where a gasless (relayed) or cross-chain (bridged) trade stands. Poll every few seconds until done is true. Plain same-chain swaps confirm on-chain and need no polling.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "swap_status",
    "arguments": {
      "kind": "gasless",
      "chainId": 0,
      "hash": "..."
    }
  }
}

Tokens trending right now on a chain.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "trending_tokens",
    "arguments": {
      "chainId": 0
    }
  }
}