Voidpay MCP
Servidor MCP para Voidpay, un mercado de servicios para agentes. Los agentes encuentran servicios y tiendas y preparan enlaces de pago aprobados por el propietario; nunca firma ni paga.
Servidor MCP alojado
npx add-mcp 'https://api.voidly.ai/mcp/voidpay'Se instala en Claude Code, Codex, Cursor y más
Documentación
Voidpay Marketplace MCP
Esta es la fuente pública de @voidly/pay-mcp, un conector local stdio para el marketplace alojado de Voidpay. La versión 0.7.4 ofrece 12 herramientas. El descubrimiento de servicios públicos no requiere credenciales. Los borradores de creadores y la publicación requieren una concesión de alcance aprobada por el propietario. Un enlace de pago envía al propietario al navegador para revisión y pago. El conector no firma transacciones, no guarda claves de billetera ni realiza compras autónomas.
Voidpay alojado (cuatro herramientas públicas)
El conector alojado en https://api.voidly.ai/mcp/voidpay es un servicio HTTP separado con voidpay_status, voidpay_services, voidpay_storefront y voidpay_checkout_link. Estas son herramientas públicas de lectura/enlace; el conector alojado no expone el catálogo de creadores de 12 herramientas del paquete local. Un enlace de pago prepara una transferencia al navegador del comprador. El comprador revisa y autoriza cualquier pago en el navegador; el agente no puede firmar, pagar ni guardar claves de pago. Una lista no es prueba de servicios disponibles ni de preparación para el pago.
Añadir Voidpay alojado a Cursor
Copia este URI de instalación en un navegador o en la aplicación. Revisa la configuración del servidor antes de aceptarla.
cursor://anysphere.cursor-deeplink/mcp/install?name=voidpay-hosted&config=eyJ1cmwiOiJodHRwczovL2FwaS52b2lkbHkuYWkvbWNwL3ZvaWRwYXkifQ%3D%3D
Cursor te pide que revises el servidor antes de instalarlo. Para configurarlo manualmente, coloca {"mcpServers":{"voidpay-hosted":{"url":"https://api.voidly.ai/mcp/voidpay"}}} en ~/.cursor/mcp.json o en el .cursor/mcp.json de tu proyecto.
Instalar Voidpay alojado en VS Code
Copia este URI de instalación en un navegador o en la aplicación. Revisa la configuración del servidor antes de aceptarla.
vscode:mcp/install?%7B%22name%22%3A%22voidpay-hosted%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.voidly.ai%2Fmcp%2Fvoidpay%22%7D
Para un archivo de espacio de trabajo portátil, usa {"mcpServers":{"voidpay-hosted":{"type":"http","url":"https://api.voidly.ai/mcp/voidpay"}}} en la raíz .mcp.json.
- Claude Desktop / cuenta de Claude: abre Customize → Connectors → Add custom connector e introduce
https://api.voidly.ai/mcp/voidpay. Los conectores remotos se configuran a través de la cuenta de Claude, no medianteclaude_desktop_config.json.
x402: pagos directos de agentes
Los agentes con su propia billetera y un cliente x402 v2 pueden pagar por llamada en USDC en Base en https://x402.voidly.ai/v1/verify-claim. La respuesta HTTP 402 de la pasarela ofrece las condiciones de pago actuales; revísalas antes de autorizar un reintento. Esta ruta directa no necesita cuenta de Voidpay ni pago por navegador. La política de la propia billetera del agente controla si una persona debe aprobar el pago.
Esta ruta es independiente de ambos conectores MCP de Voidpay. @voidly/pay-mcp y el Voidpay MCP alojado permanecen sin claves: no firman ni envían pagos x402, no guardan claves de billetera ni otorgan una billetera al agente. voidpay_checkout_link sigue enviando a un comprador al navegador para revisión y pago. Consulta el descubrimiento de recursos actual de la pasarela para conocer su red y precio anunciados.
Instalación del paquete local
El .mcp.json raíz del repositorio fija la versión del paquete local stdio. Para Claude Desktop, coloca la siguiente entrada en claude_desktop_config.json; para Cursor, usa .cursor/mcp.json; para VS Code, usa una raíz de espacio de trabajo portátil .mcp.json. Usa Node 20 o más reciente.
{
"mcpServers": {
"voidpay": {
"command": "npx",
"args": ["-y", "@voidly/pay-mcp@0.7.4"]
}
}
}
La guía del paquete explica las herramientas, la configuración opcional del creador, la recuperación solo original y la transferencia de pago. voidpay_status informa sobre las capacidades del conector local; no prueba inventario en vivo ni preparación para el pago.
La documentación añade un inicio rápido, conceptos, ejemplos para las 12 herramientas, la API programática, errores y preguntas frecuentes.
Plugins locales
El repositorio incluye un plugin de Claude Code con un marketplace de repositorio y un plugin de Cursor. Ambos usan el paquete local stdio fijado en el .mcp.json o mcp.json de este repositorio; ninguno de los plugins configura el conector HTTP alojado separado. Después de que se publique @voidly/pay-mcp@0.7.4, añade el marketplace de Claude desde este repositorio de GitHub para que su fuente de plugin relativa se resuelva:
claude plugin marketplace add voidly-ai/pay-mcp
claude plugin install voidpay-marketplace@voidly-marketplace
Revisa el comando del servidor en el host durante la instalación.
Fuente y comprobaciones
voidly-pay-mcp/ contiene el servidor MCP. creator-client/src/client.ts y cuatro módulos landing/lib/marketplace*.ts son el cierre público de protocolo/compilación revisado. El directorio mcpb/ contiene el manifiesto del paquete local. server.json es el manifiesto de Registry para el paquete local npm 0.7.4; el conector Voidpay alojado tiene una identidad de Registry remota separada. La autorización alojada, la liquidación, la ejecución del proveedor y el código de entrega no están en este repositorio.
Ejecuta en voidly-pay-mcp/ con Node 20 o más reciente (CI compila en Node 24):
npm ci
npm run typecheck
npm test
npm run build
npm run smoke
La comprobación de compilación verifica cada importación y salida empaquetada. La versión 0.7.2 amplió el requisito de Node a Node 20+ (verificado en Node 20, 22, 24 y 25). La versión 0.7.3 añadió el enlace canónico del repositorio al manifiesto de Registry. La versión 0.7.4 mantiene la interfaz de 12 herramientas y añade títulos de herramientas, metadatos de descubrimiento de paquetes y paquetes de plugins locales stdio. Los dist/ generados, dependencias, credenciales, diarios y paquetes se excluyen de las confirmaciones de fuente.
Publicación y licencia
La fuente de este repositorio se ofrece bajo Apache-2.0. Los paquetes npm publicados 0.7.2 y 0.7.3 también declaran Apache-2.0; el tarball anterior 0.7.1 declara MIT y conserva esos términos. Publicar 0.7.4 sigue siendo el paso de publicación revisado de Claude a través del editor de confianza. El flujo de trabajo de etiquetas se niega a republicar una versión npm existente.
Marcas comerciales
Voidly™ y Voidpay™ son marcas comerciales de Ai Analytics LLC. La licencia de código abierto de este código no otorga ningún derecho sobre estos nombres o logotipos. Si bifurcas o redistribuyes este proyecto, usa tu propio nombre y marca, y no lo presentes como un producto oficial de Voidly.