GhostSwap

ghostswap-agents

GhostSwap 公式のマルチLLMエージェント連携パック — 1,600以上のコインに対応する、KYC不要の暗号資産間スワップエンジンです。

GhostSwap Partners API を1行で、あらゆるAIエージェントやコーディングアシスタントに組み込めます — Claude、ChatGPT、Cursor、Windsurf、Gemini、GitHub Copilot、Continue.dev、OpenAI Agents SDK、LangChain、LlamaIndex、またはMCP対応のあらゆるクライアントに対応しています。

このリポジトリには、一般的なすべての配布方法がまとめられています。MCP サーバー、Claude Skill、ChatGPT GPT Actions 用の OpenAPI 3.1 仕様、Cursor 用プロジェクトルール、この標準に従う23以上のツール向け AGENTS.md、Copilot／Windsurf／その他向けのシンボリックリンク付きファイルを収録しています。以下から実行環境に合ったセクションを選んでください。

GhostSwap について：https://ghostswap.io は、パートナー収益分配モデルに基づく、KYC不要・非カストディ型の暗号資産間取引所です。ウォレット、dApp、取引所、アフィリエイトサイトは、Partners API を統合して、ユーザーが完了したスワップごとに0～4％の収益を得られます。USDTで支払われ、パートナー側で流動性を管理する必要はありません。

パートナーアカウントをお持ちでない場合はこちら。 ホスト型のキー不要サーバー https://mcp.ghostswap.io/mcp（Streamable HTTP。/sse も利用可能）に、任意のMCPクライアントから接続してください — または GhostSwap Chat を開き、「0.05 BTCをXMRにスワップ」 のように入力してスワップできます。アカウントもKYCも不要です。

目次

• 実行環境別のクイックインストール
• このリポジトリの内容
• ghostswap-agents を選ぶ理由
• 類似プロジェクトとの比較
• よくある質問
• API の実際の機能
• 必要なもの（人が用意するもの）
• アフィリエイト／紹介リンク — コード不要の方法
• 更新
• リンク
• ライセンス

実行環境別のクイックインストール

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

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

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

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

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

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

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

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

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

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
)

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

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

npx -y @ghostswapio/mcp

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

このリポジトリの内容

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/index.ts
│   └── public/                                     ← index.html, llms.txt, robots.txt, sitemap.xml
└── gpt-action/
    └── README.md                                   ← Step-by-step for ChatGPT GPT builder

ghostswap-agents を選ぶ理由

類似プロジェクトとの比較

よくある質問

どの AI ランタイムを選べばよいですか？

チャット形式のアシスタント（Claude Desktop、ChatGPT、Cursor のチャット）で提供する場合は、MCP サーバーを使用してください。Markdown の長い文章ではなく、型付きツールをエージェントに提供できます。Custom GPT やサーバーサイドの LangChain パイプラインに組み込む場合は、OpenAPI 仕様を使用してください。Claude Code のワークフローを作成する場合は、SKILL.mdを使用してください。README には、すべての方法についてコピーして使えるインストール例があります。

実行前にパートナーアカウントを作成する必要がありますか？

実際のスワップを実行するには必要です。https://partners.ghostswap.io/sign-up で登録して申し込みフォームを送信し、管理者の承認（通常 24 時間以内）を待ってから、ダッシュボードで認証情報を発行してください。OpenAPI 仕様の確認、SKILL.md の閲覧、または MCP サーバーの list_currencies ツールの実行（通貨の検索にパートナー固有の認証情報は不要）だけであれば、アカウントは必要ありません。

このリポジトリと GhostSwap REST API 自体の違いは何ですか？

このリポジトリは薄い配布レイヤーであり、API をホストしていません。実際の API は https://partners-api.ghostswap.io で稼働しています。このリポジトリの内容はすべて、さまざまな AI ランタイムが利用できる形式で API をラップするものです。

MCP サーバーは「公式」ですか？

はい。GhostSwap チームが https://github.com/ghostswap1/ghostswap-agents と npm の @ghostswapio/mcp として公開しています。MIT ライセンスです。

MCP サーバーをセルフホストできますか？

はい。標準 MCP トランスポートの stdio で動作し、公開 REST API を呼び出します。cd mcp-server && npm install && npm run build && node dist/index.js を実行してビルドしてください。GHOSTSWAP_PUBLIC_KEY と GHOSTSWAP_SECRET の環境変数を渡せば準備完了です。

API が変更された場合、OpenAPI 仕様は自動更新されますか？

正規の仕様は https://partners-api.ghostswap.io/openapi.json で常時公開されており、デプロイ済みの API を反映しています。このリポジトリの openapi/ にあるコピーは、API の変更時に更新されます。GitHub Actions CI では、すべての PR でリンターを実行します。ChatGPT GPT Actions で利用する場合は、更新が自動的に反映されるよう、リポジトリではなくライブ URL を GPT に指定してください。

スワップが実際に行われていることは、どうすれば確認できますか？

POST /v1/swaps のすべてのレスポンスには payinAddress が含まれます。これは、エンドユーザーが入金するアドレスです。スワップはステータス（waiting → confirming → exchanging → sending → finished）に沿って進行し、GET /v1/swaps/{id} を使ってポーリングできます。ライフサイクルの全容は、SKILL.md および https://partners.ghostswap.io/docs/concepts/status-lifecycle に記載されています。

ネットワークエラーの後、エージェントが create_swap を再試行するとどうなりますか？

最初の試行で送信したものと同じ Idempotency-Key を再利用してください。GhostSwap は重複を排除し、元のスワップを返すため、重複したスワップは作成されません。再試行時にキーを再生成することは、パートナー側の不具合で最もよくある原因です。MCP サーバーの create_swap ツールの説明と SKILL.md の両方で、この点を明示しています。

GhostSwap は DEX やセルフカストディ型のスワップルーターとどう違いますか？

DEX では、ユーザーがウォレットを用意し、すべてのトランザクションに署名して、ガス代を支払う必要があります。GhostSwap は、スワップにかかる時間を超えてユーザー資金を保持することがないという意味で、ノンカストディアルです。ただし、ユーザーが行う必要があるのは、入金アドレスへのオンチェーントランザクションを 1 回送信することだけです。ウォレット連携も署名フローもガス代の UI も不要です。そのため、スワップが製品そのものではなく機能の一つであるウォレットやアプリで、よく選ばれています。

GhostSwap では KYC やアカウント登録が必要ですか？

いいえ。GhostSwap は KYC 不要の暗号資産取引所です。エンドユーザーはアカウント、メールアドレス、本人確認書類のいずれも必要ありません。1 回限りの入金アドレスに送金すると、交換後のコインを自身のウォレットで受け取れます。これには、BTC から XMR（Monero）や BTC から ZEC（Zcash）への交換などのプライバシーコインのスワップや、ほかの 1,600 種類以上のコインが含まれます。パートナーは、自社ユーザー向けの利用条件を独自に設定します。スワップのステータスが hold になった場合は、ユーザーに [email protected] へ連絡するよう案内してください（SKILL.md を参照）。

メモや送金先タグが必要なコインはどれですか？

XRP、XLM、ATOM、HBAR、TON などのコインでは、アドレスとともにメモ／送金先タグ／支払い ID が必要です。GET /v1/currencies では requiresExtraId: true として示され（extraIdName に人が読めるラベルも含まれます）、タグを取得して POST /v1/swaps の extraId として送信する必要があります。これがない場合、API は missing_extra_id を返し、スワップは作成されません。ユーザーが自身のウォレットにタグがないことを確認した場合は、extraIdNotRequired: true を送信してください。このリポジトリにある 3 つすべての MCP サーフェスが、これらのフィールドに対応しています。

API キーなしで、自分のサイトに GhostSwap のレートを表示できますか？

はい。GET https://partners-api.ghostswap.io/v1/public/quote?from=btc&to=xmr&amount=0.05 を使うと、認証情報なしで標準の公開表示レートを取得できます。CORS が許可されており、IP ごとに 1 分あたり 60 リクエストまでに制限されているため、結果を 10～30 秒間キャッシュしてください。実際にスワップを実行するには、認証済みの POST /v1/quotes と POST /v1/swaps を使用してください。

セキュリティ上の問題は、どのように報告すればよいですか？

件名の先頭に [security] ghostswap-agents: を付けて [email protected] へメールしてください。公開 GitHub Issue は作成しないでください。手順の詳細は SECURITY.md を参照してください。

API の実際の仕組み

カストディアル方式ではない暗号資産スワップ向けの、サーバー間 REST API です。エンドユーザーは、お客様が返す入金アドレスに資金を送金し、交換後の資金は送金先のウォレットで受け取ります。GhostSwap がすべての上流流動性、署名、決済処理を担います。お客様が署名キーを保持することはありません。パートナーは、完了したすべてのスワップについて 0～4 % の上乗せ手数料（申請時に設定）を獲得でき、USDT で支払われます（最低 $100）。

完全なリファレンス：https://partners.ghostswap.io/docs。

必要な準備（人が行う作業）

1. 登録します（https://partners.ghostswap.io/sign-up）→ 申請フォームに入力します（事業名、ウェブサイト、予想月間取引量、希望するパートナー手数料 0～4 %）。
2. 承認を待ちます（管理者が審査します。通常は 24 時間以内）。有効化されるとメールが届きます。
3. /dashboard/api-credentials で認証情報を発行します → 公開キー gspk_live_… とシークレット gssk_live_… をコピーします。
4. 両方をサーバー側の環境変数として設定します。ブラウザーのコードや git には絶対に含めないでください。

認証情報を取得したら、上記のすべてのランタイムで 5 分以内に利用を開始できます。

アフィリエイト／紹介リンク — コード不要の方法

API をまったく統合したくない場合、承認済みのパートナーには全員、紹介リンクも提供されます。

https://ghostswap.io/?ref=<your-slug>

リンクをクリックしたエンドユーザーは 30 日間の Cookie によって紹介元として記録され、ghostswap.io で完了したスワップの取引量の 1 % が報酬としてお客様に加算されます。お客様側でコードを書く必要はありません。URL を共有するだけです。承認後、ダッシュボードでスラッグを選択してください。

更新

git pull            # in your local clone
# Or, for the npm package:
npm update -g @ghostswapio/mcp
# Or, for the Claude Code plugin:
/plugin update ghostswap-partners-api

OpenAPI 仕様は https://partners-api.ghostswap.io/openapi.json にあり、常にライブ API の状態が反映されています。SKILL.md と AGENTS.md は、GhostSwap のドキュメントがデプロイされるたびに同期されます。

リンク

ライセンス

MIT。自由に使用、フォーク、公開してください。