Give your agent a name on Bitcoin. Bring your own wallet.
AI agents can put a proof on Bitcoin with one API call and one signature. We build the transaction; your agent signs it with its own key. We never hold keys, and the service fee is just one more output in the same transaction.
Vanity names for agents
Your agent can buy its own name on Bitcoin, like SATOSHI, delivered to its own address, and attach an Agent identity to it. $21 + network fee, the same order flow as /vanity.
Availability and the live price. Names are 4–12 letters A–Z, not starting with A. Trademarked and brand names are blocked.
curl https://proveitonchain.com/api/v1/names/SATOSHI
Creates an order and holds the name for 30 minutes. Returns order_id, the exact amount_sats to pay (the quote plus a 1–999 sat tag that identifies your payment), pay_to, payment_uri and expires_at. Pay exactly that amount in one output from any wallet. Rate limits per IP: 8 orders an hour, 3 open orders.
curl -X POST https://proveitonchain.com/api/v1/names/orders \
-H 'content-type: application/json' \
-d '{"name":"SATOSHI","address":"bc1q...","profile":{"display_name":"Satoshi Bot","operator":"Acme Labs","agent_type":"research agent","mcp_url":"https://acme.example/mcp"}}'
Status: awaiting_payment → payment_seen → paid → registering → transferring → delivered, with the payment, register and transfer tx ids. POST /api/v1/names/orders/{order_id}/cancel releases an unpaid order.
Agent identity: display name, operator, website, X handle, description, agent type/model and MCP endpoint. It shows on /agent/{name} and on Verify, only while the address that set it still owns the name. To set or edit it later: POST {"profile":{...}} to get a message, sign it with the holder address (BIP-322, or the "sign message" in Unisat, Xverse, Leather, Sparrow, Electrum or Bitcoin Core), then POST {"profile","message","signature"} within an hour.
How proofs work
- Create. POST your claim (plus a file or its SHA-256) and your agent's Bitcoin address. We hash it, store the public record at
/t/<record_id>.json, and return an unsigned PSBT. - Sign. Sign every input with your key. The PSBT issues a one-of-one Counterparty token (quantity 1, indivisible, locked) whose description is the record URL, and pays the service fee.
- Broadcast. POST the signed PSBT back. We check it is exactly what we built and that it pays the exact fee, then relay it. Poll status until it confirms.
utxo_guard). If the indexer is down we return 503 indexer_unavailable and build nothing; if plain coins can't cover it you get insufficient_clean_funds or no_clean_utxos./api/v1/broadcast relays for any address (rate-limited per IP), after checking the tx is exactly what we built and pays the exact service fee. You can also broadcast the signed hex yourself, for example with POST https://mempool.space/api/tx.Endpoints
Current fees. Every product is a flat service fee plus the Bitcoin network fee on top: a proof is $2 + network fee. Returns the service fee in USD and sats, the address it goes to, network fee rates, and coming-soon prices.
curl https://proveitonchain.com/api/v1/quote
| Field | Notes |
|---|---|
type | proof (default), publication, deed or artwork. See Types. |
claim * | What you are proving. Up to 200 characters. Required for proof; written for you for the other types. |
address * | Your agent's Bitcoin address. It pays, signs, and receives the token. bc1q… recommended. |
details | Up to 2,000 characters. |
file | Base64, a data: URL, an https URL, or {base64, name, type}. Inline up to about 3 MB. |
file_url | https URL we download and hash (up to 6 MB). |
sha256 | Prove a file without sending it. If you send the file too, it must match. |
name | A named asset or subasset your address already owns. Leave it out for a free numeric asset. |
metadata | Optional structured details. See Metadata. |
fee_rate | sat/vB. Defaults to the mempool.space half-hour rate (minimum 5). |
curl -X POST https://proveitonchain.com/api/v1/proofs \
-H 'content-type: application/json' \
-d '{"claim":"I wrote this first","address":"bc1q...your-agent-address"}'
# prove a file without uploading it
curl -X POST https://proveitonchain.com/api/v1/proofs \
-H 'content-type: application/json' \
-d "{\"claim\":\"Signed contract v3\",\"sha256\":\"$(shasum -a 256 contract.pdf | cut -d' ' -f1)\",\"file_name\":\"contract.pdf\",\"address\":\"bc1q...\"}"
Response (trimmed):
{
"record_id": "4e91fe6522e3bc1f",
"record_url": "https://proveitonchain.com/t/4e91fe6522e3bc1f.json",
"verify_url": "https://proveitonchain.com/verify?asset=A1204...",
"asset": "A12044707814007245827",
"unsigned_psbt": "cHNidP8BA...",
"unsigned_tx_hex": "0200000001...",
"sign": { "address": "bc1q...", "inputs": [0], "sighash": "ALL" },
"fees": { "service": { "usd": 2, "sats": 3102, "address": "bc1q..." },
"network": { "sats": 1300, "sat_per_vbyte": 5 }, "total_sats": 4402 },
"expires_at": "2026-11-17T01:30:00.000Z"
}
Send signed_psbt (base64 or hex, finalized or not) or signed_tx_hex. Calling it again returns the same txid.
curl -X POST https://proveitonchain.com/api/v1/broadcast \
-H 'content-type: application/json' \
-d '{"record_id":"4e91fe6522e3bc1f","signed_psbt":"cHNidP8BA..."}'
Returns status: awaiting_signature, expired, pending, or confirmed, with txid, asset, confirmations, and verify_url.
curl https://proveitonchain.com/api/v1/proofs/4e91fe6522e3bc1f
Types
| type | Price | What it is | Needs |
|---|---|---|---|
proof | $2 + network fee | A signed, hashed claim. | claim |
publication | $2 + network fee | Proof of Publication. Timestamps a file or text you published. The file is hashed and never stored. Certificate at /pub/<asset>. | metadata.name, plus a file, sha256 or metadata.description |
deed | $5 + network fee | Ownership Token. A transferable 1-of-1 signed ownership claim for a personal item or collectible, with owner history. A signed claim, not legal title. Certificate at /deed/<asset>. | metadata.name and a photo as file (stored so anyone can re-check it) |
artwork | $5 + network fee | Certificate of Provenance. Issued by the artist's wallet for a painting, print or collectible; provenance follows every transfer. Certificate at /art/<asset>. | metadata.name, metadata.creator and a photo |
GET /api/v1/quote returns types.<type>.available and the fee in sats for each. Deeds and artwork use a free numeric asset (no name). To transfer one, send the 1 unit with any Counterparty wallet; the certificate page shows the new holder.
curl -X POST https://proveitonchain.com/api/v1/proofs \
-H 'content-type: application/json' \
-d '{"type":"publication","address":"bc1q...","sha256":"9f86d0...0a08",
"metadata":{"name":"The Case for Sound Money","creator":"Satoshi of Newport","x_handle":"@proveitonchain"}}'
Metadata
Optional for every type. Stored in the public claim JSON with the CIP-25 key names Counterparty explorers like Tokenscan show as separate rows (Name, Description, Website, Category, Owner, Social Media, Artwork title), plus flat keys and OpenSea-style attributes.
| Field | Limit | In the claim JSON |
|---|---|---|
name | 140 | name, title, images[large].name |
description | 2,000 | details (the explorer description is the claim plus this text) |
creator | 100 | creator, owner.name + owner.title (Artist, Author, Creator or Owner) |
x_handle | 15 | x_handle (@handle), x_url, social[{type:"x"}] |
website | 200 | website |
year, medium, dimensions, edition, serial | 12 / 100 / 100 / 40 / 60 | flat keys + attributes |
collection | 100 | collection, owner.organization |
category | 60 | categories[{type:"main"}]; the type label is categories[{type:"sub"}] |
tags | 10 × 30 | tags, categories[{type:"other"}] |
external_url | 200 | external_url, contacts[{type:"url"}] |
Text is trimmed and control or direction-override characters are removed. Links must be http(s) with no spaces, quotes or angle brackets. Anything invalid returns 400 bad_metadata with field.
Sign in JavaScript
With @scure/btc-signer (npm i @scure/btc-signer @scure/base @noble/curves):
import * as btc from '@scure/btc-signer';
import { base64, hex } from '@scure/base';
import { secp256k1 } from '@noble/curves/secp256k1.js';
const API = 'https://proveitonchain.com';
const priv = hex.decode(process.env.AGENT_BTC_PRIVKEY_HEX); // your agent's key, never sent anywhere
const address = btc.p2wpkh(secp256k1.getPublicKey(priv, true)).address;
const post = (path, body) => fetch(API + path, {
method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body),
}).then(async (r) => { const j = await r.json(); if (!r.ok) throw new Error(`${j.code}: ${j.error}`); return j; });
// 1. create
const proof = await post('/api/v1/proofs', { claim: 'I wrote this first', address });
// 2. check, then sign
const tx = btc.Transaction.fromPSBT(base64.decode(proof.unsigned_psbt), { allowUnknownOutputs: true });
const fee = proof.fees.service;
let paysFee = false;
for (let i = 0; i < tx.outputsLength; i++) {
const o = tx.getOutput(i);
try { if (btc.Address().encode(btc.OutScript.decode(o.script)) === fee.address && o.amount === BigInt(fee.sats)) paysFee = true; } catch {}
}
if (fee.sats && !paysFee) throw new Error('unexpected outputs');
tx.sign(priv);
tx.finalize();
// 3. broadcast (or send tx.hex to any Bitcoin node / mempool.space yourself)
const sent = await post('/api/v1/broadcast', { record_id: proof.record_id, signed_tx_hex: tx.hex });
console.log(sent.txid, sent.verify_url);
Errors and limits
Every error is JSON: {"error": "readable reason", "code": "machine_code"}. Common codes: address_required, bad_address, claim_required, bad_type, type_not_available, bad_metadata, name_required, creator_required, photo_required, content_required, sha256_mismatch, name_not_owned, tx_mismatch, expired, broadcast_not_enabled, rate_limited.
Per IP: 20 new proofs per hour, 40 broadcasts per hour, 120 reads per minute. An unsigned transaction is valid for 30 minutes. CORS is open, so browser agents work too.
Coming soon
- Inscribe: store the file itself on Bitcoin as an Ordinals inscription ($5 + network fee). Available on the website now.
- x402 payments for agents that pay in stablecoins.
Use with AI agents (MCP)
Prove It Onchain is also a hosted MCP server. Any MCP client (Claude, Cursor, Grok and other agents) can connect with just the URL. No install, no API key. It is non-custodial like the API: it returns unsigned transactions and never signs.
https://proveitonchain.com/mcp
Give your agent a name on Bitcoin. Name tools: check_name (availability and price), buy_name (order id, exact amount, pay-to address, expiry), get_name_order, cancel_name_order, get_agent_profile and set_agent_profile (signed by the holder). Proof tools: get_quote, create_proof (returns an unsigned PSBT with the fee inside), broadcast (your signed PSBT or raw tx), get_proof_status and verify (any asset, with the certificate URL and agent identity). Transport: Streamable HTTP, stateless, JSON responses.
Claude Desktop (Settings → Connectors → Add custom connector, paste the URL), or in claude_desktop_config.json:
{
"mcpServers": {
"proveitonchain": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://proveitonchain.com/mcp"]
}
}
}
Cursor (~/.cursor/mcp.json or .cursor/mcp.json):
{
"mcpServers": {
"proveitonchain": { "url": "https://proveitonchain.com/mcp" }
}
}
Claude Code:
claude mcp add --transport http proveitonchain https://proveitonchain.com/mcp
Any other client: add a Streamable HTTP server with URL https://proveitonchain.com/mcp. Discovery file: /.well-known/mcp.json.
What a proof is
A proof shows that the issuer published a signed, hashed claim at a point in time. It is not legal title, a certificate of authenticity, or proof of identity. Ownership Tokens and Certificates of Provenance are signed claims passed wallet to wallet, not legal title, shares or investments.