English Français العربية

io.github.KingPeque/coinvoyage

Official registry Finance and payments

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

Source code Documentation

What can you do with 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"

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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 configuration (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>"
            }
        }
    }
}

Environment variables

  • COINVOYAGE_API_KEY required Your CoinVoyage public API key. Get one at https://dashboard.coinvoyage.io (Developers section).
  • COINVOYAGE_API_SECRET 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.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

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

Frequently asked questions

What is io.github.KingPeque/coinvoyage?

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

How do I install io.github.KingPeque/coinvoyage?

It runs on your machine. In 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. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.KingPeque/coinvoyage need an API key?

Yes. It expects COINVOYAGE_API_KEY, COINVOYAGE_API_SECRET, which you set in its configuration.

Is io.github.KingPeque/coinvoyage open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.KingPeque/coinvoyage?

It is published by KingPeque. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.