Skip to content
Back to search

shieldz-swap-mcp

Swap crypto across 40+ chains from Claude, Cursor or any AI agent. MCP server for Shieldz Swap (swap.shieldz.cash): best-route quotes, non-custodial, no account, no KYC, 0.15% fee.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shieldzcash--shieldz-swap-mcp/badge.svg)](/listings/shieldzcash--shieldz-swap-mcp)

HTML

<a href="/listings/shieldzcash--shieldz-swap-mcp"><img src="/api/listings/shieldzcash--shieldz-swap-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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/mcp` - Claude Desktop or claude.ai: Settings → Connectors → Add custom connector → `https://swap.shieldz.cash/mcp` - Cursor, 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](https://github.com/ShieldZCash/shieldz-swap-mcp/releases/latest) and open it.

Docker

docker run -i --rm ghcr.io/shieldzcash/shieldz-swap-mcp

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 109 lines
  1. # Shieldz Swap MCP
  2. [![npm](https://img.shields.io/npm/v/@shieldz/swap-mcp)](https://www.npmjs.com/package/@shieldz/swap-mcp)
  3. [![CI](https://github.com/ShieldZCash/shieldz-swap-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/ShieldZCash/shieldz-swap-mcp/actions/workflows/ci.yml)
  4. [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
  5. [![Shieldz Swap MCP MCP server – quality and maintenance score on Glama](https://glama.ai/mcp/servers/ShieldZCash/shieldz-swap-mcp/badges/card.svg)](https://glama.ai/mcp/servers/ShieldZCash/shieldz-swap-mcp)
  6. Model Context Protocol server for [Shieldz Swap](https://swap.shieldz.cash). 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.
  7. **Not using an agent?** The same swap runs in your browser at [swap.shieldz.cash](https://swap.shieldz.cash): pick two coins, paste your address and send from your own wallet.
  8. - **No API key, no account, no KYC.**
  9. - **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.
  10. - **Route comparison.** Every quote races NEAR Intents, Chainflip, Relay, MAYAChain, BOB Gateway and Garden and returns the best output plus the alternatives.
  11. - **Flat 0.15% fee**, already included in the quoted output.
  12. - **Remote or local.** Hosted Streamable HTTP endpoint, npm package, Docker image or a one-click `.mcpb` bundle.
  13. ## Tools
  14. | Tool | Read-only | What it does |
  15. | --- | --- | --- |
  16. | `list_assets` | yes | Search routable assets by symbol or chain and get their exact ids. |
  17. | `get_quote` | yes | Live quote for `from_asset`, `to_asset`, `amount` (normal units). Best route, alternatives, guaranteed minimum, all-in cost % and ETA. |
  18. | `create_swap` | no | Re-quotes with the user's `destination_address` and `refund_address`, sets the minimum output floor and returns the deposit address, exact amount to send and expiry. Optional `protocol` pins a route. |
  19. | `get_swap_status` | yes | `PENDING`, `PROCESSING`, `SUCCESS`, `FAILED`, `REFUNDED`, `INCOMPLETE_DEPOSIT` or `EXPIRED`, with deposit, payout and refund transaction links. |
  20. | `report_deposit` | no | Optional: pass the deposit tx hash so the swap is detected faster. Never moves funds. |
  21. 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`.
  22. ### Example
  23. > **User:** Swap 50 USDC on Base to Zcash.
  24. >
  25. > **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.
  26. >
  27. > **Agent** calls `create_swap` → "Send exactly 50 USDC on BASE to `0x…` before 21:40 UTC."
  28. >
  29. > **Agent** calls `get_swap_status` → `SUCCESS`, payout tx link.
  30. ## Install
  31. ### Remote (no install)
  32. ```json
  33. {
  34. "mcpServers": {
  35. "shieldz-swap": { "type": "http", "url": "https://swap.shieldz.cash/mcp" }
  36. }
  37. }
  38. ```
  39. - Claude Code: `claude mcp add --transport http shieldz-swap https://swap.shieldz.cash/mcp`
  40. - Claude Desktop or claude.ai: Settings → Connectors → Add custom connector → `https://swap.shieldz.cash/mcp`
  41. - Cursor, Windsurf, VS Code, Cline: add the JSON above to the client's MCP config.
  42. ### Local (stdio, npx)
  43. ```json
  44. {
  45. "mcpServers": {
  46. "shieldz-swap": { "command": "npx", "args": ["-y", "@shieldz/swap-mcp"] }
  47. }
  48. }
  49. ```
  50. ### Claude Desktop bundle
  51. Download `shieldz-swap.mcpb` from the [latest release](https://github.com/ShieldZCash/shieldz-swap-mcp/releases/latest) and open it.
  52. ### Docker
  53. ```sh
  54. docker run -i --rm ghcr.io/shieldzcash/shieldz-swap-mcp
  55. ```
  56. ## Configuration
  57. | Variable | Default | Used by |
  58. | --- | --- | --- |
  59. | `SHIELDZ_SWAP_BASE_URL` | `https://swap.shieldz.cash` | stdio server: API base. |
  60. | `PORT`, `HOST` | `8787`, `127.0.0.1` | `node dist/remote.js`: listen address. |
  61. | `SWAP_API_BASE` | `https://swap.shieldz.cash` | `node dist/remote.js`: API base. |
  62. The remote server serves `/mcp` (Streamable HTTP, stateless, JSON responses) and a static server card at `/.well-known/mcp/server-card.json`.
  63. ## Limits
  64. 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.
  65. ## Security and privacy
  66. No keys, no custody, no stored conversations. See [SECURITY.md](SECURITY.md) and the [privacy policy](https://swap.shieldz.cash/privacy).
  67. ## Development
  68. ```sh
  69. npm install
  70. npm test # unit tests + SDK client end-to-end tests over stdio and HTTP
  71. ./scripts/pack-mcpb.sh
  72. ```
  73. ## Related
  74. - [@shieldz/mcp](https://github.com/ShieldZCash/shieldz-mcp): keyless crypto payment links, tip jars and pay-to-unlock for agents.
  75. ## License
  76. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.