GhostSwap

ghostswap-agents

The official multi-LLM agent integration pack for [GhostSwap](https://ghostswap.io) — a no-KYC crypto-to-crypto swap engine supporting 1,600+ coins.

Drop the [GhostSwap Partners API](https://partners.ghostswap.io) 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.

No partner account? Start here. Point any MCP client at the hosted, no-key server [https://mcp.ghostswap.io/mcp](https://mcp.ghostswap.io/mcp) (Streamable HTTP; /sse also available) — or just open [GhostSwap Chat](https://chat.ghostswap.io) and swap by typing, e.g. *"swap 0.05 BTC to XMR"*. No account, no KYC.

---

Contents

• 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

Hosted MCP — no install, no API key

Any client that supports remote MCP servers can connect directly — nothing to install, no credential.

• Claude.ai / Claude Desktop: Settings → Connectors → *Add custom connector* → paste https://mcp.ghostswap.io/mcp.
• Cursor / Windsurf / other `mcp.json`-style clients:

{

"mcpServers": { "ghostswap": { "url": "https://mcp.ghostswap.io/mcp" } } }

Six tools: list_currencies, get_pair, validate_address, get_quote, create_swap, get_swap. Registry id: io.github.ghostswap1/mcp. Use the npm package below instead when you want swaps attributed to your own partner credential.

Claude Desktop / Claude Code / claude.ai

Option A — MCP server (recommended for Desktop)

Add to ~/.claude/claude_desktop_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

/plugin marketplace add ghostswap1/ghostswap-agents

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

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

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):

{

"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:

mcpServers:

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

ChatGPT (Custom GPT / GPT Action)

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

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

1. Auth → API Key → Bearer → paste : (single string, colon-separated)
2. 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:

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

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

OpenAI Agents SDK (Python)

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)

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):

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):

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

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:

npx -y @ghostswapio/mcp

Pass GHOSTSWAP_PUBLIC_KEY and GHOSTSWAP_SECRET via env vars.

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

• JSON: https://partners-api.ghostswap.io/openapi.json
• YAML: https://partners-api.ghostswap.io/openapi.yaml

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

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

ghostswap-agents/

├── README.md ← you are here ├── AGENTS.md ← Source of truth (agents.md standard, 23+ tools) ├── CLAUDE.md → AGENTS.md ← symlink for Claude Code ├── .github/ │ └── copilot-instructions.md → ../AGENTS.md ← symlink for GitHub Copilot ├── .windsurfrules → AGENTS.md ← symlink for Windsurf ├── .cursor/ │ ├── rules/main.mdc ← Cursor project rules │ └── mcp.json ← Cursor MCP config ├── .claude-plugin/ │ └── plugin.json ← Claude Code plugin manifest ├── skills/ │ └── ghostswap-partners-api/ │ └── SKILL.md ← Claude Agent Skill (mirror of /skill.md) ├── openapi/ │ ├── openapi.yaml ← OpenAPI 3.1 (source of truth) │ └── openapi.json ← Same, JSON ├── mcp-server/ ← Published as @ghostswapio/mcp on npm │ ├── src/index.ts │ ├── package.json │ ├── manifest.json ← DXT/MCPB for one-click Claude Desktop │ └── README.md ├── remote-mcp/ ← Hosted MCP at mcp.ghostswap.io (Cloudflare Worker) │ ├── src/index.ts │ └── server.json ← MCP registry entry (io.github.ghostswap1/mcp) ├── chat/ ← GhostSwap Chat at chat.ghostswap.io (Cloudflare Worker) │ ├── src/