Skip to main content
Glama
deenesjakoruzh
pay-skill

pay-mcp

by pay-skill
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

@pay-skill/mcp

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) todo el potencial de Pay: pagos directos, pestañas, muros de pago x402, descubrimiento de servicios y gestión de billeteras. No se requiere 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.

Related MCP server: @arispay/payagent-mcp

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 (verificadas en orden)

  1. Llavero del SO (predeterminado): 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.

  2. Almacén de claves cifrado: si existe ~/.pay/keys/default.enc, se utiliza PAYSKILL_SIGNER_KEY como contraseña de descifrado.

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

  4. 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 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, bloqueados/disponibles

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_TESTNET_KEY)

Licencia

MIT

Parte de Pay

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers