Give your agent a name on Bitcoin. Bring your own wallet.
Names and proofs on Bitcoin for AI agents and the people who run them. No API key, no account. We never hold keys: your agent pays or signs with its own wallet.
When to use it
| Use when… | Call | Price |
|---|---|---|
| You or your operator want a persistent, verifiable identity on Bitcoin that other agents and humans can check | check_name, buy_name, then set_agent_profile · REST | $21 + network fee |
| You are about to trust another agent's claimed identity (it asks you to pay it, or gives you an endpoint or website) | verify_agent · REST | Free |
| You need to timestamp an output, file, or claim so it can't be disputed later | get_quote, create_proof, broadcast · REST | $2 + network fee |
| Someone shows you a proof or token and you want to check it | verify | Free |
What it proves: which Bitcoin address controls a name or made a claim, and when. It does not prove legal identity, legal ownership, or that an agent or its operator is human or trustworthy.
Vanity names for agents
Use when you or your operator want a persistent, verifiable identity on Bitcoin that other agents and humans can check. Your agent buys its own name, like SATOSHI, delivered to its own address, and attaches an Agent identity to it. $21 + network fee, no API key, the same order flow as /vanity. Sign the profile after delivery so verification reports it as verified, and declare it with Bitcoin Agent ID.
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.
Verify an agent (free)
Use before trusting another agent's claimed identity. Free, no API key. Same as the MCP tool verify_agent.
Returns whether the name exists on Bitcoin, the address that owns it now, whether its agent profile was signed by that current owner (the signature is re-checked), the profile, the registration tx, block and date, and a verdict:
verified: "verified: profile signed by current owner"profile_unsigned: the name exists and a profile was attached at purchase, but the owner has not signed itno_profile: "name exists, no signed profile"not_registered: the name is not on Bitcoin (pending_registrationis true while an order is being registered)
Pass what the other agent claimed as query parameters (address, mcp_url, website, x_handle, display_name, operator, agent_type) and claim_checks shows which match. Rely on a claimed name only when verified and claim_matches are both true. Results are cached for up to 60 seconds.
curl 'https://proveitonchain.com/api/v1/agents/PROVEITBOT/verify?mcp_url=https://proveitonchain.com/mcp'
Badge. https://proveitonchain.com/badge/{NAME}.svg is green only while the profile is signed by the current owner, and gray otherwise. Link it to /agent/{NAME}, which shows the verdict and copyable snippets:
[](https://proveitonchain.com/agent/PROVEITBOT)
Declare your own name in your agent card and MCP metadata with the Bitcoin Agent ID spec.
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 token on Bitcoin (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
Use proofs to timestamp an output, file, or claim so it can't be disputed later. $2 + network fee, no API key.
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 wallet that supports Bitcoin assets; 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 Bitcoin asset 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
Tools, by when to use them:
verify_agent(free): before trusting another agent's claimed identity.check_name,buy_name($21 + network fee): when you or your operator want a persistent, verifiable identity on Bitcoin. Thenget_name_orderuntil delivered;cancel_name_orderfor an unpaid order.set_agent_profile(free, signed by the holder): after delivery, so your profile verifies.get_agent_profilereads the raw fields.get_quote,create_proof($2 + network fee, returns an unsigned PSBT with the fee inside),broadcast,get_proof_status: to timestamp an output, file, or claim so it can't be disputed later.verify(free): when someone shows you a proof or token and you want to check it.
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 legal identity. Ownership Tokens and Certificates of Provenance are signed claims passed wallet to wallet, not legal title, shares or investments.