create_support_ticket

Stuck or failed swap, or a question: Support answers (get_support_ticket). Follow up with ticketId + replyToken. Never seed phrases or keys.

Argument	Type	Description
detail	string
message*	string	What happened (sent what, when, what the user sees), or your question.
orderId	string	ord_... of the affected order.
category	string	Short topic, e.g. "stuck", "refund". Default "agent".
ticketId	string	Follow-up: an existing ticket.
sessionId	string	Session UUID, if known.
replyToken	string	With ticketId.
walletAddress	string	Public address involved (sending wallet or destination).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "message"
  ],
  "properties": {
    "detail": {
      "enum": [
        "lean",
        "full"
      ],
      "type": "string"
    },
    "message": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 3,
      "description": "What happened (sent what, when, what the user sees), or your question."
    },
    "orderId": {
      "type": "string",
      "description": "ord_... of the affected order."
    },
    "category": {
      "type": "string",
      "description": "Short topic, e.g. \"stuck\", \"refund\". Default \"agent\"."
    },
    "ticketId": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$",
      "description": "Follow-up: an existing ticket."
    },
    "sessionId": {
      "type": "string",
      "description": "Session UUID, if known."
    },
    "replyToken": {
      "type": "string",
      "pattern": "^rt_[a-f0-9]{48}$",
      "description": "With ticketId."
    },
    "walletAddress": {
      "type": "string",
      "description": "Public address involved (sending wallet or destination)."
    }
  },
  "additionalProperties": false
}

create_swap

Step 2. Creates the order from get_quote's next.arguments (quoteId, plus to if the quote had none): one order per quote; moves no funds. An order cannot be cancelled; unfunded, it expires. Retry with the same arguments: the default idempotencyKey returns the same order. Fund once, only while payable is true: before signing deposit.payment, get_swap_status {orderId, payment} must return paymentCheck.safeToSend. Next: get_swap_status.

Argument	Type	Description
to	string	Destination, only if the quote had none (next.missing). Never guess.
detail	string
quoteId*	string	From get_quote's next.arguments.
idempotencyKey	string	Optional; default q_<quoteId>. Reuse on every retry. A custom key: a fresh random UUID per intent.
quoteIntentDigest	string	From next.arguments: create fails if the quote's terms differ.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "quoteId"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Destination, only if the quote had none (next.missing). Never guess."
    },
    "detail": {
      "enum": [
        "lean",
        "full"
      ],
      "type": "string"
    },
    "quoteId": {
      "type": "string",
      "pattern": "^q_[a-f0-9]{32}$",
      "description": "From get_quote's next.arguments."
    },
    "idempotencyKey": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:_-]{8,128}$",
      "examples": [
        "75d26b1d-11b6-4283-9a06-8a612dcc4ffd"
      ],
      "description": "Optional; default q_<quoteId>. Reuse on every retry. A custom key: a fresh random UUID per intent."
    },
    "quoteIntentDigest": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "description": "From next.arguments: create fails if the quote's terms differ."
    }
  },
  "additionalProperties": false
}

get_capabilities

Optional. Chains, limits (provider minimum, USD), quote window, idempotency, validation rules, polling and the flow.

read-only

Argument	Type	Description
detail	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "detail": {
      "enum": [
        "lean",
        "full"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_funding_options

Offline. How to get what the user sends: native USDC (not USDC.e) plus a little ETH for gas on Arbitrum One (u2x, default), or XMR in their own wallet (x2u). Pass from {chain, asset} (and amount) for one ordered checklist: quote, fund, re-quote (requoteOf).

read-only

Argument	Type	Description
from	object	Where the funds are now.
amount	string	Send amount from a quote, if known.
detail	string
direction	string	u2x (default): the user sends USDC. x2u: XMR.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "from": {
      "type": "object",
      "properties": {
        "asset": {
          "type": "string",
          "description": "E.g. USDC, USDC.e, ETH, XMR."
        },
        "chain": {
          "type": "string",
          "description": "arbitrum, ethereum, another chain, or exchange (or its name)."
        }
      },
      "description": "Where the funds are now.",
      "additionalProperties": false
    },
    "amount": {
      "type": "string",
      "pattern": "^(?:[0-9]+(?:\\.[0-9]+)?|\\.[0-9]+)$",
      "description": "Send amount from a quote, if known."
    },
    "detail": {
      "enum": [
        "lean",
        "full"
      ],
      "type": "string"
    },
    "direction": {
      "enum": [
        "u2x",
        "x2u"
      ],
      "type": "string",
      "description": "u2x (default): the user sends USDC. x2u: XMR."
    }
  },
  "additionalProperties": false
}

get_quote

Step 1. Quote Monero (XMR) <-> native USDC on Arbitrum One; no account or API key. Creates no order. Quotes are estimates. Buy XMR ("get me 1 XMR"): {direction:"u2x", receiveAmount:"1"}. Sell XMR: {direction:"x2u", amount:"0.5"}. direction plus exactly one of amount (what the user sends) or receiveAmount (what they want). Pass to if known. Next: create_swap with next.arguments.

read-only

Argument	Type	Description
to	string	Destination from the user: x2u an Arbitrum One 0x address, u2x a Monero address. Never guess.
basis	string	receiveAmount met by the estimate (default) or the provider minimum (if published).
chain	string	Default arbitrum (42161).
amount	string	What the user SENDS (x2u: XMR, u2x: USDC). Digits and one dot; no commas or units.
detail	string
agentKey	string	Optional key from request_agent_key.
direction	string	Required. u2x: send USDC, get XMR. x2u: send XMR, get USDC.
requoteOf	string	Re-quote this quoteId's stored parameters; pass it alone.

get_support_ticket

Support's answer on your ticket: status, awaiting, thread. Answers take minutes to hours.

read-only

Argument	Type	Description
detail	string
ticketId*	string
replyToken*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ticketId",
    "replyToken"
  ],
  "properties": {
    "detail": {
      "enum": [
        "lean",
        "full"
      ],
      "type": "string"
    },
    "ticketId": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$"
    },
    "replyToken": {
      "type": "string",
      "pattern": "^rt_[a-f0-9]{48}$"
    }
  },
  "additionalProperties": false
}

get_swap_status

Step 3. waiting_for_funding -> deposit_detected -> swap_processing -> completed, or refunding / terminal_failure (outcome refunded, failed, expired). Long-poll with waitSec 25 and sinceState = the last state; repeat next until terminal. Call it before funding or showing a deposit again. payment: what your wallet will sign; sign only if paymentCheck.safeToSend.

read-only

Argument	Type	Description
detail	string
verify	string	Destination address (optional extra check).
orderId*	string	From create_swap or list_swaps.
payment	string	Unsigned only: tx JSON {to,data,value,chainId}, an ethereum:/monero: URI, calldata or an unsigned raw tx. Never a signed transaction.
waitSec	integer	Long-poll seconds for a change from sinceState (max 25; more is capped).
sinceState	string	State from your previous call.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "detail": {
      "enum": [
        "lean",
        "full"
      ],
      "type": "string"
    },
    "verify": {
      "type": "string",
      "description": "Destination address (optional extra check)."
    },
    "orderId": {
      "type": "string",
      "description": "From create_swap or list_swaps."
    },
    "payment": {
      "type": "string",
      "maxLength": 20000,
      "description": "Unsigned only: tx JSON {to,data,value,chainId}, an ethereum:/monero: URI, calldata or an unsigned raw tx. Never a signed transaction."
    },
    "waitSec": {
      "type": "integer",
      "minimum": 0,
      "description": "Long-poll seconds for a change from sinceState (max 25; more is capped)."
    },
    "sinceState": {
      "enum": [
        "waiting_for_funding",
        "deposit_detected",
        "swap_processing",
        "refunding",
        "completed",
        "terminal_failure",
        "unknown"
      ],
      "type": "string",
      "description": "State from your previous call."
    }
  },
  "additionalProperties": false
}

list_swaps

Find orders when the orderId is lost (new chat, crash, unknown create outcome): pass the idempotencyKey create_swap used (default q_<quoteId>), or a sessionId. Read-only; addresses redacted; states can lag. Next: get_swap_status (live state, payable).

read-only

Argument	Type	Description
detail	string
sessionId	string	Session UUID, instead of idempotencyKey.
idempotencyKey	string	The key create_swap used (default q_<quoteId>).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "detail": {
      "enum": [
        "lean",
        "full"
      ],
      "type": "string"
    },
    "sessionId": {
      "type": "string",
      "description": "Session UUID, instead of idempotencyKey."
    },
    "idempotencyKey": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:_-]{8,128}$",
      "description": "The key create_swap used (default q_<quoteId>)."
    }
  },
  "additionalProperties": false
}

plan_swap

Optional, offline. Checks a partial request (direction, amount or receiveAmount, to) and returns the next question for the user. Skip it when you have what get_quote needs.

read-only

Argument	Type	Description
to	string	Destination from the user: x2u an Arbitrum One 0x address, u2x a Monero address. Never guess.
amount	string	What the user sends.
detail	string
direction	string	u2x or x2u, as the user said it.
receiveAmount	string	What the user wants to receive.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "to": {
      "type": "string",
      "description": "Destination from the user: x2u an Arbitrum One 0x address, u2x a Monero address. Never guess."
    },
    "amount": {
      "type": "string",
      "description": "What the user sends."
    },
    "detail": {
      "enum": [
        "lean",
        "full"
      ],
      "type": "string"
    },
    "direction": {
      "type": "string",
      "description": "u2x or x2u, as the user said it."
    },
    "receiveAmount": {
      "type": "string",
      "description": "What the user wants to receive."
    }
  },
  "additionalProperties": false
}

request_agent_key

Optional. Issues a key that identifies this agent; quotes made with it (get_quote agentKey) and their orders use the agent fee (swapper://trust). The operator sees the name and contact given.

Argument	Type	Description
detail	string
contact	string	Optional; stored, shown to the operator.
purpose	string	Optional; stored, shown to the operator.
agentName	string	Default: the MCP client's name (clientInfo).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "detail": {
      "enum": [
        "lean",
        "full"
      ],
      "type": "string"
    },
    "contact": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional; stored, shown to the operator."
    },
    "purpose": {
      "type": "string",
      "maxLength": 500,
      "description": "Optional; stored, shown to the operator."
    },
    "agentName": {
      "type": "string",
      "maxLength": 64,
      "minLength": 2,
      "description": "Default: the MCP client's name (clientInfo)."
    }
  },
  "additionalProperties": false
}

submit_feedback

Optional, after a swap: a rating 1-5 and a comment. The published average counts one rating per completed Swapper order; a comment marked publishable is shown after operator review.

Argument	Type	Description
detail	string
rating*	integer
comment	string
orderId	string
agentName	string
publishable	boolean	May other agents read the comment?

Input schema (JSON)

{
  "type": "object",
  "required": [
    "rating"
  ],
  "properties": {
    "detail": {
      "enum": [
        "lean",
        "full"
      ],
      "type": "string"
    },
    "rating": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1
    },
    "comment": {
      "type": "string",
      "maxLength": 600
    },
    "orderId": {
      "type": "string"
    },
    "agentName": {
      "type": "string",
      "maxLength": 64
    },
    "publishable": {
      "type": "boolean",
      "description": "May other agents read the comment?"
    }
  },
  "additionalProperties": false
}

Swapper - XMR to USDC swaps

Try it

create_support_ticket

Swapper - XMR to USDC swaps

Try it

create_support_ticket

Tools (11)