Voidpay MCP

Servidor MCP para Voidpay, um marketplace de serviços para agentes. Agentes encontram serviços e vitrines e preparam links de checkout aprovados pelo proprietário; ele nunca assina nem paga.

Servidor MCP hospedado

npx add-mcp 'https://api.voidly.ai/mcp/voidpay'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Voidpay Marketplace MCP

npm version MCP Registry Glama directory smithery badge

Esta é a fonte pública do @voidly/pay-mcp, um conector stdio local para o marketplace hospedado Voidpay. A versão 0.7.4 oferece 12 ferramentas. A descoberta de serviço público não exige credenciais. Rascunhos de criadores e publicação exigem uma concessão escopada aprovada pelo proprietário. Um link de checkout envia o proprietário ao navegador para revisão e pagamento. O conector não assina transações, não mantém chaves de carteira nem faz compras autônomas.

Voidpay hospedado (quatro ferramentas públicas)

O conector hospedado em https://api.voidly.ai/mcp/voidpay é um serviço HTTP separado com voidpay_status, voidpay_services, voidpay_storefront e voidpay_checkout_link. Essas são ferramentas públicas de leitura/links; o conector hospedado não expõe o catálogo de criadores com 12 ferramentas do pacote local. Um link de checkout prepara uma transferência para o navegador do comprador. O comprador revisa e autoriza qualquer pagamento no navegador; o agente não pode assinar, pagar ou manter chaves de pagamento. Uma listagem não é prova de serviços disponíveis ou prontidão de checkout.

Adicionar Voidpay hospedado ao Cursor

Copie este URI de instalação em um navegador ou no aplicativo. Revise a configuração do servidor antes de aceitá-la.

cursor://anysphere.cursor-deeplink/mcp/install?name=voidpay-hosted&config=eyJ1cmwiOiJodHRwczovL2FwaS52b2lkbHkuYWkvbWNwL3ZvaWRwYXkifQ%3D%3D

O Cursor pede que você revise o servidor antes de instalar. Para configurá-lo manualmente, coloque {"mcpServers":{"voidpay-hosted":{"url":"https://api.voidly.ai/mcp/voidpay"}}} em ~/.cursor/mcp.json ou no .cursor/mcp.json do seu projeto.

Instalar Voidpay hospedado no VS Code

Copie este URI de instalação em um navegador ou no aplicativo. Revise a configuração do servidor antes de aceitá-la.

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 um arquivo de workspace portátil, use {"mcpServers":{"voidpay-hosted":{"type":"http","url":"https://api.voidly.ai/mcp/voidpay"}}} na raiz .mcp.json.

  • Claude Desktop / conta Claude: abra Customize → Connectors → Add custom connector e insira https://api.voidly.ai/mcp/voidpay. Conectores remotos são configurados pela conta Claude, não por claude_desktop_config.json.

x402: pagamentos diretos de agentes

Agentes com carteira própria e um cliente x402 v2 podem pagar por chamada em USDC na Base em https://x402.voidly.ai/v1/verify-claim. A resposta HTTP 402 do gateway fornece os termos de pagamento atuais; verifique-os antes de autorizar uma nova tentativa. Esta rota direta não exige conta Voidpay nem checkout no navegador. A política da carteira do próprio agente controla se uma pessoa deve aprovar o pagamento.

Esta rota é separada de ambos os conectores Voidpay MCP. @voidly/pay-mcp e o Voidpay MCP hospedado permanecem sem chaves: eles não assinam nem enviam pagamentos x402, não mantêm chaves de carteira nem fornecem uma carteira ao agente. voidpay_checkout_link ainda envia um comprador ao navegador para revisão e pagamento. Consulte a descoberta de recursos atual do gateway para ver a rede e o preço anunciados.

Instalação do pacote local

O .mcp.json na raiz do repositório fixa a versão do pacote stdio local. Para Claude Desktop, coloque a seguinte entrada em claude_desktop_config.json; para Cursor, use .cursor/mcp.json; para VS Code, use uma raiz de workspace portátil .mcp.json. Use Node 20 ou mais recente.

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

O guia do pacote explica as ferramentas, a configuração opcional de criador, a recuperação somente original e a transferência de checkout. voidpay_status relata as capacidades do conector local; não prova inventário ativo nem prontidão de pagamento. A documentação adiciona um guia de início rápido, conceitos, exemplos para todas as 12 ferramentas, a API programática, erros e FAQ.

Plugins locais

O repositório inclui um plugin Claude Code com um marketplace de repositório e um plugin Cursor. Ambos usam o pacote stdio local fixado no .mcp.json ou mcp.json deste repositório; nenhum plugin configura o conector HTTP hospedado separado. Após a publicação de @voidly/pay-mcp@0.7.4, adicione o marketplace Claude deste repositório GitHub para que a fonte relativa do plugin seja resolvida:

claude plugin marketplace add voidly-ai/pay-mcp
claude plugin install voidpay-marketplace@voidly-marketplace

Revise o comando do servidor no host durante a instalação.

Fonte e verificações

voidly-pay-mcp/ contém o servidor MCP. creator-client/src/client.ts e quatro módulos landing/lib/marketplace*.ts são o fechamento público revisado de protocolo/build. O diretório mcpb/ contém o manifesto do bundle local. server.json é o manifesto Registry para o pacote npm local 0.7.4; o conector Voidpay hospedado tem uma identidade Registry remota separada. Código de autorização hospedada, liquidação, execução de provedor e entrega não está neste repositório.

Execute em voidly-pay-mcp/ com Node 20 ou mais recente (CI compila em Node 24):

npm ci
npm run typecheck
npm test
npm run build
npm run smoke

A verificação de build confere cada importação e saída empacotada. A versão 0.7.2 ampliou o requisito de Node para Node 20+ (verificado em Node 20, 22, 24 e 25). A versão 0.7.3 adicionou o link canônico do repositório ao manifesto Registry. A versão 0.7.4 mantém a interface de 12 ferramentas e adiciona títulos de ferramentas, metadados de descoberta de pacote e bundles de plugins stdio locais. dist/ gerado, dependências, credenciais, diários e bundles são excluídos dos commits de fonte.

Publicação e licença

A fonte neste repositório é oferecida sob Apache-2.0. Os pacotes npm publicados 0.7.2 e 0.7.3 também declaram Apache-2.0; o tarball anterior 0.7.1 declara MIT e mantém esses termos. Publicar 0.7.4 continua sendo a etapa de lançamento revisada da Claude por meio do editor confiável. O fluxo de tags se recusa a republicar uma versão npm existente.

Marcas comerciais

Voidly™ e Voidpay™ são marcas comerciais da Ai Analytics LLC. A licença de código aberto deste código não concede quaisquer direitos sobre esses nomes ou logotipos. Se você fizer um fork ou redistribuir este projeto, use seu próprio nome e identidade visual e não o apresente como um produto oficial da Voidly.