Swap MCP
● Activeio.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.
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"
]
}
}
}claude mcp add swap-mcp -- npx -y @shieldz/swap-mcp@0.1.1codex mcp add swap-mcp -- npx -y @shieldz/swap-mcp@0.1.1code --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
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks 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 →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 paramsSearch 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 parametersHide 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 paramsGet 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 parametersHide parameters
from_assetstringrequiredSource (what the user sends). asset. Either an exact asset_id from list_assets ("BASE.USDC-0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913") or CHAIN.SYMBOL shorthanto_assetstringrequiredDestination (what the user receives). asset. Either an exact asset_id from list_assets ("BASE.USDC-0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913") or CHAIN.SYMBOLamountstringrequiredAmount 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 paramsOpen 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 parametersHide parameters
from_assetstringrequiredSource (what the user sends). asset. Either an exact asset_id from list_assets ("BASE.USDC-0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913") or CHAIN.SYMBOL shorthanto_assetstringrequiredDestination (what the user receives). asset. Either an exact asset_id from list_assets ("BASE.USDC-0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913") or CHAIN.SYMBOLamountstringrequiredExact 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 beloprotocolstringOptional. 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 paramLook 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 parametersHide parameters
swap_idstringrequiredswap_id exactly as returned by create_swap, e.g. "near:0xAbc..." or "chainflip:123-Btc-45".
report_deposit2 paramsTell 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 parametersHide 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-http
https://swap.shieldz.cash/mcp
Alternatives to Swap MCP
All Swap MCP alternatives →Best Crypto & Web3 servers →The most-starred Crypto & Web3 servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Oh My Posh Validator | 23,772 | Nov 2026 | Working |
| Solana MCP by Vybe | 2,728 | Oct 2026 | Working |
| Solana MCP by Vybe | 2,728 | Oct 2026 | Working |
| Oracle3 prediction-market agent tools | 569 | Nov 2026 | Local / not checked |
| Flyto Core | 483 | Nov 2026 | Local / 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.
More from ShieldZCash
All 2 servers by ShieldZCash →More Crypto & Web3 servers
Browse all Crypto & Web3 →Shinjuku Shield
ShinjukuStaition
Private x402 payments on Solana: shield, pay, and unshield USDC under caps you set.
Basis Protocol
shlok-lgtm
Stablecoin risk scores, wallet risk profiles, and transaction risk assessment.
x402 Agent Tools
signal-forge-ai
Pay-per-call web, Base onchain and crypto-alert tools for agents. USDC on Base via x402, no API key.
SimianX AI
SimianX-AI
8-agent research committee, live analysis and scored news on US stocks and crypto, for any agent.
Sellat
skanthemore
Proof of existence for files from any MCP client: hashed locally, anchored on Polygon and Bitcoin.
Cryptoetf
zerosix-studio
Live spot crypto ETF flows for 16 assets and their funds, CEFI index and prices.
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.
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
[](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.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-shieldzcash-swap-mcp) [](https://serverdex.io/install/vscode/io-github-shieldzcash-swap-mcp) [](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).