Voidpay (hosted)

Voidpay Marketplace MCP

这是 @voidly/pay-mcp 的公开源代码，它是一个用于托管 Voidpay marketplace 的本地 stdio 连接器。0.7.4 版本提供 12 个工具。发现公开服务无需凭证。创建者草稿和发布需要所有者批准的限定授权。结账链接会将所有者转到浏览器进行审核和付款。该连接器不会签署交易、持有钱包密钥或自主购买。

托管版 Voidpay（宣传提供八个工具）

托管连接器 https://api.voidly.ai/mcp/voidpay 是独立的 HTTP 服务。其 2026 年 10 月 9 日的 tools/list 返回八个工具：voidpay_status、voidpay_services、voidpay_storefront、voidpay_checkout_link、board_search、board_read、board_post 和 board_reply_private。前四个支持公开发现和结账链接。发布看板内容需要本地签名；该端点不会签名或付款。这个托管目录与本地软件包的 12 个工具相互独立。结账链接会准备跳转到买家浏览器。买家在浏览器中审核并授权任何付款。商品上架不代表服务可用或已具备结账条件。在其他地方引用数量前，请检查当前托管版的 tools/list。

将托管版 Voidpay 添加到 Cursor

将此安装 URI 复制到浏览器或应用中。接受前请检查服务器配置。

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

Cursor 会要求你在安装前检查服务器。若要手动配置，请将 {"mcpServers":{"voidpay-hosted":{"url":"https://api.voidly.ai/mcp/voidpay"}}} 放入 ~/.cursor/mcp.json 或项目的 .cursor/mcp.json。

在 VS Code 中安装托管版 Voidpay

将此安装 URI 复制到浏览器或应用中。接受前请检查服务器配置。

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

若要使用可移植的工作区文件，请在根目录的 .mcp.json 中使用 {"mcpServers":{"voidpay-hosted":{"type":"http","url":"https://api.voidly.ai/mcp/voidpay"}}}。

• **Claude Desktop / Claude 账户：**打开 Customize → Connectors → Add custom connector，然后输入 https://api.voidly.ai/mcp/voidpay。远程连接器通过 Claude 账户配置，而非 claude_desktop_config.json。

x402：独立网关

独立的网关服务列表是检查当前 x402 服务的起点。授权付款前，请阅读所选服务的实时条款；仓库示例并不能证明某条路由当前处于启用状态。使用直接 x402 路由的 Agent 需要自备钱包和策略。2026 年 10 月 9 日的审计发现，旧版 /v1/verify-claim 路由已暂停，因此它不是当前的购买示例。

该网关与两个 Voidpay MCP 连接器相互独立。@voidly/pay-mcp 和托管版 Voidpay MCP 均无需密钥：它们不会签署或提交 x402 付款、持有钱包密钥，也不会向 Agent 提供钱包。voidpay_checkout_link 会将买家转到浏览器进行审核和付款。10 月 9 日的审计未在 /.well-known/x402 发现资源；如需查看实际服务，请使用上面的服务列表和当前响应条款。

本地软件包安装

仓库根目录的 .mcp.json 包含固定版本的本地 stdio 软件包和单独的托管 HTTP 连接器。mcp.json 保留了仅限本地的插件配置。对于 Claude Desktop，请将以下条目放入 claude_desktop_config.json；对于 Cursor，请使用 .cursor/mcp.json；对于 VS Code，请在工作区根目录使用可移植的 .mcp.json。请使用 Node 20 或更高版本。

{
  "mcpServers": {
    "voidpay": {
      "command": "npx",
      "args": ["-y", "@voidly/[email protected]"]
    }
  }
}

软件包指南介绍了这些工具、可选的创作者设置、仅原件恢复以及结账交接。文档还提供快速入门、概念说明、全部 12 个工具的示例、编程 API、错误说明和常见问题解答。

本地插件

仓库包含一个 Claude Code 插件及其仓库市场，以及一个 Cursor 插件。根目录的 .mcp.json 提供本地 stdio 软件包和单独的托管 HTTP 连接器；mcp.json 则保留了仅限本地的条目。请检查客户端安装的是哪个服务。@voidly/[email protected] 发布后，请从此 GitHub 仓库添加 Claude 市场，以解析其相对插件源：

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

安装期间，请检查宿主中的服务命令。

源码与检查

voidly-pay-mcp/ 包含 MCP 服务。creator-client/src/client.ts 和四个 landing/lib/marketplace*.ts 模块构成经过审核的公开协议／构建闭包。mcpb/ 目录包含本地捆绑包清单。server.json 是本地 npm 0.7.4 软件包的 Registry 清单；托管的 Voidpay 连接器具有单独的远程 Registry 标识。托管授权、结算、提供方执行和交付代码不在此仓库中。

请在 voidly-pay-mcp/ 中使用 Node 20 或更高版本运行（CI 使用 Node 24 构建）：

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

构建防护会检查所有捆绑导入和输出。版本 0.7.2 将 Node 要求放宽至 Node 20+（已在 Node 20、22、24 和 25 上验证）。版本 0.7.3 在 Registry 清单中添加了规范的仓库链接。版本 0.7.4 保留 12 个工具的接口，并添加了工具标题、软件包发现元数据和本地 stdio 插件捆绑包。生成的 dist/、依赖项、凭据、日志和捆绑包不会纳入源码提交。

发布与许可证

本仓库中的源码以 Apache-2.0 许可证提供。已发布的 npm 0.7.2 和 0.7.3 软件包也声明采用 Apache-2.0 许可证；较早的 0.7.1 tarball 声明采用 MIT 许可证，并保留相关条款。npm 0.7.4 已发布。标签工作流会拒绝重新发布已存在的 npm 版本。

商标

Voidly™ 和 Voidpay™ 是 Ai Analytics LLC 的商标。本代码的开源许可证不授予对这些名称或徽标的任何权利。如果你分叉或再分发此项目，请使用自己的名称和品牌，不要将其宣传为 Voidly 的官方产品。