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.

No partner account? Start here. Point any MCP client at the hosted, no-key server https://mcp.ghostswap.io/mcp (Streamable HTTP; /sse also available) — or just open GhostSwap Chat 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

<details open><summary><b>Hosted MCP — no install, no API key</b></summary>

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.

</details> <details open><summary><b>Claude Desktop / Claude Code / claude.ai</b></summary>

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.

</details> <details><summary><b>Cursor</b></summary>

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.

</details> <details><summary><b>Windsurf</b></summary>

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.

</details> <details><summary><b>Continue.dev</b></summary>

Add to ~/.continue/config.yaml:

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

</details> <details><summary><b>ChatGPT (Custom GPT / GPT Action)</b></summary>

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
   

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

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

</details> <details><summary><b>GitHub Copilot</b></summary>

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.

</details> <details><summary><b>Gemini Code Assist / Gemini CLI</b></summary>

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

</details> <details><summary><b>Aider</b></summary>

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.

</details> <details><summary><b>OpenAI Agents SDK (Python)</b></summary>

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.",
)

</details> <details><summary><b>Vercel AI SDK (TypeScript)</b></summary>

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.',
});

</details> <details><summary><b>LangChain (Python / JS)</b></summary>

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

</details> <details><summary><b>LlamaIndex</b></summary>

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.

</details> <details><summary><b>Generic MCP client / any other runtime</b></summary>

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

</details> <details><summary><b>Paste into any chat (ChatGPT free, Gemini, Perplexity, etc.)</b></summary>

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.

</details>

---

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/