mcpField
C
coinvoyage

coinvoyage

Local
github.com/KingPequeFinance0Updated 28w ago
Repository

About coinvoyage

coinvoyage-paykit-claudeplugin is a community-maintained Claude Code plugin for integrating CoinVoyage crypto payments into applications. It combines an integration skill with an MCP server offering 15 API tools for payment orders, webhooks, and swap quotes.

Key features

  1. 01Guide server-side PayOrder integration
  2. 02Support React PaymentWidget and webhooks
  3. 03Offer REST API fallback for non-JS stacks
  4. 04Call CoinVoyage API through 15 tools
  5. 05Handle orders, status, webhooks, and swap quotes

Use cases

  1. 01Add crypto payments to an application checkout
  2. 02Create and check payment orders
  3. 03Register webhooks and verify signatures
  4. 04Request swap quotes through Claude Code

MCP support

The bundled @kingpeque/coinvoyage-mcp server exposes 15 tools that let Claude Code call the CoinVoyage API, including PayOrder creation, status checks, webhook management, and swap quotes. Access uses the configured CoinVoyage API key and, for privileged operations, an API secret.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "kingpeque-coinvoyage": {
      "command": "npx",
      "args": [
        "-y",
        "@kingpeque/coinvoyage-mcp"
      ],
      "env": {
        "COINVOYAGE_API_KEY": "<COINVOYAGE_API_KEY>",
        "COINVOYAGE_API_SECRET": "<COINVOYAGE_API_SECRET>",
        "COINVOYAGE_API_BASE_URL": "<COINVOYAGE_API_BASE_URL>"
      }
    }
  }
}
Run commandnpx -y @kingpeque/coinvoyage-mcp
Environment variables to set
COINVOYAGE_API_KEYSecretYour CoinVoyage public API key. Get one at https://dashboard.coinvoyage.io (Developers section).
COINVOYAGE_API_SECRETSecretServer-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_URLOverride the API base URL. Defaults to https://api.coinvoyage.io.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@kingpeque/coinvoyage-mcp0.1.2

Tools

15

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
typeenumNoPayOrder type. Defaults to DEPOSIT.DEPOSIT | SALE | REFUND
amountobjectYesInvoice amount. Use a fiat currency (e.g. USD) or a token symbol.
amount.valuenumberYesDecimal amount (e.g. 19.99).
amount.currencystringYese.g. "USD", "USDC", "BTC"
metadataobjectNoArbitrary merchant metadata (orderId, sku, customer, etc.).
settlementobjectNoWhere funds settle. Example: { chainId: 8453, token: "USDC" } to receive USDC on Base.
settlement.tokenstringNo
settlement.chainIdnumberNo
settlement.walletAddressstringNo
expiresInSecondsnumberNoOptional: how long the PayOrder stays payable before expiring.

Details

From the project README

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: [email protected].

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.

Links

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.