Voidly Pay — Claude Code Skill

A Claude Agent Skill for Voidly Pay — agent-to-agent payments over HTTP 402 (x402), USDC-backed, live on Base mainnet.

What this skill does

Teaches Claude how to use the Voidly Pay rail to:

• Charge for an API without writing payment code (universal reverse proxy)
• Monetize an AI service — wrap inference in a 402 paywall
• Hire another agent — capability-search, escrow, signed receipt
• Pay another agent — auto-pay any HTTP 402 quote
• Set up subscriptions / streams for per-token or per-second metering

Skill format: a single SKILL.md with YAML frontmatter, per the Anthropic Agent Skills spec.

Install

Option 1 — drop into your ~/.claude/skills/

cd ~/.claude/skills/
git clone https://github.com/voidly-ai/voidly-pay-skill.git voidly-pay

Restart Claude Code. The skill loads automatically.

Option 2 — clone into a project

mkdir -p .claude/skills
cd .claude/skills
git clone https://github.com/voidly-ai/voidly-pay-skill.git voidly-pay

Commit .claude/skills/voidly-pay/ to your repo so anyone who clones gets the skill.

Option 3 — also install the MCP server

For the full surface (28 dedicated Pay tools), add to your MCP host config (.mcp.json, ~/.cursor/mcp.json, etc.):

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

The MCP server mints an Ed25519 keypair on first run (~/.voidly-pay/keypair.json, mode 0600). That keypair is the agent's identity. Private keys never leave your machine.

Try it without installing

Browser demo, no setup: https://huggingface.co/spaces/emperor-mew/voidly-pay

Claim a DID + 10 starter credits, paywall any URL, watch a real settlement land on the rail.

Trust posture

• USDC-backed: Stage 2 vault on Base mainnet at 0xb592512932a7b354969bb48039c2dc7ad6ad1c12. Sourcify-verified, non-upgradable.
• Public reserves: https://voidly.ai/pay/proof (vault USDC ≥ Σ(stage2_credits), refreshed every 15s)
• Caps: $100k daily, $1k per-tx
• OpenAPI 3.1: https://api.voidly.ai/v1/pay/openapi.json

Other ways to integrate

• Cookbook (runnable recipes): https://github.com/voidly-ai/voidly-pay-cookbook
• Scaffolder: npx create-voidly-agent my-agent (4 templates)
• Drop-in middleware: Hono, Express, FastAPI, Flask
• Framework toolkits: LangChain, Vercel AI SDK, CrewAI, AutoGen, LlamaIndex
• Comparison vs alternatives: https://voidly.ai/pay/compare

License

MIT. See LICENSE.txt.