@voidly/pay-mcp

@voidly/pay-mcp

41 agent tools in one MCP install. Browse a marketplace of paid HTTP services, pay any of them for <$0.01, get a Voidly-signed receipt. No accounts, no API keys, no Stripe. Settles in <200ms via x402 + USDC on Base mainnet.

Voidly Pay is the marketplace AI agents browse for paid HTTP services. Anyone can list a paid endpoint, anyone can pay one. This MCP server gives your agent the full toolbelt:

• Marketplace: browse + register listings, look up your own
• Payments: signed envelope transfers, batch, escrow, streams, subscriptions, x402 client + server, webhooks
• Agent-fetch toolkit: PDF→text, HTML→clean markdown, URL metadata
• Generic utilities: SHA-256/512 hash, OpenTimestamps-style proof-of-time, signed CSPRNG randomness, QR code generation, Wikipedia summary, fiat/crypto exchange rates
• Observability: live stats, leaderboard, activity feed, per-DID trust report

Free 10-credit faucet on first use. No signup. Browser-only Ed25519.

One-line install

Add to your MCP client config:

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

Per-client paths:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · %APPDATA%\Claude\claude_desktop_config.json (Windows)
• Cursor: ~/.cursor/mcp.json or in-app Settings → Features → MCP
• Windsurf: ~/.codeium/windsurf/mcp_config.json
• Cline (VSCode): Cline panel → MCP Servers → Edit
• Continue.dev: ~/.continue/config.json under experimental.modelContextProtocolServers
• Zed: ~/.config/zed/settings.json under context_servers
• Goose: ~/.config/goose/config.yaml under extensions
• Any MCP client: same JSON config

Restart your client. The 41 voidly_* and agent_* tools appear in the toolbar. First call hits the faucet for 10 free credits.

For one-click install per client (with deep-link buttons), see voidly.ai/pay/install.

What you get (41 tools)

Marketplace + listings (Round 31)

voidly_marketplace_browse         Browse all paid endpoints (Voidly + 3rd-party)
voidly_listing_register           Register your own paid endpoint
voidly_listing_get                Fetch a single listing by id
voidly_listings_mine              List your own listings

Generic agent utilities (Round 32)

voidly_hash                       SHA-256/512 + signed receipt              $0.001
voidly_timestamp                  Proof-of-existence (OpenTimestamps-style) $0.001
voidly_random                     Signed CSPRNG bytes                       $0.001
voidly_qr                         QR-code PNG of any text/URL               $0.001
voidly_wiki                       Wikipedia summary + signed citation       $0.001
voidly_exchange                   Fiat/crypto exchange rates                $0.001

Voidly does not sell its censorship data. The dataset is free and CC BY 4.0 (https://api.voidly.ai/data/incidents/export?format=csv). On 2026-08-04 the five SKUs that resold it or duplicated a free endpoint — forecast-pro, claim-verify-pro, incident-summary-pro, incidents-export-pro and /v1/pay/fetch — were retired and now return HTTP 410 naming the free replacement. What remains is priced for compute.

Agent-fetch toolkit (Round 30)

voidly_extract                    PDF/document → plain text                 $0.01
voidly_markdown                   HTML → clean markdown for LLM context     $0.001
voidly_meta                       URL metadata (og + title + canonical)     $0.001

Wallet, payments, escrow, streams, subscriptions

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
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 transfer history
agent_escrow_open / release / refund
agent_stream_open / meter / finalize     Per-token billing
agent_subscribe / subscription_cancel    Recurring payments

x402 (server + client)

agent_x402_quote                  Server: mint a quote
agent_x402_verify                 Server: verify a payment
agent_x402_fetch                  Client: auto-pay any HTTP 402 response

Webhooks + observability

agent_webhook_subscribe / delete
agent_pay_health                  System health + frozen flag
agent_pay_health_check            One-call trust report (6 checks, on-chain vault read)
agent_pay_manifest                Full discovery doc
agent_pay_stats                   Platform-wide aggregates
agent_pay_activity                Recent state changes
agent_pay_leaderboard             Top by earnings or activity
agent_pay_feed                    Incremental indexer feed
agent_pay_trust                   Derived provider+requester stats

Why agents use this

Problem	Voidly Pay solves it
Need to add payment to your agent service	x402 middleware ships for Express, Hono, FastAPI, Flask, any web-fetch handler
Need to discover paid services	One MCP install → 12 Voidly endpoints + N third-party listings, marketplace JSON public
Don't want to manage 10 API keys	One Ed25519 keypair on disk, one wallet, every paid endpoint in the marketplace works
Don't trust the agent's payment claims	Every receipt is Ed25519-signed by the Voidly facilitator. Verifiable offline.
Need signed evidence that a URL was reachable	GET /v1/pay/probe-attest?host=… returns an Ed25519 attestation over multi-vantage probe data. The measurements themselves are free at /v1/probe/domain/{host} — the charge is for the signature. Country coverage is whatever the live fleet reports at /v1/probe/network; per-country routing of a fetch is not offered.
Compliance / audit trail needs	Every settlement on the off-chain ledger; every USDC deposit on-chain at the Sourcify-verified vault

Try without installing

npm install -g @voidly/pay-cli
voidly-pay claim                                  # 10 free credits
voidly-pay marketplace                            # browse all listings
voidly-pay call /v1/pay/wiki?title=Bitcoin        # auto-pays

Or browser-only at voidly.ai/pay/claim — Ed25519 keypair + 10 starter credits in 60 seconds.

List your own paid endpoint

voidly.ai/pay/list-your-service — browser-only Ed25519, no install, no signup. Set price, point at your URL, get paid per call. Voidly takes zero platform cut on Stage 1.

Or via this MCP server:

await voidly_listing_register({
  name: "My Paid API",
  tagline: "Pay 1¢ for X, get Y signed.",
  url: "https://my-api.example.com/expensive",
  amount_usdc: 0.01,
  category: "data",
  tags: ["json", "agents"],
});

Honest disclosure

Stage 2 is being retired (decided 2026-08-04). Credits are an internal accounting unit: not backed, not redeemable, no off-ramp. The vault on Base mainnet (0xd25d3c6f32886b65356cc5c700382a8a02d84df5, Sourcify-verified) holds 4.10 USDC, has never settled a payment on the canonical x402 path, and its deployed documentation claimed governance could not unilaterally move funds — which the code does not enforce. It stays on-chain as a public record at voidly.ai/pay/proof. We have approximately zero sustained external paying users. The rail is an off-chain credit ledger and stays one; the envelope format and the SDK are unchanged.

We opened the marketplace before the demand exists because we believe agent adoption is gated on discoverability of paid services, not on payment-rail UX.

Links

• Marketplace JSON — all 17+ paid endpoints, machine-readable
• Live discovery — full API + tool catalog
• /pay/install — one-click for every MCP client
• /pay/marketplace — browse the catalog (visual)
• /pay/list-your-service — list your endpoint in 60s
• /pay/proof — vault record (not a reserve; Stage 2 is being retired)
• /pay/for-builders — middleware + adapters for Express, Hono, FastAPI, Flask, LangChain, Vercel AI SDK, CrewAI, Pydantic AI, AutoGen, LlamaIndex
• Voidly Pay landing

Keywords

x402 · agent payments · mcp server · usdc · base mainnet · signed receipts · agent marketplace · pay per call · micropayments · claude code · cursor · windsurf · cline · continue.dev · zed ai · goose mcp · langchain agent payments · vercel ai sdk x402 · crewai payments · llamaindex tools · pydantic-ai tools · autogen extensions · openai agents tools

License

MIT.