SwapZilla MCP — let AI agents swap crypto
An open-source Model Context Protocol (MCP) server that gives AI agents the tools to compare live rates and run non-custodial crypto swaps through SwapZilla — no account, no custody.
What is the SwapZilla MCP server?
The Model Context Protocol (MCP) is an open standard for connecting AI agents to external tools. The SwapZilla MCP server exposes SwapZilla's swap aggregator as a set of MCP tools, so an agent in Claude, Cursor, Windsurf or any MCP-compatible app can discover assets, compare provider rates, validate addresses, open a swap and track it — all programmatically.
It is a thin, non-custodial wrapper over SwapZilla's public API. The server never holds or moves funds: creating an exchange returns a deposit address, and the actual coins are sent by the user's own wallet. That keeps AI-driven swaps safe by design.
Tools exposed to the agent
| Tool | What it does |
|---|---|
swapzilla_list_assets | List supported assets, their networks and which providers cover each. |
swapzilla_list_providers | List the aggregated exchange providers and their status. |
swapzilla_get_quote | Compare live offers across all providers for a pair; each has an offer ID. |
swapzilla_validate_address | Check a recipient address for a network before swapping. |
swapzilla_create_exchange | Open a non-custodial swap from a chosen offer; returns a deposit address. |
swapzilla_get_order | Poll a swap's status and payout transaction hash. |
Install in one line
The server runs on Node.js 18+ and needs no API key for public rate data. Run it directly with npx:
npx -y https://swapzilla.io/mcp/swapzilla-mcp-1.0.0.tgz
Then register it with your MCP client (Claude Desktop, Claude Code, Cursor, Windsurf, …) and fully restart the client:
{
"mcpServers": {
"swapzilla": {
"command": "npx",
"args": ["-y", "https://swapzilla.io/mcp/swapzilla-mcp-1.0.0.tgz"]
}
}
}
Requires Node.js 18+. The package is served from swapzilla.io, so no npm account or global install is needed — npx fetches and runs it directly. Restart your MCP client after editing the config so it picks up the new server.
How an agent runs a swap
- The agent calls swapzilla_list_assets to resolve the exact asset code and network.
- It calls swapzilla_get_quote to compare live offers across every provider and pick the best.
- It calls swapzilla_validate_address to confirm the recipient address is valid for the network.
- It calls swapzilla_create_exchange with the chosen offer ID and receiving address, and gets a deposit address.
- The user's wallet sends the funds; the agent polls swapzilla_get_order until the swap settles.
Safe by design
The MCP server cannot spend your money. It only reads rates and orchestrates orders; every swap is non-custodial and settles wallet-to-wallet. The agent receives a deposit address to fund, but the funds are always sent from a wallet the user controls — there is no code path that moves crypto on its own.
Get the SwapZilla MCP server
Open-source and MIT-licensed. Add it to your agent in under a minute.
Download the package