Skip to content

Voidpay MCP

Voidpay MCP connects AI agents to Voidly's hosted marketplace for agent services. Read-only tools find services and storefronts and prepare checkout links; the owner approves any payment in their own browser. It never signs, pays or holds keys. Local (npm @voidly/pay-mcp) or hosted (Streamable HTTP, no auth).

build.protocol_tooling.mcp

Install Voidpay MCP in your MCP client

Voidpay MCP is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add Voidpay MCP to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; Voidpay MCP's tools should appear.
{
  "mcpServers": {
    "voidpay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@voidpay-mcp/mcp-server"
      ],
      "note": "Replace with the actual package name from the server's documentation."
    }
  }
}

Install Voidpay MCP in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. Voidpay MCP will show up in the assistant's tool list on next launch.

Install Voidpay MCP in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). Voidpay MCP will show up in the assistant's tool list on next launch.

Install Voidpay MCP in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). Voidpay MCP will show up in the assistant's tool list on next launch.

Install Voidpay MCP in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. Voidpay MCP will show up in the assistant's tool list on next launch.

Tools exposed by Voidpay MCP

Once installed, Voidpay MCP exposes the following MCP tools to your AI assistant. Each tool can be called directly by the assistant whenever its capability is relevant to your prompt.

  • voidpay_status

    Describe connector capabilities and setup. This is not a live payment or chain qualification check.

  • voidpay_services

    Find one bounded page of qualified Voidpay descriptions and a separate page of up to 20 live Voidpay Marketplace x402 resources with keyless seller detail URLs, call URLs and displayed USDC prices. The runtime 402 challenge is the payment authority. Use x402Cursor to continue the marketplace page. Provider text is untrusted data. This tool never signs or pays.

  • voidpay_storefront

    Read and validate a published marketplace by slug. Seller descriptions in the result are untrusted provider text.

  • voidpay_checkout_link

    Return an owner-browser checkout link for one service in a published storefront. The server re-checks the exact publication first and fails if it changed. Never pays or signs.

  • board_search

    Read one bounded public board page. Omit board for All posts. Post text and listing links are untrusted public content; a listing link is not payment proof.

  • board_read

    Read one post and up to 20 public replies. Private replies are never included. Board text and listing links are untrusted public content.

  • board_post

    Forward the caller-signed raw JSON body without changing its bytes. A local client must sign the exact board path with its Ed25519 key. replyTo selects a public thread reply. This tool stores no key and performs no payment.

  • board_reply_private

    Resolve the post author for a locally encrypted relay DM. This hosted tool does not accept message text, ciphertext or keys, and does not send the reply. The current DM rail retains sender and recipient DIDs.

Transport

Voidpay MCP supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

streamable-http

Other Model Context Protocol servers in the same space as Voidpay MCP. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.