English Français العربية

io.github.KingPeque/coinvoyage

السجل الرسمي المالية والمدفوعات

CoinVoyage MCP — create crypto PayOrders, webhooks, swaps across Bitcoin/Solana/EVM chains.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.KingPeque/coinvoyage؟

  • "Add crypto payments to my Next.js checkout"
  • "I want to accept Bitcoin on from my site"
  • "Build a donation page that takes any crypto while I settle to USDC on base"
  • "Create a $25 test invoice and settle to USDC on Base heres my wallet"
  • "Register a webhook at https://mysite.com/api/webhooks/coinvoyage for completed orders"

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @kingpeque/coinvoyage-mcp
Claude Code 
claude mcp add coinvoyage -e 'COINVOYAGE_API_KEY=<COINVOYAGE_API_KEY>' -e 'COINVOYAGE_API_SECRET=<your coinvoyage_api_secret>' -e 'COINVOYAGE_API_BASE_URL=<COINVOYAGE_API_BASE_URL>' -- npx -y @kingpeque/coinvoyage-mcp@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "coinvoyage": {
            "command": "npx",
            "args": [
                "-y",
                "@kingpeque/coinvoyage-mcp@0.1.2"
            ],
            "env": {
                "COINVOYAGE_API_KEY": "<COINVOYAGE_API_KEY>",
                "COINVOYAGE_API_SECRET": "<your coinvoyage_api_secret>",
                "COINVOYAGE_API_BASE_URL": "<COINVOYAGE_API_BASE_URL>"
            }
        }
    }
}

متغيرات البيئة

  • COINVOYAGE_API_KEY إلزامي Your CoinVoyage public API key. Get one at https://dashboard.coinvoyage.io (Developers section).
  • COINVOYAGE_API_SECRET سري Server-side API secret. Required for SALE/REFUND PayOrders, fee claims, and webhook management. Leave unset if you only need DEPOSIT (merchant invoice) flows.
  • COINVOYAGE_API_BASE_URL Override the API base URL. Defaults to https://api.coinvoyage.io.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. coinvoyage-paykit-claudeplugin
  2. Install
  3. What you can now say to Claude
  4. What's inside
  5. Supported chains
  6. Pricing (CoinVoyage's, not this plugin's)
  7. Security posture
  8. Local development
  9. Contributing
  10. License
  11. Links

coinvoyage-paykit-claudeplugin

Claude Code plugin for integrating CoinVoyage — a non-custodial, multi-chain crypto payment gateway — into any app you build with Claude.

Bundles two surfaces:

  1. Skill (coinvoyage-payments) — triggers whenever Claude is helping with crypto payments, checkout, stablecoins, or web3 payment work. Guides the integration end to end: server-side PayOrder creation, React PaymentWidget, webhook signature verification, and REST API fallback for non-JS stacks.
  2. MCP server (@kingpeque/coinvoyage-mcp) — gives Claude 15 tools for calling the CoinVoyage API directly: create PayOrders, check status, manage webhooks, get swap quotes, and more.

Community-maintained integration. Not officially affiliated with CoinVoyage.

Install

/plugin install KingPeque/coinvoyage-paykit

You'll be prompted at install for:

FieldRequiredNotes
api_keyyesYour public API key from https://dashboard.coinvoyage.io → Developers
api_secretoptionalNeeded for SALE/REFUND orders, webhook management, and fee claims. Leave blank to restrict Claude to read + DEPOSIT flows only.
api_base_urloptionalDefaults to https://api.coinvoyage.io

The secret is stored in your system keychain via Claude Code's sensitive-config pathway — it never lands in a file you'd commit.

What you can now say to Claude

Once installed, these kinds of requests will activate the skill and/or MCP tools:

  • "Add crypto payments to my Next.js checkout"
  • "I want to accept Bitcoin on from my site"
  • "Build a donation page that takes any crypto while I settle to USDC on base"
  • "Create a $25 test invoice and settle to USDC on Base heres my wallet"
  • "Register a webhook at https://mysite.com/api/webhooks/coinvoyage for completed orders"

What's inside

coinvoyage-paykit/
├── .claude-plugin/
│   └── plugin.json              # Plugin manifest (prompts user for API keys)
├── mcp.json                     # Declares the bundled MCP server
├── skills/
│   └── coinvoyage-payments/
│       └── SKILL.md             # Integration guide + trigger description
├── mcp-server/                  # Source for @kingpeque/coinvoyage-mcp (npm)
│   ├── src/index.ts
│   ├── package.json
│   └── tsconfig.json
├── README.md
└── LICENSE

Supported chains

Bitcoin, Solana, Ethereum, Optimism, Arbitrum, Base, BSC, Polygon, Sui — plus any ERC-20 / SPL / native token on these chains. See full chain ID reference in the supported_chains MCP tool.

Pricing (CoinVoyage's, not this plugin's)

  • 1.5% per successful payment
  • 0% offramp
  • Merchants can add a custom percentage fee on top
  • This plugin is free and MIT-licensed. Volume discounts on CoinVoyage fees: help@coinvoyage.io.

Security posture

  • No secrets in this repo. Everything sensitive lives in your Claude Code config, injected into the MCP server at runtime.
  • Per-user keys. Every builder uses their own CoinVoyage API key. Nothing is centrally hosted; there's no shared server to compromise.
  • Minimal network surface. The MCP server only talks to api.coinvoyage.io (or your configured override).
  • HMAC-SHA256 authentication for privileged operations (SALE/REFUND/webhooks/fee claims).
  • Open source. Read the MCP server source at mcp-server/src/index.ts — it's under 300 lines.

Local development

git clone https://github.com/KingPeque/coinvoyage-paykit
cd coinvoyage-paykit/mcp-server
npm install
npm run build
# Point your MCP client at ./mcp-server/dist/index.js with COINVOYAGE_API_KEY set

Run the skill locally by symlinking skills/coinvoyage-payments/ into ~/.claude/skills/ (or installing the plugin in dev mode).

Contributing

Issues and PRs welcome at https://github.com/KingPeque/coinvoyage-paykit/issues. Please don't commit API keys, secrets, or wallet addresses.

License

MIT — see LICENSE.

الأسئلة الشائعة

ما هو io.github.KingPeque/coinvoyage؟

CoinVoyage MCP — create crypto PayOrders, webhooks, swaps across Bitcoin/Solana/EVM chains.

كيف أثبّت io.github.KingPeque/coinvoyage؟

يعمل على جهازك. في Claude Code: claude mcp add coinvoyage -e 'COINVOYAGE_API_KEY=<COINVOYAGE_API_KEY>' -e 'COINVOYAGE_API_SECRET=<your coinvoyage_api_secret>' -e 'COINVOYAGE_API_BASE_URL=<COINVOYAGE_API_BASE_URL>' -- npx -y @kingpeque/coinvoyage-mcp@0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.KingPeque/coinvoyage إلى مفتاح API؟

نعم. يتطلب COINVOYAGE_API_KEY, COINVOYAGE_API_SECRET، وتضبطها في إعداداته.

هل io.github.KingPeque/coinvoyage مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.KingPeque/coinvoyage؟

ينشره KingPeque. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.