Swap MCP

● Active

io.github.ShieldZCash/swap-mcp

Non-custodial cross-chain swaps for AI agents: live route quotes and deposit swaps on 40+ chains.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "swap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shieldz/swap-mcp@0.1.1"
      ]
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add swap-mcp -- npx -y @shieldz/swap-mcp@0.1.1
OpenAI Codex CLI
codex mcp add swap-mcp -- npx -y @shieldz/swap-mcp@0.1.1
VS Code
code --add-mcp '{"name":"swap-mcp","type":"stdio","command":"npx","args":["-y","@shieldz/swap-mcp@0.1.1"]}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Crypto & Web3
Version
0.1.1
Registry
active
Published
11/21/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Swap MCP is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit today (Nov 21, 2026), 0 open issues.
Official registry
Active
Published as io.github.ShieldZCash/swap-mcp in the official MCP registry, version 0.1.1.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Local package or hosted
Ships as a local package (npm) that runs on your machine, and as a hosted endpoint at swap.shieldz.cash that receives what your client sends it.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 06:07 UTCStatus history & uptime →
● Working636 msprotocol 2025-06-18v0.1.1tools

The endpoint answered the MCP handshake as "shieldz-swap" and listed 5 tools. Answering since Nov 22, 2026.

Context cost ≈ 4.3k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 5 tools.

Tools (5)

  • list_assets3 params

    Search the 340+ assets on 40+ chains that Shieldz Swap can route and return their exact asset ids. Use it when you are unsure of an id or which chains support a token (e.g. every chain that has USDC). Skip it for common native coins: get_quote and create_swap already accept shorthand like ZEC.ZEC or BTC.BTC. With no filters it also returns the list of chain codes. Read-only; the list is cached for 60 seconds.

    Show parameters
    • searchstringCase-insensitive symbol or asset id fragment, e.g. "usdc", "zec", "0x8335".
    • chainstringExact chain code filter, e.g. ETH, BASE, ARB, OP, POL, BSC, SOL, BTC, ZEC, TRON, NEAR. Leave empty for all chains.
    • limitintegerMaximum assets to return (1-100, default 40). Verified assets come first.
  • get_quote3 params

    Get live prices for swapping one asset into another, across chains, by racing NEAR Intents, Chainflip, Relay, MAYAChain, BOB Gateway and Garden. Returns the best route and the alternatives, with output after fees, guaranteed minimum, all-in cost % and ETA. Use it to answer "how much X do I get for Y" and to show the user the numbers before create_swap. It creates nothing and needs no addresses. from_asset is what the user sends and to_asset what they receive; they may sit on different chains. Give each as an exact asset id or CHAIN.SYMBOL; when a shorthand is ambiguous (bridged USDC, for example) the error lists the matching ids, and list_assets finds ids by name or chain. amount is how much from_asset the user sends, in from_asset's own units, never in to_asset or USD. Quotes move with the market, so do not reuse one after a few minutes; create_swap re-quotes on its own. Shieldz charges a flat 0.15% (already in amount_out). Errors explain unsupported pairs or minimum and maximum amounts. Rate-limited per caller (roughly 20 quotes in a burst, then one every 2 seconds).

    Show parameters
    • from_assetstringrequiredSource (what the user sends). asset. Either an exact asset_id from list_assets ("BASE.USDC-0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913") or CHAIN.SYMBOL shorthan
    • to_assetstringrequiredDestination (what the user receives). asset. Either an exact asset_id from list_assets ("BASE.USDC-0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913") or CHAIN.SYMBOL
    • amountstringrequiredAmount of from_asset in normal decimal units as a string ("100", "0.05"), NOT base units or wei. Digits and one optional dot only; no commas, signs or exponents
  • create_swap6 params

    Open a non-custodial swap and return a one-time deposit address. Use it only after the user has seen a quote, agreed to the amount and route, and given you both addresses. from_asset, to_asset and amount mean the same as in get_quote: pass the values the user agreed to. destination_address must be on to_asset's chain and refund_address on from_asset's chain, usually the sending wallet; BTC to ZEC, for example, needs a Zcash payout address and a Bitcoin refund address. NEVER invent, guess or reuse addresses from elsewhere in the conversation. Set protocol only to keep the route the user picked from get_quote's alternatives. The tool re-quotes with the real addresses, sets the minimum output from that quote and returns an error rather than a deposit if the amounts changed. Nothing moves until the user sends exactly send_exactly from their own wallet before expires_at; the server never holds keys or signs. If the swap cannot complete, funds go back to refund_address. Each call creates a new deposit address, so do not call it again to "retry" a swap the user already funded. Rate-limited per caller (about 6 swaps in a burst, then one every 20 seconds).

    Show parameters
    • from_assetstringrequiredSource (what the user sends). asset. Either an exact asset_id from list_assets ("BASE.USDC-0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913") or CHAIN.SYMBOL shorthan
    • to_assetstringrequiredDestination (what the user receives). asset. Either an exact asset_id from list_assets ("BASE.USDC-0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913") or CHAIN.SYMBOL
    • amountstringrequiredExact amount of from_asset the user will send, in normal decimal units ("100", "0.05"), not base units.
    • destination_addressstringrequiredAddress the user gave you on the destination chain (to_asset's chain). Swapped funds are paid here.
    • refund_addressstringrequiredAddress the user gave you on the source chain (from_asset's chain), usually the wallet they send from. Refunds go here if the swap fails or the price drops belo
    • protocolstringOptional. Pin this route, e.g. the alternative the user chose from get_quote. Omit to use the best route at creation time.
  • get_swap_status1 param

    Look up a swap made with create_swap by its swap_id and explain where it is: PENDING (no deposit seen yet), PROCESSING, SUCCESS, FAILED, REFUNDED, INCOMPLETE_DEPOSIT (less than required arrived) or EXPIRED (address closed, never send to it). swap_id is the protocol-prefixed id create_swap returned, such as near:<deposit address> or chainflip:<block>-<network>-<channel>; pass it unchanged, prefix included. Returns amounts in normal units and the deposit, payout and refund transaction links. A malformed id is rejected before any request, an unknown one returns "No swap with that id", and a router outage returns an error to retry later. Use it when the user asks whether their swap arrived. Read-only and safe to repeat; poll every 30 seconds or more, not in a tight loop.

    Show parameters
    • swap_idstringrequiredswap_id exactly as returned by create_swap, e.g. "near:0xAbc..." or "chainflip:123-Btc-45".
  • report_deposit2 params

    Tell the router the hash of the deposit transaction the user just sent, so the swap is detected immediately instead of on the next scan. Optional: swaps are detected without it, and it never moves funds. swap_id is the id create_swap returned for this swap. tx_hash is the hash of the transaction that sent funds to that swap's deposit_address on the source chain (0x-prefixed on EVM chains); never pass a payout hash or another swap's id. An unknown swap_id returns an error. Use it once, right after the user shares their tx hash, then follow up with get_swap_status. Calling it again with the same hash is harmless.

    Show parameters
    • swap_idstringrequiredswap_id returned by create_swap.
    • tx_hashstringrequiredHash of the user's deposit transaction on the source chain (0x... on EVM chains). Letters and digits only, up to 128 characters.

Checked by Serverdex with a plain initialize + tools/list call to swap.shieldz.cash/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 22, 2026
Stars
0
Forks
0
Last push
Nov 21, 2026
License
MIT

TypeScriptai-agentsbitcoinbridgechainflipcross-chaincross-chain-swapcrypto-swapdex-aggregatorethereummcpmcp-servermodel-context-protocolnear-intentsno-kycnon-custodialshieldzsolanausdcusdtzcash

From the README

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 .mcpb bundle. Tools 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.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://swap.shieldz.cash/mcp

The most-starred Crypto & Web3 servers in the index, with their live-check result.

ServerStarsLast pushLive check
Oh My Posh Validator23,772Nov 2026Working
Solana MCP by Vybe2,728Oct 2026Working
Solana MCP by Vybe2,728Oct 2026Working
Oracle3 prediction-market agent tools569Nov 2026Local / not checked
Flyto Core483Nov 2026Local / not checked

Swap MCP: questions people ask

Is Swap MCP a remote or a local MCP server?
According to its entry in the official MCP registry, Swap MCP ships as a hosted endpoint (streamable-http) that your client connects to by URL and as a local package (npm) that your client starts on your machine. Use the hosted endpoint when your client supports Streamable HTTP; use the package when you want it to run locally.
Does Swap MCP need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Swap MCP safe to use?
Looks healthy: Swap MCP is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Local package or hosted; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Swap MCP still maintained?
Active: the repository's last commit today. Last push Nov 21, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 22, 2026.
What tools does Swap MCP expose?
5 tools as listed by the server itself during the live check, including list_assets, get_quote, create_swap, get_swap_status, report_deposit. The full list with parameters is in the Live check section above.
How do I add Swap MCP to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
  1. ShieldZCash MCPKeyless non-custodial crypto payments for AI agents: payment links and tip jars, no API key.
Browse all Crypto & Web3 →

Add the badge to your site

Show visitors that Swap MCP is listed here — it’s also the link we check for a free listing.

Swap MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-shieldzcash-swap-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Swap MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Swap MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-shieldzcash-swap-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-shieldzcash-swap-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-shieldzcash-swap-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-shieldzcash-swap-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-shieldzcash-swap-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-shieldzcash-swap-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-shieldzcash-swap-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).