Shieldz Swap MCP
OfficialUses NEAR Intents as a cross-chain swap route provider, allowing agents to compare NEAR Intents quotes against alternatives and create/track swaps routed through it.
Uses Relay as a cross-chain swap route provider, enabling agents to compare Relay quotes, pin it as a protocol if desired, and track swaps routed through it.
Supports Zcash (ZEC) as a swap asset and payout chain, enabling agents to quote swaps to/from ZEC, create non-custodial Zcash payouts, and track swap status.
Shieldz Swap MCP
Model Context Protocol server for Shieldz Swap. It lets an AI agent compare live cross-chain swap routes, create non-custodial swaps and track them to payout, across 340+ assets on 40+ chains: BTC, ETH, SOL, ZEC, USDC, USDT, TRON, BSC, Base, Arbitrum and more.
Not using an agent? The same swap runs in your browser at swap.shieldz.cash: pick two coins, paste your address and send from your own wallet.
No API key, no account, no KYC.
Non-custodial. A swap is a one-time deposit address. The user sends funds from their own wallet. The server never holds keys or signs anything.
Route comparison. Every quote races NEAR Intents, Chainflip, Relay, MAYAChain, BOB Gateway and Garden and returns the best output plus the alternatives.
Flat 0.15% fee, already included in the quoted output.
Remote or local. Hosted Streamable HTTP endpoint, npm package, Docker image or a one-click
.mcpbbundle.
Tools
Tool | Read-only | What it does |
| yes | Search routable assets by symbol or chain and get their exact ids. |
| yes | Live quote for |
| no | Re-quotes with the user's |
| yes |
|
| no | Optional: pass the deposit tx hash so the swap is detected faster. Never moves funds. |
Assets can be given as full ids (BASE.USDC-0x8335...) or CHAIN.SYMBOL shorthand (ZEC.ZEC, BTC.BTC, ETH.ETH, BASE.USDC). Amounts are normal decimal units ("0.05"), never wei or satoshis. Every tool returns structuredContent matching its outputSchema.
Example
User: Swap 50 USDC on Base to Zcash.
Agent calls
get_quote→ best route NEAR Intents, about 0.0659 ZEC, minimum 0.0652, about 2.5 minutes. Shows the numbers and asks for the user's ZEC address and Base wallet.Agent calls
create_swap→ "Send exactly 50 USDC on BASE to0x…before 21:40 UTC."Agent calls
get_swap_status→SUCCESS, payout tx link.
Related MCP server: safeswapglobal-mcp
Install
Remote (no install)
{
"mcpServers": {
"shieldz-swap": { "type": "http", "url": "https://swap.shieldz.cash/mcp" }
}
}Claude Code:
claude mcp add --transport http shieldz-swap https://swap.shieldz.cash/mcpClaude Desktop or claude.ai: Settings → Connectors → Add custom connector →
https://swap.shieldz.cash/mcpCursor, Windsurf, VS Code, Cline: add the JSON above to the client's MCP config.
Local (stdio, npx)
{
"mcpServers": {
"shieldz-swap": { "command": "npx", "args": ["-y", "@shieldz/swap-mcp"] }
}
}Claude Desktop bundle
Download shieldz-swap.mcpb from the latest release and open it.
Docker
docker run -i --rm ghcr.io/shieldzcash/shieldz-swap-mcpConfiguration
Variable | Default | Used by |
|
| stdio server: API base. |
|
|
|
|
|
|
The remote server serves /mcp (Streamable HTTP, stateless, JSON responses) and a static server card at /.well-known/mcp/server-card.json.
Limits
The public API rate-limits per caller IP: about 20 quotes in a burst then one every 2 seconds, and about 6 swap creations in a burst then one every 20 seconds. Minimum and maximum amounts depend on the route; errors say what they are.
Security and privacy
No keys, no custody, no stored conversations. See SECURITY.md and the privacy policy.
Development
npm install
npm test # unit tests + SDK client end-to-end tests over stdio and HTTP
./scripts/pack-mcpb.shRelated
@shieldz/mcp: keyless crypto payment links, tip jars and pay-to-unlock for agents.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Zero-key, non-custodial cross-chain crypto swap aggregator for AI agents: 100+ chains, 15+ providers
Non-custodial DEX aggregator for autonomous AI agents: best-price swaps on 8 chains, no API key.
Best-price cross-chain swap quotes across 70 chains (EVM + Solana). Holds no keys, never signs.
Token swaps and honeypot/rug checks for AI agents on 8 chains, paid per-call in USDC via x402.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI agents to find LayerZero OFT bridge routes by token address and build ready-to-sign cross-chain transactions across 14 EVM networks.362 npm1MIT
- AlicenseAqualityBmaintenanceReal-time non-custodial crypto swap rates, fees, and on-chain routing across 240+ multi-chain pairs.2MIT

Flashift MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables AI agents to compare rates across 100+ blockchains and 15+ liquidity providers, create non-custodial cross-chain swaps, and track transaction status without any API key. It exposes tools for listing currencies, quoting swaps with AI-ranked routing tags, generating deposit addresses, and monitoring exchanges to completion.MIT
soheil-routerofficial
AlicenseNot gradedqualityBmaintenanceEnables AI assistants to query supported networks and API details, fetch best-price token swap quotes across DEXes and aggregators, and check trade statuses.MIT