@kingpeque/coinvoyage-mcp

Model Context Protocol server for CoinVoyage — a non-custodial, multi-chain crypto payment gateway. Lets any MCP-compatible client (Claude Code, Claude Desktop, Cursor, etc.) create and manage PayOrders, webhooks, and swaps directly.

Community-maintained. Not officially affiliated with CoinVoyage.

What you can do

• Create merchant invoices (PayOrders) for BTC, SOL, ETH, Base, Arbitrum, Optimism, Polygon, BSC, Sui, plus any supported token
• Check PayOrder status, list recent orders, inspect available payment methods
• Generate quotes and payment details for a given chain/token
• Register, update, and delete webhook subscriptions
• Get cross-chain swap quotes (Uniswap, Jupiter, Cetus, CCTP, ChangeNow, direct)
• Check and claim accrued merchant fees

Install

The easiest way is the bundled Claude Code plugin:

/plugin install KingPeque/coinvoyage-paykit

That installs this MCP server plus an integration skill in one step, and prompts for your API key at install.

Or install the MCP server standalone — add to your MCP client config:

{
  "mcpServers": {
    "coinvoyage": {
      "command": "npx",
      "args": ["-y", "@kingpeque/coinvoyage-mcp@latest"],
      "env": {
        "COINVOYAGE_API_KEY": "pk_...",
        "COINVOYAGE_API_SECRET": "sk_..."
      }
    }
  }
}

Get API keys

1. Create an organization at https://dashboard.coinvoyage.io
2. Go to Developers
3. Generate a public API key and an API secret
4. Copy the webhook secret if you plan to register webhooks

Environment variables

| Variable | Required | Purpose | |----------|----------|---------| | COINVOYAGE_API_KEY | yes | Public API key | | COINVOYAGE_API_SECRET | only for SALE/REFUND/webhooks/fee claims | Server-side secret | | COINVOYAGE_API_BASE_URL | no | Defaults to https://api.coinvoyage.io |

Tools exposed

create_pay_order, get_pay_order, list_pay_orders, list_payment_methods, generate_quote, get_payment_details, list_webhooks, create_webhook, update_webhook, delete_webhook, get_swap_quote, get_swap_data, get_fee_balances, claim_fees, supported_chains.

License

MIT. See LICENSE.