Documentation

Everything you need to ship agent payments

Guides, concepts, and a complete API reference. Start in the sandbox and go live when you're ready — no redesign required.

Quickstart

Install, authenticate, and create your first governed purchase request.

import { Clawr } from "@clawr/sdk";

const clawr = new Clawr(process.env.CLAWR_API_KEY);

const request = await clawr.purchaseRequests.create({
  agent: "claude-research",
  merchant: "OpenAI",
  amount: 7500, // cents
  currency: "usd",
  reason: "Model inference — GPT-4o batch",
});

// → policy-checked, approval-gated, receipt-bound
console.log(request.status); // "auto_approved"

from clawr import Clawr

clawr = Clawr(api_key=os.environ["CLAWR_API_KEY"])

request = clawr.purchase_requests.create(
    agent="claude-research",
    merchant="OpenAI",
    amount=7500,  # cents
    currency="usd",
    reason="Model inference — GPT-4o batch",
)

print(request.status)  # "auto_approved"

curl https://api.clawr.com/v1/purchase-request \
  -H "Authorization: Bearer clw_live_8f2a…d41c" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "claude-research",
    "merchant": "OpenAI",
    "amount": 7500,
    "currency": "usd",
    "reason": "Model inference — GPT-4o batch"
  }'

Browse the docs

Getting started

Install the SDK, create your first agent, and run a sandbox purchase.

Agents

Create agents, scope their access, and assign budgets and cards.

Cards

Issue virtual cards: agent, subscription, merchant-locked, one-time.

Policies

Budgets, merchant rules, geographies, categories, and approvals.

Approvals

Route over-threshold purchases to a human and resolve them.

Receipts & audit

Itemized receipts and an immutable, exportable audit trail.

API reference

Every resource, parameter, and response, with examples.

MCP & integrations

Connect Clawr to MCP clients and your existing stack.