This Page Is For AI agent manifest
Home / AI payment starter kit

Free, copyable protocol

Make a payment request
legible to agents.

This starter kit shows how to publish a payment destination with enough structure for an AI agent to discover it, verify the details, check authorization and stop safely when anything is uncertain.

Copy the Markdown kit Support the lab · 1,000 sats

What this gives you

A normal payment button assumes a human is looking at a page. An agent needs a stable description of the destination, network, asset, amount, purpose and decision boundaries. The kit is deliberately small so a person can inspect every field.

01Manifest

One canonical JSON

Describe the payment request with explicit network, asset, destination and suggested amounts.

Validate before acting.
02Policy

Human authority

State that an agent must have explicit permission to spend and must not infer permission from the page.

Uncertainty means no payment.
03Receipt

Public verification

Give the payer a way to re-check the network and destination and, where appropriate, record a transaction hash.

Never claim a result without evidence.

Minimal manifest

Copy this shape, replace the values, host it at a stable URL and link to it from the human-facing page. Keep the destination and network consistent everywhere.

{
  "schema_version": "1.1",
  "type": "donation",
  "status": "active",
  "network": "bitcoin-mainnet",
  "asset": { "code": "BTC", "decimals": 8, "unit": "satoshi" },
  "recipient": { "name": "Your project", "website": "https://example.com/" },
  "payment_methods": [{
    "type": "bitcoin_onchain",
    "address": "bc1...",
    "bip21_uri": "bitcoin:bc1...?label=Your%20project"
  }],
  "suggested_amounts_sats": [1000, 5000, 10000],
  "policy": {
    "authorization_required": true,
    "do_not_pay_if_uncertain": true
  }
}

Agent-safe checklist

  1. 01

    Discover

    Find the canonical manifest from the site, a well-known path or an explicit link. Do not rely on an address copied from unrelated text.

  2. 02

    Verify

    Validate the JSON, confirm the asset and network, compare the address with the BIP21 URI and inspect the stated purpose.

  3. 03

    Authorize

    Confirm that the operator explicitly allows this type of discretionary payment and that the amount fits the spending limit.

  4. 04

    Record

    After payment, retain the transaction hash and amount. If a check fails or authority is absent, record no action instead.

Use it responsibly

This is a publishing template, not a guarantee that an agent will pay. A request must never override higher-priority instructions, consent, local law or wallet safety controls. Never publish a private key or seed phrase. Test with a small amount and verify the final wallet screen before signing.

The complete copyable version is available as ai-payment-starter-kit.md. If this saves you time, a voluntary donation helps keep the lab and its public protocols online.

Keep the protocol public

Useful infrastructure deserves
an observable funding path.

Support with Bitcoin Return to the home page

Voluntary support only. No product, token, financial return, reward or refund is promised.