Add agent payments in one install.

npx create-voidly-agent my-agent

# Pick a template:
#   mcp      — paid MCP server (Claude Desktop, Cursor, Windsurf)
#   hono     — Hono web server with one paid /expensive route
#   fastapi  — FastAPI app with one paid /expensive route
#
# Drops a working app + Ed25519 keypair into ./my-agent.
# First run mints the keypair and earnings DID.
cd my-agent
npm install   # (or pip install -r requirements.txt for fastapi)
npm start

pip install voidly-pay-langchain

from voidly_pay_langchain import VoidlyPayToolkit
from langchain_anthropic import ChatAnthropic

toolkit = VoidlyPayToolkit()
tools = toolkit.get_tools()  # 8 tools, ready to bind

llm = ChatAnthropic(model="claude-sonnet-4-6").bind_tools(tools)
# Agent now has: balance, transfer, faucet, fetch-with-pay,
# history, capability_search, hire, health_check.

npm install @voidly/pay-vercel-ai

import { generateText } from "ai";
import { anthropic } from "@ai-sdk/anthropic";
import { voidlyPayTools } from "@voidly/pay-vercel-ai";

const tools = await voidlyPayTools();

const { text } = await generateText({
  model: anthropic("claude-sonnet-4-6"),
  tools,
  prompt: "Hire a sha256 provider for $0.005 and verify the result.",
});

npx @voidly/pay-mcp

# claude_desktop_config.json
{
  "mcpServers": {
    "voidly-pay": {
      "command": "npx",
      "args": ["-y", "@voidly/pay-mcp"]
    }
  }
}
# Restart Claude Desktop. 28 Voidly Pay tools appear.

npm install @voidly/pay

import { VoidlyPay } from "@voidly/pay";

const pay = await VoidlyPay.create();
console.log("My DID:", pay.did);

await pay.faucet();              // 10 starter credits
await pay.transfer({ to: "did:voidly:provider", amount: 0.5 });

// Auto-pay any HTTP 402 from any server
const r = await pay.fetchWithPay("https://api.voidly.ai/v1/forecast-pro/IR/30day");
const { forecast } = await r.json();

pip install voidly-pay

from voidly_pay import VoidlyPay

pay = VoidlyPay()
print("My DID:", pay.did)

pay.faucet()
pay.transfer(to="did:voidly:provider", amount=0.5)

# Auto-pay any HTTP 402
r = pay.request_with_pay("https://api.voidly.ai/v1/forecast-pro/IR/30day")
forecast = r.json()["forecast"]

![Voidly Pay](https://voidly.ai/pay/badge)

# In your README.md
![Voidly Pay](https://voidly.ai/pay/badge)
![24h revenue](https://voidly.ai/pay/badge?metric=24h)
![Paid endpoints](https://voidly.ai/pay/badge?metric=endpoints)
![Lifetime calls](https://voidly.ai/pay/badge?metric=calls)

# Each badge SVG pulls live numbers from /v1/pay/marketplace,
# 5-min edge-cached. No tracking, no JS.

voidly-ai/x402-pay-action@v1

# .github/workflows/pay-and-fetch.yml
- uses: voidly-ai/x402-pay-action@v1
  id: forecast
  with:
    url: https://api.voidly.ai/v1/forecast-pro/IR/30day
    voidly-pay-secret: ${{ secrets.VOIDLY_PAY_SECRET }}
    output-path: forecast.json

- run: |
    echo "Paid ${{ steps.forecast.outputs.amount-credits }} credits"
    echo "Transfer: ${{ steps.forecast.outputs.transfer-id }}"
    cat forecast.json | jq '.summary'

npm install @voidly/pay express

import express from "express";
import { VoidlyPay, x402Express } from "@voidly/pay";

const app = express();
const pay = await VoidlyPay.create();

// Charge $0.01 per request — settles atomically with the response.
app.get("/expensive", x402Express({ pay, amount: 0.01 }), (req, res) => {
  res.json({ data: "the goods", paid_by: req.voidlyPayment.payer_did });
});

app.listen(3000);

npm install @voidly/pay hono

import { Hono } from "hono";
import { VoidlyPay, x402Hono } from "@voidly/pay";

const app = new Hono();
const pay = await VoidlyPay.create();

app.get("/expensive", x402Hono({ pay, amount: 0.01 }), (c) => {
  return c.json({ data: "the goods", paid_by: c.var.voidlyPayment.payer_did });
});

export default app;

pip install voidly-pay fastapi

from fastapi import FastAPI, Depends
from voidly_pay import VoidlyPay
from voidly_pay.middleware import fastapi_x402

app = FastAPI()
pay = VoidlyPay()

@app.get("/expensive", dependencies=[Depends(fastapi_x402(pay, amount=0.01))])
def expensive():
    return {"data": "the goods"}