Swapper - XMR to USDC swaps

Official11 tools

by xmrtousdc

Swap Monero (XMR) <-> native USDC on Arbitrum One. No account or API key required. For AI agents.

xyz.xmrtousdc/monero-swap MCP Server

This MCP server provides functionality to swap Monero (XMR) and native USDC on Arbitrum One. The swap can be used “for AI agents,” and it is designed to require neither an account nor an API key. It is specifically focused on XMR <-> native USDC exchange.

🛠️ Key Features

Swap Monero (XMR) with native USDC
Operates on Arbitrum One
No account required
No API key required
Targeted for AI agents

🚀 Use Cases

Enable AI agents to perform XMR to USDC swaps
Enable AI agents to perform USDC to XMR swaps on Arbitrum One

⚡ Developer Benefits

Simplified integration since no account is required
Simplified integration since no API key is required
Purpose-built for AI agent workflows

Captured live from the server via tools/list.

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.

Parameters9

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

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "string",
      "pattern": "^(?:[0-9]+(?:\\.[0-9]+)?|\\.[0-9]+)$",
      "description": "What the user SENDS (x2u: XMR, u2x: USDC). Digits and one dot; no commas or units."
    },
    "receiveAmount": {
      "type": "string",
      "pattern": "^(?:[0-9]+(?:\\.[0-9]+)?|\\.[0-9]+)$",
      "description": "What the user wants to RECEIVE (u2x: XMR, x2u: USDC); needs direction.",
      "examples": [
        "1"
      ]
    },
    "direction": {
      "type": "string",
      "enum": [
        "x2u",
        "u2x"
      ],
      "description": "Required. u2x: send USDC, get XMR. x2u: send XMR, get USDC."
    },
    "to": {
      "type": "string",
      "description": "Destination from the user: x2u an Arbitrum One 0x address, u2x a Monero address. Never guess."
    },
    "basis": {
      "type": "string",
      "enum": [
        "estimate",
        "minimum"
      ],
      "description": "receiveAmount met by the estimate (default) or the provider minimum (if published)."
    },
    "requoteOf": {
      "type": "string",
      "pattern": "^q_[a-f0-9]{32}$",
      "description": "Re-quote this quoteId's stored parameters; pass it alone."
    },
    "chain": {
      "type": "string",
      "description": "Default arbitrum (42161)."
    },
    "agentKey": {
      "type": "string",
      "pattern": "^swk_[a-f0-9]{40}$",
      "description": "Optional key from request_agent_key."
    },
    "detail": {
      "type": "string",
      "enum": [
        "lean",
        "full"
      ]
    }
  },
  "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.

Parameters5

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

Raw schema

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

Parameters6

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

Raw schema

{
  "type": "object",
  "properties": {
    "orderId": {
      "type": "string",
      "description": "From create_swap or list_swaps."
    },
    "waitSec": {
      "type": "integer",
      "minimum": 0,
      "description": "Long-poll seconds for a change from sinceState (max 25; more is capped)."
    },
    "sinceState": {
      "type": "string",
      "enum": [
        "waiting_for_funding",
        "deposit_detected",
        "swap_processing",
        "refunding",
        "completed",
        "terminal_failure",
        "unknown"
      ],
      "description": "State from your previous call."
    },
    "verify": {
      "type": "string",
      "description": "Destination address (optional extra check)."
    },
    "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."
    },
    "detail": {
      "type": "string",
      "enum": [
        "lean",
        "full"
      ]
    }
  },
  "required": [
    "orderId"
  ],
  "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).

Parameters4

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

Raw schema

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

Parameters3

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

Raw schema

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

Parameters5

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

Raw schema

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

get_capabilities

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

Parameters1

detail

string

optional

Raw schema

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

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.

Parameters8

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

Raw schema

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

get_support_ticket

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

Parameters3

ticketId	string	required
replyToken	string	required
detail	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticketId": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$"
    },
    "replyToken": {
      "type": "string",
      "pattern": "^rt_[a-f0-9]{48}$"
    },
    "detail": {
      "type": "string",
      "enum": [
        "lean",
        "full"
      ]
    }
  },
  "required": [
    "ticketId",
    "replyToken"
  ],
  "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.

Parameters6

rating	integer	required
comment	string	optional
orderId	string	optional
publishable	boolean	optional	May other agents read the comment?
agentName	string	optional
detail	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "rating": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "comment": {
      "type": "string",
      "maxLength": 600
    },
    "orderId": {
      "type": "string"
    },
    "publishable": {
      "type": "boolean",
      "description": "May other agents read the comment?"
    },
    "agentName": {
      "type": "string",
      "maxLength": 64
    },
    "detail": {
      "type": "string",
      "enum": [
        "lean",
        "full"
      ]
    }
  },
  "required": [
    "rating"
  ],
  "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.

Parameters4

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

Raw schema

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

Install

Tools (11)

get_quotecreate_swapget_swap_statusget_funding_optionslist_swapsplan_swapget_capabilitiescreate_support_ticket

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://xmrtousdc.xyz/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "monero-swap": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmrtousdc.xyz/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

xyz.xmrtousdc/monero-swap MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

get_quote

create_swap

get_swap_status

get_funding_options

list_swaps

plan_swap

get_capabilities

create_support_ticket

get_support_ticket

submit_feedback

request_agent_key

Install

Remote endpoint

Related servers