io.github.voidly-ai/pay-mcp MCP Server

This MCP server exposes Voidly Pay primitives to Claude Code, Cursor, Windsurf, and any MCP-compatible client. It provides USDC-backed agent payment capabilities including transfer, escrow, x402 paywall support (server + client), streaming payments, and subscriptions via 28 tools.

🛠️ Key Features

USDC-backed agent payments
Transfer and batch operations
Escrow
Streams and subscriptions
x402 paywall (server and client)
Wallet, escrow, streams, subscriptions, webhooks, and observability
Total: 28 tools
Topics include agent-to-agent (A2A) and Model Context Protocol (MCP)

🚀 Use Cases

Enabling agent payments for autonomous agents
Facilitating escrow-based payment flows
Supporting paywalled access via x402
Handling streaming and recurring/subscription payments
Integrating with MCP-compatible developer tooling

⚡ Developer Benefits

Works with Claude Code, Cursor, Windsurf, and any MCP client
Structured toolset spanning wallet, transfer, escrow, streams, and webhooks

⚠️ Limitations

Tool count is provided (28), but detailed behavior beyond the listed primitives is not included in the excerpt.

Install (one line)

Add to your client's MCP config (Claude Code's .mcp.json, Cursor's ~/.cursor/mcp.json, Windsurf's ~/.codeium/windsurf/mcp_config.json, etc.):

json

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

On first run the server mints + persists an Ed25519 keypair to ~/.voidly-pay/keypair.json (mode 0600). The DID derived from that key is your agent's identity.

What you can do (27 tools)

code

# Wallet
agent_pay_self                    Show this agent's DID, pubkey, balance.
agent_wallet_balance              Read any wallet (defaults to self).
agent_wallet_ensure               Idempotent wallet creation.

# Transfers
agent_pay                         Send N credits to a DID.
agent_pay_batch                   Multi-recipient atomic transfer (≤100).
agent_pay_get                     Look up a transfer by id.
agent_payment_history             Paginated history.

# Escrow
agent_escrow_open / release / refund

# Streams (per-token billing)
agent_stream_open / meter / finalize

# Subscriptions (recurring)
agent_subscribe / agent_subscription_cancel

# x402 (server + client)
agent_x402_quote                  Server: issue a 402 quote.
agent_x402_verify                 Server: verify + consume X-Payment.
agent_x402_fetch                  Client: pay-on-402, returns final response.

# Webhooks
agent_webhook_subscribe / agent_webhook_delete

# Observability (read-only)
agent_pay_health / manifest / stats / activity / leaderboard / feed / trust

First-run quickstart

Add the config above and restart your MCP client.

The server prints your DID to stderr on startup. Copy it.

In a chat, ask: "Use voidly-pay to claim a sandbox wallet for me".

The tool registers a 1,000-credit test wallet via POST /v1/pay/test/wallet/create.

Now ask: "Send 0.1 credits to did:voidly:example".

Install

Configuration

Environment variables

VOIDLY_PAY_API_URL

Override the API base. Defaults to https://api.voidly.ai.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "pay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@voidly/pay-mcp@0.1.3"
      ],
      "env": {
        "VOIDLY_PAY_API_URL": "<YOUR_VOIDLY_PAY_API_URL>"
      }
    }
  }
}

io.github.voidly-ai/pay-mcp