@pay-skill/mcp

Name: pay-mcp
Author: pay-skill

Servidor MCP para Pay -- la pila de pagos x402 completa para agentes de IA. USDC en Base.

Proporciona a cualquier cliente compatible con MCP (Claude Desktop, Cursor, VS Code, frameworks personalizados) toda la potencia de Pay: pagos directos, pestañas, muros de pago x402, descubrimiento de servicios y gestión de billeteras. No se necesita binario CLI.

Configuración

Claude Desktop

Añadir a claude_desktop_config.json:

{
  "mcpServers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

VS Code / Cursor

Añadir a .vscode/mcp.json:

{
  "servers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

Claude Code

claude mcp add pay -- npx -y @pay-skill/mcp

Eso es todo. En la primera ejecución, el servidor genera una billetera y la almacena en el llavero del sistema operativo (Windows Hello, macOS Keychain, Linux Secret Service). Las ejecuciones posteriores la cargan automáticamente.

Configuración

Variable de entorno	Requerido	Predeterminado	Descripción
`PAYSKILL_SIGNER_KEY`	No	—	Sustitución opcional. Clave hexadecimal sin procesar o contraseña de almacén de claves `.enc`. No es necesario para el uso normal.
`PAY_NETWORK`	No	`mainnet`	`mainnet` (Base) o `testnet` (Base Sepolia)

Resolución de claves (verificada en orden)

Llavero del SO (predeterminado) — Se carga desde el almacén de credenciales del SO a través de keytar. En la primera ejecución, se genera un nuevo par de claves y se almacena automáticamente.
Almacén de claves cifrado — Si existe ~/.pay/keys/default.enc, PAYSKILL_SIGNER_KEY se utiliza como contraseña de descifrado.
Clave hexadecimal sin procesar — Si PAYSKILL_SIGNER_KEY es una cadena hexadecimal de 64 caracteres, se utiliza directamente. Para desarrollo/pruebas o importación de una billetera existente.
Generación automática — Si no se cumple nada de lo anterior, genera un nuevo par de claves y lo almacena en el llavero del SO.

Verificación de diagnóstico

Verifique que todo esté configurado correctamente:

npx @pay-skill/mcp --check

Salida:

pay-mcp diagnostic check
  network: Base (chain 8453)
  api:     https://pay-skill.com/api/v1
  wallet:  0x1234...
  key:     keychain
  server:  OK (router: 0xABCD...)
  auth:    OK (balance: $50.00)

All checks passed. MCP server is ready.

Herramientas (15)

Pagos

Herramienta	Descripción
`pay_send`	Pago directo en USDC (mín. $1). Umbrales de confirmación: <$10 automático, $10-100 planificado, >$100 explícito.
`pay_request`	Solicitud HTTP con pago automático x402. Maneja la detección 402, liquidación directa/pestaña, escepticismo de precios.

Pestañas (cuentas medidas)

Herramienta	Descripción
`pay_tab_open`	Abrir pestaña prefinanciada (mín. $5, recomendado $50). El proveedor cobra por llamada.
`pay_tab_close`	Cerrar pestaña. Devuelve el desglose de la distribución (proveedor 99%, comisión 1%, resto del agente).
`pay_tab_charge`	Cobrar contra una pestaña abierta (solo proveedor).
`pay_tab_topup`	Añadir fondos a una pestaña abierta (solo agente).
`pay_tab_list`	Listar pestañas con indicadores de inactividad/saldo bajo.

Billetera

Herramienta	Descripción
`pay_status`	Saldo, fondos bloqueados/disponibles, sugerencias accionables.
`pay_fund`	Generar enlace de financiación de 1 hora (Coinbase Onramp o USDC directo).
`pay_withdraw`	Generar enlace de retiro de 1 hora.
`pay_mint`	Acuñar USDC de prueba (solo Base Sepolia).

Descubrimiento y Webhooks

Herramienta	Descripción
`pay_discover`	Buscar servicios API de pago por palabra clave/categoría.
`pay_webhook_register`	Registrar webhook para eventos de pago (firmado con HMAC).
`pay_webhook_list`	Listar webhooks registrados.
`pay_webhook_delete`	Eliminar un webhook.

Recursos (5)

URI	Descripción
`pay://wallet/status`	Saldo, pestañas, bloqueado/disponible
`pay://wallet/tabs`	Todas las pestañas abiertas
`pay://tab/{tab_id}`	Detalle de una sola pestaña
`pay://wallet/address`	Dirección de la billetera
`pay://network`	Configuración de red + direcciones de contrato

Prompts (3)

Prompt	Descripción
`pay-for-service`	Guiado: descubrir servicio, evaluar precios, realizar solicitud
`review-tabs`	Revisar pestañas, marcar inactividad, sugerir cierre/recarga
`fund-wallet`	Generar enlace de fondos, explicar proceso de depósito

Desarrollo

git clone https://github.com/pay-skill/pay-mcp.git
cd pay-mcp
npm install
npm run build
npm test                    # unit tests (mocked)
npm run test:acceptance     # testnet (requires PAYSKILL_SIGNER_KEY)

Licencia

MIT

Parte de Pay

Pay es la pila de pagos x402 completa (puerta de enlace, facilitador, SDKs, CLI y servidor MCP) que permite a los agentes de IA pagar por APIs con USDC en Base.

Documentación
Arquitectura
SDK -- Python + TypeScript
CLI -- Herramienta de línea de comandos
pay-gate -- Puerta de enlace de pagos x402
Protocolo -- Contratos inteligentes

pay-mcp

@pay-skill/mcp

Configuración

Claude Desktop

VS Code / Cursor

Claude Code

Configuración

Resolución de claves (verificada en orden)

Verificación de diagnóstico

Herramientas (15)

Pagos

Pestañas (cuentas medidas)

Billetera

Descubrimiento y Webhooks

Recursos (5)

Prompts (3)

Desarrollo

Licencia

Parte de Pay

Resources

Latest Blog Posts

MCP directory API