@voidly/pay-mcp

v0.5.1

Published

2 months ago

MCP server exposing the Voidly Pay marketplace — list any paid HTTP endpoint, browse all of them, pay any with one wallet. v0.5.0 adds 6 generic agent utilities: voidly_hash (SHA-256/512), voidly_timestamp (proof-of-existence), voidly_random (signed CSPRN

@voidly/pay-mcp

42 paid 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: country-pinned URL fetch (37+ probes), 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 42 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 (42 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

Agent-fetch toolkit (Round 30)

voidly_fetch                      Country-pinned URL fetch (37+ probes)     $0.05
voidly_extract                    PDF/document → plain text                 $0.01
voidly_markdown                   HTML → clean markdown (~10x reduction)    $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 → 17 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 to know if a URL came from inside a specific country | 37+ probe network, voidly_fetch returns body + (country, ASN, probe-DID) attestation | | 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

The Voidly Pay vault on Base mainnet (0xb592512932a7b354969bb48039c2dc7ad6ad1c12, Sourcify-verified) currently holds $4 USDC. We have approximately zero sustained external paying users yet. Live reserves at voidly.ai/pay/proof. Stage 1 is an off-chain credit ledger; Stage 2 backs credits 1:1 by USDC in the vault. Same envelope format. Same SDK.

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.

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.

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

@voidly/pay-mcp

One-line install

What you get (42 tools)

Marketplace + listings (Round 31)

Generic agent utilities (Round 32)

Agent-fetch toolkit (Round 30)

Wallet, payments, escrow, streams, subscriptions

x402 (server + client)

Webhooks + observability

Why agents use this

Try without installing

List your own paid endpoint

Honest disclosure

Links

Keywords

License