coinvoyage-paykit-claudeplugin

Plugin de Claude Code para integrar CoinVoyage —una pasarela de pagos cripto multicadena sin custodia— en cualquier aplicación que construyas con Claude.

Incluye dos superficies:

1. Skill (coinvoyage-payments) — se activa siempre que Claude ayuda con pagos cripto, procesos de pago (checkout), stablecoins o trabajo de pagos web3. Guía la integración de principio a fin: creación de PayOrder en el lado del servidor, PaymentWidget de React, verificación de firmas de webhook y fallback de API REST para stacks que no son JS.

2. Servidor MCP (@kingpeque/coinvoyage-mcp) — proporciona a Claude 15 herramientas para llamar directamente a la API de CoinVoyage: crear PayOrders, verificar estados, gestionar webhooks, obtener cotizaciones de swap y más.

Integración mantenida por la comunidad. No está afiliada oficialmente a CoinVoyage.

Instalación

/plugin install KingPeque/coinvoyage-paykit

Durante la instalación se te solicitará:

El secreto se almacena en el llavero de tu sistema a través de la ruta de configuración sensible de Claude Code; nunca termina en un archivo que vayas a subir a un repositorio.

Related MCP server: Purple Flea Wallet

Qué puedes decirle ahora a Claude

Una vez instalado, este tipo de solicitudes activarán la skill y/o las herramientas MCP:

• "Añade pagos cripto a mi checkout de Next.js"

• "Quiero aceptar Bitcoin desde mi sitio"

• "Crea una página de donaciones que acepte cualquier cripto mientras yo recibo USDC en Base"

• "Crea una factura de prueba de $25 y liquida en USDC en Base, aquí tienes mi billetera"

• "Registra un webhook en https://mysite.com/api/webhooks/coinvoyage para órdenes completadas"

Qué hay dentro

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

Cadenas compatibles

Bitcoin, Solana, Ethereum, Optimism, Arbitrum, Base, BSC, Polygon, Sui — además de cualquier token ERC-20 / SPL / nativo en estas cadenas. Consulta la referencia completa de ID de cadena en la herramienta MCP supported_chains.

Precios (de CoinVoyage, no de este plugin)

• 1.5% por pago exitoso

• 0% por salida (offramp)

• Los comerciantes pueden añadir un porcentaje de comisión personalizado adicional

• Este plugin es gratuito y tiene licencia MIT. Descuentos por volumen en las comisiones de CoinVoyage: help@coinvoyage.io.

Postura de seguridad

• Sin secretos en este repositorio. Todo lo sensible reside en tu configuración de Claude Code, inyectado en el servidor MCP en tiempo de ejecución.

• Claves por usuario. Cada desarrollador utiliza su propia clave API de CoinVoyage. Nada está alojado centralmente; no hay un servidor compartido que comprometer.

• Superficie de red mínima. El servidor MCP solo se comunica con api.coinvoyage.io (o tu configuración personalizada).

• Autenticación HMAC-SHA256 para operaciones privilegiadas (VENTA/REEMBOLSO/webhooks/reclamación de comisiones).

• Código abierto. Lee el código fuente del servidor MCP en mcp-server/src/index.ts — tiene menos de 300 líneas.

Desarrollo local

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

Ejecuta la skill localmente creando un enlace simbólico de skills/coinvoyage-payments/ en ~/.claude/skills/ (o instalando el plugin en modo desarrollo).

Contribución

Las incidencias y PRs son bienvenidas en https://github.com/KingPeque/coinvoyage-paykit/issues. Por favor, no subas claves API, secretos o direcciones de billetera.

Licencia

MIT — ver LICENSE.

Enlaces

• Sitio de CoinVoyage: https://coinvoyage.io

• Documentación de CoinVoyage: https://docs.coinvoyage.io

• Panel de control: https://dashboard.coinvoyage.io

• Soporte: help@coinvoyage.io

• Incidencias de este plugin: https://github.com/KingPeque/coinvoyage-paykit/issues