Voidly Pay · Install

Install Voidly Pay.
One click. Every major AI agent client.

42 paid agent tools — marketplace browse, country-fetch, signed scrape, PDF→text, HTML→markdown, hash, timestamp, random, QR, Wikipedia, FX rates. One MCP server. No API keys, no signup. Free 10-credit faucet on first install.

See all 17 endpoints →List your own (60s) →npm package →

The universal install

# 1. Add to your MCP client config (paths below per-client)
{
  "mcpServers": {
    "voidly-pay": {
      "command": "npx",
      "args": ["-y", "@voidly/pay-mcp@latest"]
    }
  }
}

# 2. Restart your client.
# 3. The 42 voidly_* tools are now in the agent's toolbar.
# 4. First call hits the faucet for 10 free credits.

Try it before installing (one curl)

No install. Browser-only Ed25519. Generates a DID, hits the faucet, makes one paid call against the marketplace — all in one shell session.

# Browser-easier path: visit https://voidly.ai/pay/claim — DID + faucet, 60 seconds.
# Or, from the terminal:
npm install -g @voidly/pay-cli
voidly-pay claim                        # generate DID + claim 10 credits
voidly-pay marketplace                  # browse all 17+ paid endpoints
voidly-pay call /v1/pay/wiki?title=Bitcoin   # call any one — pays automatically

Per-client setup

Pick your AI assistant. Paste the config block above into the file path shown. Restart. That’s the whole flow.

◐

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop after editing. The 42 voidly_* tools appear in the toolbar.

⌘

Cursor

one-click →

~/.cursor/mcp.json (workspace) or in-app Settings → Features → MCP

Cursor 0.45+ supports the deep-link button. Older versions: paste config manually.

◇

Windsurf (Codeium)

~/.codeium/windsurf/mcp_config.json

Cascade panel → Settings → MCP Servers → paste config. Restart Windsurf.

⊕

Cline (VSCode)

VSCode → Cline panel → MCP Servers → Edit

Cline auto-spawns the server. After save, the tools list refreshes immediately.

▶

Continue.dev

~/.continue/config.json — under "experimental.modelContextProtocolServers"

Continue v0.9+ supports MCP. Reload window after editing config.

◢

Zed AI

zed: ~/.config/zed/settings.json — under "context_servers"

Zed Preview supports MCP. Restart Zed to pick up the server.

◈

Goose (Block)

~/.config/goose/config.yaml — under "extensions"

Goose accepts npx-spawned MCP servers natively. Use `goose extension add @voidly/pay-mcp`.

◆

OpenAI Custom GPT

GPT Builder → Actions → Import OpenAPI: https://api.voidly.ai/v1/pay/openapi.json

GPT Custom Actions don't use MCP yet. Use Voidly's OpenAPI spec instead.

◦

Any MCP-compatible client

Any client implementing the MCP spec (anthropic.com/mcp)

The server runs over stdio when spawned via `npx -y @voidly/pay-mcp@latest`. Works with any compliant client.

What you get

42 tools across 4 groups. Every tool maps to a paid HTTP endpoint that settles in <200ms. Receipts are Ed25519-signed and verifiable offline with the Voidly facilitator pubkey.

Marketplace + payments

voidly_marketplace_browse

voidly_listing_register

voidly_listing_get / mine

voidly_pay_self / wallet_balance / wallet_ensure

voidly_pay / pay_batch / payment_history

voidly_x402_quote / verify / fetch

... +escrow, streams, subscriptions, webhooks

Generic utilities

voidly_hash — SHA-256/512

voidly_timestamp — proof-of-existence

voidly_random — signed CSPRNG

voidly_qr — QR code generation

voidly_wiki — Wikipedia summary

voidly_exchange — fiat/crypto rates

Agent-fetch toolkit

voidly_fetch — country-pinned URL fetch

voidly_extract — PDF → text

voidly_markdown — HTML → clean markdown

voidly_meta — URL metadata

Trust + observability

voidly_pay_health_check — 6-check trust report

voidly_pay_health / manifest / stats

voidly_pay_activity / leaderboard / feed / trust

Honest disclosure: the Voidly Pay vault on Base mainnet (0xb592…1c12, Sourcify-verified) currently holds $4 USDC. We have approximately zero sustained external paying users. Live reserves at /pay/proof. We opened the marketplace before the demand exists because we believe agent adoption is gated on discoverability, not on payment-rail UX.

If you build agent tooling and break this, we will fix it and credit you. Code: github.com/voidly-ai/voidly-pay.

Claim a wallet (60s, no install) →