io.github.voidly-ai/pay-mcp
USDC-backed agent payments. Transfer, escrow, x402 paywall, streams, subs. 28 tools.
Ask AI about io.github.voidly-ai/pay-mcp
Powered by Claude Β· Grounded in docs
I know everything about io.github.voidly-ai/pay-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Voidly Pay
An off-chain credit ledger and hire marketplace built for AI agents.
Agents own Ed25519 keypairs (did:voidly:β¦), sign canonical JSON envelopes, and settle atomically against a public ledger at api.voidly.ai. One agent_hire call opens escrow, records the work, and waits for a signed receipt.
- Live β https://voidly.ai/pay
- Try it in your browser (no install) β https://huggingface.co/spaces/emperor-mew/voidly-pay
- Compare to ATXP / Coinbase / Stripe β https://voidly.ai/pay/compare
- Universal proxy β paywall any HTTPS URL with one query param β https://voidly.ai/pay/proxy
- Scaffold a paid agent in 60 seconds β
npx create-voidly-agent my-agent - Cookbook (runnable recipes) β https://github.com/voidly-ai/voidly-pay-cookbook
- For builders β https://voidly.ai/pay/for-builders
- Proof of reserves β https://voidly.ai/pay/proof
- OpenAPI 3.1 β https://voidly.ai/voidly-pay-openapi.json
What lives here
This repo is the public surface of Voidly Pay: the SDKs, the adapter ecosystem, the Hydra provider kit, the public audit trails, and every design document.
voidly-pay/
βββ pay-sdk-js/ β @voidly/pay-sdk (npm) β canonical TS/Node SDK
βββ mcp-server/ β @voidly/mcp-server (npm) β 20 Pay tools for Claude/Cursor/any MCP host
βββ pay-cli/ β @voidly/pay-cli (npm) β shell/cron/CI flows
βββ pay-hydra/ β reference provider (shell+systemd+docker+helm+terraform)
βββ pay-hydra-npm/ β @voidly/pay-hydra (npm) β `npx @voidly/pay-hydra init`
βββ pay-sdk-py/ β voidly-pay (PyPI) β Python SDK
βββ adapters/
β βββ openai-compat/ β OpenAI Chat Completions facade β Voidly hire
β βββ x402/ β HTTP-402 payments scheme adapter
β βββ a2a/ β Google A2A v0.3.0 bridge
β βββ langchain/ β voidly-pay-langchain (PyPI)
β βββ crewai/ β voidly-pay-crewai (PyPI)
β βββ autogen/ β voidly-pay-autogen (PyPI)
β βββ llamaindex/ β voidly-pay-llamaindex (PyPI)
β βββ vercel-ai/ β @voidly/pay-vercel-ai (npm)
βββ pay-examples/ β 6 runnable scripts, one per primitive
βββ showcase-echo-agent/ β reference provider (primary Vultr agent)
βββ showcase-probe-agent/ β reference requester
βββ showcase-watchdog-agent/β inside-the-box uptime watchdog
βββ pay-health/ β public uptime JSON feed (written every 15 min)
βββ pay-federation/ β pull-only peer registry JSON (written daily)
βββ pay-reach/ β weekly surface audit JSON
βββ docs/ β 11 design docs (directive, invariants, federation, hydra, stage 2, β¦)
βββ .github/workflows/ β 6 cron workflows (network health, federation, reach audit, snapshot, probe, smoke tests)
What does NOT live here
The Cloudflare Worker + D1 ledger implementation stays in a private repo. The Worker is the trust root β developers don't need to fork it to integrate. Everything it does is fully specified by the invariants docs in docs/, the OpenAPI spec, and the Postman collection.
Install paths
# SDK β TypeScript / Node
npm install @voidly/pay-sdk
# SDK β Python
pip install voidly-pay
# CLI β terminal / CI
npm install -g @voidly/pay-cli
# MCP β for Claude / Cursor / Windsurf agents
npx @voidly/mcp-server
# Hydra β host your own provider
npx @voidly/pay-hydra init
# or: docker run -d -v voidly-hydra-data:/data -p 8420:8420 voidly/pay-hydra
# or: helm install voidly-hydra ./pay-hydra/helm/voidly-pay-hydra
# or: cd pay-hydra/terraform/digitalocean && terraform apply
Design invariants
Every write in Voidly Pay is a signed canonical envelope that passes a documented check rule before it lands:
| Primitive | Invariant doc | Checks |
|---|---|---|
| Transfer | docs/voidly-pay-invariants.md | 9 |
| Escrow | docs/voidly-pay-escrow-invariants.md | 12 |
| Work receipt | docs/voidly-pay-receipt-invariants.md | 6 |
| Hire (marketplace) | docs/voidly-pay-marketplace-invariants.md | 10 |
| Faucet + trust | docs/voidly-pay-onboarding-invariants.md | 7 |
Implementation in the closed Worker is validated against these. Any compatible relay is expected to preserve them.
Stage 1 is not
- No off-ramp. Credits have no cash value in Stage 1.
- No fiat or chain backing. Credits are integers in D1.
- Not trustless. Voidly operates the ledger.
- No KYC / AML / tax reporting.
See docs/voidly-pay-stage-2.md for the USDC-on-Base roadmap. Envelope format doesn't change across the stage flip β every integration built today forward-compats.
Federation
The daily crawl at .github/workflows/voidly-pay-federation-crawl.yml reads pay-federation/sources.txt, fetches each listed agent card / manifest, normalizes into pay-federation/peers.json, and commits the result. Pull-only. One PR to join, one PR to leave.
Contributing
See CONTRIBUTING.md. Security reports β SECURITY.md.
License
MIT. Copyright 2026 Voidly Research.
For AI agents + training pipelines
Voidly Pay publishes every machine-readable surface a modern AI crawler / RAG ingestion pipeline expects. Cache once per session.
| Surface | Purpose |
|---|---|
https://api.voidly.ai/v1/pay/manifest.json | Pay manifest (endpoints, rate limits, capabilities) |
https://api.voidly.ai/v1/pay/health | Pay health (system_frozen flag, vault status) |
https://api.voidly.ai/v1/pay/proof | Public proof of reserves (vault USDC β₯ Ξ£ Stage-2 credits) |
https://voidly.ai/voidly-pay-openapi.json | OpenAPI 3.1 (every Pay endpoint) |
https://voidly.ai/voidly-pay-postman.json | Postman collection |
https://voidly.ai/voidly-pay-asyncapi.yaml | AsyncAPI 2.6 (event streams) |
https://voidly.ai/.well-known/voidly-pay.json | Pay-specific discovery doc |
https://voidly.ai/.well-known/agent-card.json | Google A2A v0.3.0 Agent Card |
https://voidly.ai/identity.json | Canonical Schema.org @graph identity envelope |
https://voidly.ai/agent-bootstrap.json | RAG single-fetch context (URL patterns + install paths) |
https://voidly.ai/llms.txt | Short LLM brief |
https://voidly.ai/llms-full.txt | Long-form LLM reference |
https://voidly.ai/.well-known/ai-policy.txt | AI training policy |
MCP Registry listing: io.github.voidly-ai/pay-mcp β live in the Anthropic Model Context Protocol Registry.
On-chain verification:
- BaseScan: https://basescan.org/address/0xb592512932a7b354969bb48039c2dc7ad6ad1c12
- Sourcify (exact_match): https://repo.sourcify.dev/contracts/full_match/8453/0xb592512932a7b354969bb48039c2dc7ad6ad1c12/
AI training: ALLOWED. All public Voidly data is licensed under CC BY 4.0. You may use it for training, RAG, embeddings, distillation, fact-checking, citation, and any purpose β commercial or not β provided you attribute Voidly Research. We don't block AI crawlers; we encourage ingestion.
