GhostSwap

● Active

io.github.ghostswap1/mcp

GhostSwap — non-custodial crypto swaps across 1,600+ coins.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

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": {
    "mcp": {
      "url": "https://mcp.ghostswap.io/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http mcp https://mcp.ghostswap.io/mcp
VS Code
code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.ghostswap.io/mcp"}'

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. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

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

Category
Crypto & Web3
Version
1.0.0
Registry
active
Published
6/7/2026

Live check

checked Nov 19, 2026, 19:07 UTC
● Working742 msprotocol 2025-06-18v1.3.2tools

The endpoint answered the MCP handshake as "ghostswap-partners" and listed 7 tools. Answering since Nov 18, 2026.

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

Tools (7)

tool list changed Nov 19, 2026, 19:07 UTC
  • list_currencies1 param

    List all coins GhostSwap supports for swapping (1,600+ coins). Use lite=true for just an array of tickers (e.g. ["btc","eth","ltc"]). Full metadata includes requiresExtraId + extraIdName: when the TO coin has requiresExtraId=true (XRP, XLM, ATOM, HBAR, TON…), collect the memo / destination tag before create_swap.

    Show parameters
    • litebooleanReturn just tickers (default false — full metadata).
  • get_pair2 params

    Get the min and max swap amount for a single (from, to) pair. Returns separate min/max for float-rate and fixed-rate modes.

    Show parameters
    • fromstringrequiredSource currency ticker, lowercase (e.g. "btc").
    • tostringrequiredDestination currency ticker, lowercase (e.g. "eth").
  • validate_address2 params

    Check whether a wallet address is valid for a given currency. Returns {valid:true} or {valid:false,message}. Permissive pre-check — create_swap runs a stricter validator.

    Show parameters
    • currencystringrequiredTicker, lowercase.
    • addressstringrequiredThe wallet address to validate.
  • get_quote4 params

    Get a live swap quote — rate, amountUserReceives, network fee, min/max. Always display amountUserReceives (not amountTo). mode="fixed" locks the rate and returns a short-lived rateId. The result includes swapUrl, a ghostswap.io link with this pair and amount filled in that the user can open to swap themselves.

    Show parameters
    • fromstringrequiredSource currency ticker.
    • tostringrequiredDestination currency ticker.
    • amountFromstringrequiredDecimal amount as a STRING (e.g. "0.01"). Strings preserve precision.
    • modestringFloat (default) settles at market; fixed locks via rateId.
  • get_swap_link3 params

    Get a ghostswap.io link that opens the swap with the coins (and optionally the amount) already filled in. Give it to the user when they want to do the swap themselves in the browser, or when create_swap isn't available. The link creates nothing and never carries an address: the user enters their own receiving and refund address on the page and presses Exchange. Tickers are network-specific (usdtrx = USDT on Tron, usdt20 = USDT on Ethereum). Check the amount against get_pair or get_quote first; below the minimum the page shows a warning.

    Show parameters
    • fromstringrequiredTicker to send, lowercase (e.g. "btc").
    • tostringrequiredTicker to receive, lowercase (e.g. "xmr").
    • amountFromstringOptional amount of the "from" coin as a STRING (e.g. "0.05").
  • create_swap11 params

    Create a new swap. Returns payinAddress where the end-user must send funds. REQUIRES refundAddress (the user's own wallet on the FROM chain). If the TO coin needs a memo / destination tag (requiresExtraId on list_currencies), pass it as extraId — without it the API returns missing_extra_id; only if the user confirms their wallet has no tag, send extraIdNotRequired=true. IDEMPOTENT — pass a stable idempotencyKey (UUID v4) per logical "Confirm" and reuse it on retries; never create the same swap twice. If a result has stop:true, relay its neutral userMessage and STOP — never speculate about the reason, never name an address, never suggest "try a different address", never retry.

    Show parameters
    • fromstringrequired
    • tostringrequired
    • amountFromstringrequiredDecimal as STRING.
    • addressstringrequiredWhere the user receives the "to" currency.
    • extraIdstringMemo / destination tag / payment ID for `address`. REQUIRED when the TO coin has requiresExtraId=true (e.g. an exchange deposit address on XRP, XLM, ATOM). Ask
    • extraIdNotRequiredbooleanSet true ONLY when the user confirms their TO-coin wallet genuinely has no memo / tag (e.g. self-custody). Use instead of omitting extraId.
    • refundAddressstringrequiredREQUIRED — the user's OWN wallet on the FROM chain (the wallet they're sending from); refunds return here if the swap can't complete.
    • refundExtraIdstringMemo / tag for refundAddress when the FROM coin requires one — otherwise a refund cannot be credited.
    • modestring
    • rateIdstringRequired when mode=fixed; from get_quote.
    • idempotencyKeystringUUID v4 — one per logical Confirm, reused on retries. Auto-generated if omitted.
  • get_swap1 param

    Get the current status of a swap by id. Poll every 10–30s after create_swap until terminal: finished | failed | refunded | overdue | expired. `hold` = the swap is paused (poll slowly; tell the user to contact support@ghostswap.io with the swap id).

    Show parameters
    • idstringrequiredThe swap id from create_swap.

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

On GitHub

read Nov 18, 2026
Stars
3
Forks
1
Last push
Oct 11, 2026
License
MIT

TypeScriptagents-mdai-agentchatgptclaudeclaude-skillcrypto-swapcryptocurrencycursorcursor-rulesdefighostswapgithub-copilotgpt-actionslangchainllamaindexmcpmcp-serverno-kycopenapiwindsurf

From the README

ghostswap-agents The official multi-LLM agent integration pack for GhostSwap — a no-KYC crypto-to-crypto swap engine supporting 1,600+ coins. Drop the GhostSwap Partners API into any AI agent or coding assistant in one line — Claude, ChatGPT, Cursor, Windsurf, Gemini, GitHub Copilot, Continue.dev, OpenAI Agents SDK, LangChain, LlamaIndex, or any MCP-compatible client. This repo bundles every common distribution surface in one place: an MCP server, a Claude Skill, an OpenAPI 3.1 spec for ChatGPT GPT Actions, project rules for Cursor, an AGENTS.md for the 23+ tools that follow that standard, and symlinked files for Copilot / Windsurf / others. Pick the section for your runtime below. About GhostSwap: is a no-KYC, non-custodial crypto-to-crypto exchange built on a partner-revenue-share model. Wallets, dApps, exchanges, and affiliate sites can integrate the Partners API to earn 0–4 % on every swap their users complete, with USDT payouts and no liquidity management on the partner's side. No partner account? Start here. Point any MCP client at the hosted, no-key server (Streamable HTTP; /sse also available) — or just open GhostSwap Chat and swap by typing, e.g. "swap 0.05 BTC to XMR".…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://mcp.ghostswap.io/mcp
  • ssehttps://mcp.ghostswap.io/sse

Alternatives to GhostSwap

Best Crypto & Web3 servers →

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

ServerStarsLast pushLive check
Oh My Posh Validator23,757Nov 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

GhostSwap: questions people ask

Is GhostSwap a remote or a local MCP server?
According to its entry in the official MCP registry, GhostSwap ships as a hosted endpoint (streamable-http, sse) that your client connects to by URL.
Does GhostSwap need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 19, 2026. Individual tools may still ask for a key when called.
Is GhostSwap still maintained?
Active: the repository's last commit 1 month ago. Last push Oct 11, 2026, 3 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
What tools does GhostSwap expose?
7 tools as listed by the server itself during the live check, including list_currencies, get_pair, validate_address, get_quote, get_swap_link. The full list with parameters is in the Live check section above.
How do I add GhostSwap 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.
Browse all Crypto & Web3 →

Add the badge to your site

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

GhostSwap — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-ghostswap1-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="GhostSwap — 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

[![GhostSwap — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-ghostswap1-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.