GhostSwap

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "ghostswap": {
      "command": "npx",
      "args": [
        "-y",
        "ghostswap"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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: https://ghostswap.io 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.

Quick install by runtime
What's inside this repo
Why ghostswap-agents
Compared to similar projects
Frequently asked questions
What the API actually does
What you'll need (the human parts)
Affiliate / referral link — the no-code path
Updating
Links
License

Quick install by runtime

Claude Desktop / Claude Code / claude.ai

Option A — MCP server (recommended for Desktop)

Add to ~/.claude/claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "ghostswap": {
      "command": "npx",
      "args": ["-y", "@ghostswapio/mcp"],
      "env": {
        "GHOSTSWAP_PUBLIC_KEY": "gspk_live_...",
        "GHOSTSWAP_SECRET": "gssk_live_..."
      }
    }
  }
}

Restart Claude Desktop. 7 typed tools appear under the ghostswap server.

Option B — Claude Code plugin

bash

/plugin marketplace add ghostswap1/ghostswap-agents
/plugin install ghostswap-partners-api@ghostswap1/ghostswap-agents

Option C — Skill into ~/.claude/skills/

bash

git clone https://github.com/ghostswap1/ghostswap-agents.git
cp -r ghostswap-agents/skills/ghostswap-partners-api ~/.claude/skills/

Full canonical SKILL.md also mirrored at https://partners.ghostswap.io/skill.md.

Cursor

MCP (recommended — typed tools, one-click) — add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally):

config.json

{
  "mcpServers": {
    "ghostswap": {
      "command": "npx",
      "args": ["-y", "@ghostswapio/mcp"],
      "env": {
        "GHOSTSWAP_PUBLIC_KEY": "gspk_live_...",
        "GHOSTSWAP_SECRET": "gssk_live_..."
      }
    }
  }
}

Project rules (always-on prose conventions) — drop .cursor/rules/main.mdc from this repo into your own project. Or just clone this repo and let Cursor read it as a workspace.

Windsurf

MCP — add to ~/.codeium/windsurf/mcp_config.json (same JSON as the Claude / Cursor block above).

Rules — copy AGENTS.md to your project root (or symlink it to .windsurfrules). Windsurf auto-loads both.

Continue.dev

Add to ~/.continue/config.yaml:

yaml

mcpServers:
  - name: ghostswap
    command: npx
    args: ["-y", "@ghostswapio/mcp"]
    env:
      GHOSTSWAP_PUBLIC_KEY: gspk_live_...
      GHOSTSWAP_SECRET: gssk_live_...

ChatGPT (Custom GPT / GPT Action)

Sign up at https://partners.ghostswap.io/sign-up + get your credential
In the GPT builder → Configure → Create new action

Import from URL:

Code

https://partners-api.ghostswap.io/openapi.json

Auth → API Key → Bearer → paste <public_key>:<secret> (single string, colon-separated)
Privacy Policy URL: https://ghostswap.io/privacy

Full step-by-step in gpt-action/README.md, including suggested GPT Instructions copy.

GitHub Copilot

Drop AGENTS.md at your repo root (or copy .github/copilot-instructions.md — they're symlinked in this repo).

For tool access (typed function calls), use the MCP server via your IDE's MCP plugin.

Gemini Code Assist / Gemini CLI

Gemini CLI reads AGENTS.md natively — drop AGENTS.md at your repo root.

For Gemini Code Assist, copy AGENTS.md to .gemini/styleguide.md.

For tool access, use the MCP server (Gemini API + Vertex AI added MCP support in March 2026).

Aider

In your project's .aider.conf.yml:

yaml

read: AGENTS.md  # or wherever you've placed this file

Aider auto-loads it as read-only context every session.

OpenAI Agents SDK (Python)

server.ts

from agents import Agent, Runner
from agents.mcp import MCPServerStdio

ghostswap_mcp = MCPServerStdio(
    params={
        "command": "npx",
        "args": ["-y", "@ghostswapio/mcp"],
        "env": {
            "GHOSTSWAP_PUBLIC_KEY": "gspk_live_...",
            "GHOSTSWAP_SECRET": "gssk_live_...",
        },
    },
)

agent = Agent(
    name="SwapBot",
    mcp_servers=[ghostswap_mcp],
    instructions="You help users execute crypto-to-crypto swaps.",
)

Vercel AI SDK (TypeScript)

server.ts

import { experimental_createMCPClient, generateText, openai } from 'ai';
import { Experimental_StdioMCPTransport } from 'ai/mcp-stdio';

const client = await experimental_createMCPClient({
  transport: new Experimental_StdioMCPTransport({
    command: 'npx',
    args: ['-y', '@ghostswapio/mcp'],
    env: { GHOSTSWAP_PUBLIC_KEY: '…', GHOSTSWAP_SECRET: '…' },
  }),
});

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools: await client.tools(),
  prompt: 'Quote a 0.01 BTC → ETH swap for me.',
});

LangChain (Python / JS)

Via OpenAPI (the simpler path):

server.ts

import yaml, requests
from langchain_community.agent_toolkits.openapi.toolkit import OpenAPIToolkit
from langchain_community.tools.json.tool import JsonSpec

spec = yaml.safe_load(requests.get("https://partners-api.ghostswap.io/openapi.yaml").text)
toolkit = OpenAPIToolkit.from_llm(
    llm=...,
    json_spec=JsonSpec(dict_=spec),
    requests_wrapper=...,  # add your Authorization: Bearer header here
)

Via MCP (cleaner — uses the @ghostswapio/mcp server):

server.ts

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "ghostswap": {
        "command": "npx",
        "args": ["-y", "@ghostswapio/mcp"],
        "env": {
            "GHOSTSWAP_PUBLIC_KEY": "gspk_live_...",
            "GHOSTSWAP_SECRET": "gssk_live_...",
        },
        "transport": "stdio",
    }
})
tools = await client.get_tools()

LlamaIndex

server.ts

from llama_index.tools.mcp import McpToolSpec, BasicMCPClient

mcp_client = BasicMCPClient(
    "npx", args=["-y", "@ghostswapio/mcp"],
    env={"GHOSTSWAP_PUBLIC_KEY": "...", "GHOSTSWAP_SECRET": "..."},
)
tools = McpToolSpec(client=mcp_client).to_tool_list()

Or use the OpenAPI spec with RestAPIToolSpec.

Generic MCP client / any other runtime

The server is a standard stdio MCP server. Any client that speaks MCP v2024-11-05 works:

Terminal

npx -y @ghostswapio/mcp

Pass GHOSTSWAP_PUBLIC_KEY and GHOSTSWAP_SECRET via env vars.

Or, for HTTP-style integrations, use the OpenAPI spec directly:

Paste into any chat (ChatGPT free, Gemini, Perplexity, etc.)

Terminal

curl https://partners.ghostswap.io/skill.md | pbcopy

Paste into the chat with "Build me a Node.js integration based on this." — the SKILL.md is plain markdown with a ~120-line working reference proxy. Works in any LLM.

What's inside this repo

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about GhostSwap

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ghostswap": { "command": "npx", "args": ["-y", "GhostSwap"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ghostswap?style=directory)](https://allmcps.com/mcp/ghostswap)

HTML Embed

<a href="https://allmcps.com/mcp/ghostswap"><img src="https://allmcps.com/api/badge/ghostswap?style=directory" alt="GhostSwap on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

25Quality signal: Emerging · 25/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools10/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to GhostSwap →Install in Claude Desktop Install in Cursor Install in VS Code

GhostSwap

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "ghostswap": {
      "command": "npx",
      "args": [
        "-y",
        "ghostswap"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

ghostswap-agents

The official multi-LLM agent integration pack for GhostSwap — a no-KYC crypto-to-crypto swap engine supporting 1,600+ coins.

About GhostSwap: https://ghostswap.io 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.

Quick install by runtime
What's inside this repo
Why ghostswap-agents
Compared to similar projects
Frequently asked questions
What the API actually does
What you'll need (the human parts)
Affiliate / referral link — the no-code path
Updating
Links
License

Quick install by runtime

Claude Desktop / Claude Code / claude.ai

Option A — MCP server (recommended for Desktop)

Add to ~/.claude/claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "ghostswap": {
      "command": "npx",
      "args": ["-y", "@ghostswapio/mcp"],
      "env": {
        "GHOSTSWAP_PUBLIC_KEY": "gspk_live_...",
        "GHOSTSWAP_SECRET": "gssk_live_..."
      }
    }
  }
}

Restart Claude Desktop. 7 typed tools appear under the ghostswap server.

Option B — Claude Code plugin

bash

/plugin marketplace add ghostswap1/ghostswap-agents
/plugin install ghostswap-partners-api@ghostswap1/ghostswap-agents

Option C — Skill into ~/.claude/skills/

bash

git clone https://github.com/ghostswap1/ghostswap-agents.git
cp -r ghostswap-agents/skills/ghostswap-partners-api ~/.claude/skills/

Full canonical SKILL.md also mirrored at https://partners.ghostswap.io/skill.md.

Cursor

MCP (recommended — typed tools, one-click) — add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally):

config.json

{
  "mcpServers": {
    "ghostswap": {
      "command": "npx",
      "args": ["-y", "@ghostswapio/mcp"],
      "env": {
        "GHOSTSWAP_PUBLIC_KEY": "gspk_live_...",
        "GHOSTSWAP_SECRET": "gssk_live_..."
      }
    }
  }
}

Project rules (always-on prose conventions) — drop .cursor/rules/main.mdc from this repo into your own project. Or just clone this repo and let Cursor read it as a workspace.

Windsurf

MCP — add to ~/.codeium/windsurf/mcp_config.json (same JSON as the Claude / Cursor block above).

Rules — copy AGENTS.md to your project root (or symlink it to .windsurfrules). Windsurf auto-loads both.

Continue.dev

Add to ~/.continue/config.yaml:

yaml

mcpServers:
  - name: ghostswap
    command: npx
    args: ["-y", "@ghostswapio/mcp"]
    env:
      GHOSTSWAP_PUBLIC_KEY: gspk_live_...
      GHOSTSWAP_SECRET: gssk_live_...

ChatGPT (Custom GPT / GPT Action)

Sign up at https://partners.ghostswap.io/sign-up + get your credential
In the GPT builder → Configure → Create new action

Import from URL:

Code

https://partners-api.ghostswap.io/openapi.json

Auth → API Key → Bearer → paste <public_key>:<secret> (single string, colon-separated)
Privacy Policy URL: https://ghostswap.io/privacy

Full step-by-step in gpt-action/README.md, including suggested GPT Instructions copy.

GitHub Copilot

Drop AGENTS.md at your repo root (or copy .github/copilot-instructions.md — they're symlinked in this repo).

For tool access (typed function calls), use the MCP server via your IDE's MCP plugin.

Gemini Code Assist / Gemini CLI

Gemini CLI reads AGENTS.md natively — drop AGENTS.md at your repo root.

For Gemini Code Assist, copy AGENTS.md to .gemini/styleguide.md.

For tool access, use the MCP server (Gemini API + Vertex AI added MCP support in March 2026).

Aider

In your project's .aider.conf.yml:

yaml

read: AGENTS.md  # or wherever you've placed this file

Aider auto-loads it as read-only context every session.

OpenAI Agents SDK (Python)

server.ts

from agents import Agent, Runner
from agents.mcp import MCPServerStdio

ghostswap_mcp = MCPServerStdio(
    params={
        "command": "npx",
        "args": ["-y", "@ghostswapio/mcp"],
        "env": {
            "GHOSTSWAP_PUBLIC_KEY": "gspk_live_...",
            "GHOSTSWAP_SECRET": "gssk_live_...",
        },
    },
)

agent = Agent(
    name="SwapBot",
    mcp_servers=[ghostswap_mcp],
    instructions="You help users execute crypto-to-crypto swaps.",
)

Vercel AI SDK (TypeScript)

server.ts

import { experimental_createMCPClient, generateText, openai } from 'ai';
import { Experimental_StdioMCPTransport } from 'ai/mcp-stdio';

const client = await experimental_createMCPClient({
  transport: new Experimental_StdioMCPTransport({
    command: 'npx',
    args: ['-y', '@ghostswapio/mcp'],
    env: { GHOSTSWAP_PUBLIC_KEY: '…', GHOSTSWAP_SECRET: '…' },
  }),
});

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools: await client.tools(),
  prompt: 'Quote a 0.01 BTC → ETH swap for me.',
});

LangChain (Python / JS)

Via OpenAPI (the simpler path):

server.ts

import yaml, requests
from langchain_community.agent_toolkits.openapi.toolkit import OpenAPIToolkit
from langchain_community.tools.json.tool import JsonSpec

spec = yaml.safe_load(requests.get("https://partners-api.ghostswap.io/openapi.yaml").text)
toolkit = OpenAPIToolkit.from_llm(
    llm=...,
    json_spec=JsonSpec(dict_=spec),
    requests_wrapper=...,  # add your Authorization: Bearer header here
)

Via MCP (cleaner — uses the @ghostswapio/mcp server):

server.ts

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "ghostswap": {
        "command": "npx",
        "args": ["-y", "@ghostswapio/mcp"],
        "env": {
            "GHOSTSWAP_PUBLIC_KEY": "gspk_live_...",
            "GHOSTSWAP_SECRET": "gssk_live_...",
        },
        "transport": "stdio",
    }
})
tools = await client.get_tools()

LlamaIndex

server.ts

from llama_index.tools.mcp import McpToolSpec, BasicMCPClient

mcp_client = BasicMCPClient(
    "npx", args=["-y", "@ghostswapio/mcp"],
    env={"GHOSTSWAP_PUBLIC_KEY": "...", "GHOSTSWAP_SECRET": "..."},
)
tools = McpToolSpec(client=mcp_client).to_tool_list()

Or use the OpenAPI spec with RestAPIToolSpec.

Generic MCP client / any other runtime

The server is a standard stdio MCP server. Any client that speaks MCP v2024-11-05 works:

Terminal

npx -y @ghostswapio/mcp

Pass GHOSTSWAP_PUBLIC_KEY and GHOSTSWAP_SECRET via env vars.

Or, for HTTP-style integrations, use the OpenAPI spec directly:

Paste into any chat (ChatGPT free, Gemini, Perplexity, etc.)

Terminal

curl https://partners.ghostswap.io/skill.md | pbcopy

Paste into the chat with "Build me a Node.js integration based on this." — the SKILL.md is plain markdown with a ~120-line working reference proxy. Works in any LLM.

What's inside this repo

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about GhostSwap

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ghostswap": { "command": "npx", "args": ["-y", "GhostSwap"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ghostswap?style=directory)](https://allmcps.com/mcp/ghostswap)

HTML Embed

<a href="https://allmcps.com/mcp/ghostswap"><img src="https://allmcps.com/api/badge/ghostswap?style=directory" alt="GhostSwap on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

25Quality signal: Emerging · 25/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools10/30

Adoption & activity1/15

Community engagement0/10

★ Featured

AllMCPs Server

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to GhostSwap →Install in Claude Desktop Install in Cursor Install in VS Code

GhostSwap

Quick Install

Client Config & Setup

Documentation Overview

ghostswap-agents

Contents

Quick install by runtime

What's inside this repo

Related MCP Servers

Reviews

Frequently Asked Questions about GhostSwap

AllMCPs Directory Badge

Technical Specs & Signals

AllMCPs Server

Own this project?

Share & Embed

Explore more

GhostSwap

Quick Install

Client Config & Setup

Documentation Overview

ghostswap-agents

Contents

Quick install by runtime

What's inside this repo

Related MCP Servers

Reviews

Frequently Asked Questions about GhostSwap

AllMCPs Directory Badge

Technical Specs & Signals

AllMCPs Server

Own this project?

Share & Embed

Explore more