Swap crypto from Claude, Cursor or any AI agent
Shieldz Swap has an MCP server. Connect it to your AI assistant and ask in plain words: the agent quotes the swap across NEAR Intents, Chainflip, Relay, MAYAChain, BOB Gateway and Garden, opens it on 40+ chains and tracks it until the coins arrive. It is the same router and the same 0.15% fee as the app. No API key, no account, and you still send from your own wallet.
Add the server URL
The server runs at https://swap.shieldz.cash/mcp (Streamable HTTP).
Claude Code
claude mcp add --transport http shieldz-swap https://swap.shieldz.cash/mcp
Claude Desktop or claude.ai: Settings, Connectors, Add custom connector, then paste the URL.
Cursor, Windsurf, VS Code, Cline: add this to the MCP config.
{
"mcpServers": {
"shieldz-swap": { "type": "http", "url": "https://swap.shieldz.cash/mcp" }
}
}Or run it on your machine
The npm package runs the same tools over stdio. It needs Node.js 18 or newer.
{
"mcpServers": {
"shieldz-swap": { "command": "npx", "args": ["-y", "@shieldz/swap-mcp"] }
}
}For Claude Desktop there is also a one-click bundle: download shieldz-swap.mcpb from the latest release and open it.
The server is listed in the official MCP Registry as io.github.ShieldZCash/swap-mcp.
Five tools
| Tool | What it does | Changes anything? |
|---|---|---|
list_assets | Finds a coin or token among 340+ assets and returns its exact id. | No |
get_quote | Live quote from every route at once: best output, alternatives, guaranteed minimum, all-in cost and time. | No |
create_swap | Opens the swap with your payout and refund addresses and returns a one-time deposit address. | Creates a deposit address. Nothing moves until you send. |
get_swap_status | Pending, processing, done, refunded or expired, with transaction links. | No |
report_deposit | Passes your deposit transaction hash so the swap is picked up sooner. | No funds move |
A swap, start to finish
- You: "Swap 50 USDC on Base to Zcash." The agent calls
get_quoteand shows what you get, the minimum and the route. - You agree and give a Zcash address to receive on and a Base address for refunds.
- The agent calls
create_swapand gives you a deposit address, the exact amount and a deadline. - You send the USDC from your own wallet. The agent checks
get_swap_statusand tells you when the ZEC has landed.
The agent never touches your keys
The server cannot sign or send anything. A swap is a deposit address, and funds only move when you send them yourself. If a swap cannot complete, the protocol returns the funds to your refund address.
Before handing out a deposit address the server quotes again with your real addresses and checks that the amounts match. The agent is told never to invent an address, and to pass on every warning, such as a required memo.
Quotes are rate-limited per caller, like the app. Read how a swap can fail before a large swap.
Accept crypto payments from an agent
The Shieldz payments MCP lets an agent turn a wallet address into a payment link or tip jar, also with no API key.