
Give your agent a name on Bitcoin, plus one-of-one proofs signed by its own wallet.
Maintained by@pappyg45(verified)Also a maintainer?
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Relay a signed proof transaction to the Bitcoin network. Send the record_id from create_proof plus either signed_psbt (base64 or hex, finalized or signed) or signed_tx_hex. The server checks it is exactly the transaction it composed and pays the exact service fee, then broadcasts and returns the txid. This spends the coins in the transaction and cannot be undone. Rate limit: 40 per hour per IP. You may also broadcast the signed hex yourself (e.g. mempool.space); the proof is valid either way.
record_id returned by create_proof.
Signed PSBT, base64 or hex.
Fully signed raw transaction hex (alternative to signed_psbt).
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http proveitonchain https://proveitonchain.com/mcp
Relay a signed proof transaction to the Bitcoin network. Send the record_id from create_proof plus either signed_psbt (base64 or hex, finalized or signed) or signed_tx_hex. The server checks it is exactly the transaction it composed and pays the exact service fee, then broadcasts and returns the txid. This spends the coins in the transaction and cannot be undone. Rate limit: 40 per hour per IP. You may also broadcast the signed hex yourself (e.g. mempool.space); the proof is valid either way.
| Argument | Type | Description |
|---|---|---|
| record_id* | string | record_id returned by create_proof. |
| signed_psbt | string | Signed PSBT, base64 or hex. |
| signed_tx_hex | string | Fully signed raw transaction hex (alternative to signed_psbt). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"record_id"
],
"properties": {
"record_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8,64}$",
"description": "record_id returned by create_proof."
},
"signed_psbt": {
"type": "string",
"description": "Signed PSBT, base64 or hex."
},
"signed_tx_hex": {
"type": "string",
"description": "Fully signed raw transaction hex (alternative to signed_psbt)."
}
},
"additionalProperties": false
}Give your agent a name on Bitcoin. Creates an order for a vanity name delivered to the agent's own Bitcoin address. Rechecks availability, holds the name for 30 minutes and returns order_id, the exact amount to pay in sats/BTC (the $21 + network fee quote plus a 1–999 sat tag that identifies the payment), pay_to, payment_uri and expires_at. Nothing is charged until you pay: send exactly amount_sats to pay_to in one output from any Bitcoin wallet, then poll get_name_order. After payment confirms, the name is registered on Bitcoin and its ownership is transferred to address. Optional profile becomes the name's Agent identity on delivery. Rate limit: 8 orders per hour and 3 open orders per IP.
| Argument | Type | Description |
|---|---|---|
| name* | string | The name, e.g. SATOSHI (4–12 letters A–Z, not starting with A). |
| address* | string | The agent's own Bitcoin address that will own the name (bc1q…, bc1p… or legacy 1…/3…). |
| profile | object | Agent identity shown as "Agent identity" on the verify page and on proveitonchain.com/agent/<NAME>. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"address"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 4,
"description": "The name, e.g. SATOSHI (4–12 letters A–Z, not starting with A)."
},
"address": {
"type": "string",
"maxLength": 100,
"minLength": 14,
"description": "The agent's own Bitcoin address that will own the name (bc1q…, bc1p… or legacy 1…/3…)."
},
"profile": {
"type": "object",
"properties": {
"mcp_url": {
"type": "string",
"maxLength": 300,
"description": "The agent's own MCP endpoint (https)."
},
"website": {
"type": "string",
"maxLength": 300,
"description": "https URL."
},
"operator": {
"type": "string",
"maxLength": 100,
"description": "Person or company that runs the agent."
},
"x_handle": {
"type": "string",
"maxLength": 40,
"description": "@handle or x.com link."
},
"agent_type": {
"type": "string",
"maxLength": 100,
"description": "Agent type or model, free text (e.g. \"trading agent, Grok\")."
},
"description": {
"type": "string",
"maxLength": 500
},
"display_name": {
"type": "string",
"maxLength": 80,
"description": "Public name of the agent."
}
},
"description": "Agent identity shown as \"Agent identity\" on the verify page and on proveitonchain.com/agent/<NAME>.",
"additionalProperties": false
}
},
"additionalProperties": false
}Cancel an unpaid vanity name order and release the name. Refused once a payment has been seen. Do not pay a cancelled order.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | order_id from buy_name. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{32}$",
"description": "order_id from buy_name."
}
},
"additionalProperties": false
}Give your agent a name on Bitcoin. Checks whether a vanity name (4–12 letters A–Z, not starting with A; trademarked and brand names are blocked) is available and returns the live price: $21 service fee + network fee, in USD and sats. Read-only; does not reserve the name. Buy it with buy_name.
| Argument | Type | Description |
|---|---|---|
| name* | string | The name to check, e.g. SATOSHI. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "The name to check, e.g. SATOSHI."
}
},
"additionalProperties": false
}Create a one-of-one proof token on Bitcoin for a claim, file, or SHA-256, paid and signed by the agent's own wallet. Stores the public claim record and returns an UNSIGNED PSBT (base64 and hex) that issues the token (quantity 1, indivisible, locked) and already includes the service fee output. Nothing is broadcast and no money moves until you sign and call broadcast. Types: proof ($2, needs claim), publication ($2, Proof of Publication: needs metadata.name plus a file, sha256 or metadata.description; the file is hashed and never stored), deed ($5, Ownership Token for a personal item, not legal title: needs metadata.name and a photo as file), artwork ($5, Certificate of Provenance: needs metadata.name, metadata.creator and a photo as file). Files: pass a small file as base64 (or data: URL), an https file_url (up to 6 MB), or just its sha256 so the file never leaves your machine. Then sign every input with the key for address (SIGHASH_ALL), do not change any output, finalize, and call broadcast within 30 minutes. Rate limit: 20 new proofs per hour per IP.
| Argument | Type | Description |
|---|---|---|
| file | string | Small file as base64 or a data: URL (keep under ~3 MB). For larger files use file_url or sha256. |
| type | string | Default proof. |
| claim | string | The public claim, e.g. "I wrote this song on 2026-11-17". Required for type proof; generated from metadata for other types. |
| sha256 | string | SHA-256 (hex) of a file, if you do not want to send the file itself. |
| address* | string | The agent's own Bitcoin address. It pays, signs, and receives the token. Native SegWit bc1q… recommended. |
| details | string | Optional longer details for the claim. |
| network | string | Default mainnet. |
| fee_rate | number | Network fee rate in sat/vB. Minimum 5; default is the current standard rate. |
| file_url | string | https URL of the file (up to 6 MB); the server downloads and hashes it. |
| metadata | object | Optional structured details. Shown as separate rows on the certificate and on Tokenscan. |
| file_name | string | |
| file_type | string | MIME type, e.g. image/png. Deed and artwork need an image. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"file": {
"type": "string",
"description": "Small file as base64 or a data: URL (keep under ~3 MB). For larger files use file_url or sha256."
},
"type": {
"enum": [
"proof",
"publication",
"deed",
"artwork"
],
"type": "string",
"description": "Default proof."
},
"claim": {
"type": "string",
"maxLength": 200,
"description": "The public claim, e.g. \"I wrote this song on 2026-11-17\". Required for type proof; generated from metadata for other types."
},
"sha256": {
"type": "string",
"pattern": "^[0-9a-fA-F]{64}$",
"description": "SHA-256 (hex) of a file, if you do not want to send the file itself."
},
"address": {
"type": "string",
"maxLength": 100,
"minLength": 14,
"description": "The agent's own Bitcoin address. It pays, signs, and receives the token. Native SegWit bc1q… recommended."
},
"details": {
"type": "string",
"maxLength": 2000,
"description": "Optional longer details for the claim."
},
"network": {
"enum": [
"mainnet",
"testnet4",
"signet"
],
"type": "string",
"description": "Default mainnet."
},
"fee_rate": {
"type": "number",
"maximum": 500,
"minimum": 5,
"description": "Network fee rate in sat/vB. Minimum 5; default is the current standard rate."
},
"file_url": {
"type": "string",
"format": "uri",
"description": "https URL of the file (up to 6 MB); the server downloads and hashes it."
},
"metadata": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 140,
"description": "Title. Required for publication, deed and artwork."
},
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 30
},
"maxItems": 10
},
"year": {
"type": "string",
"maxLength": 12
},
"medium": {
"type": "string",
"maxLength": 100
},
"serial": {
"type": "string",
"maxLength": 60,
"description": "Serial number or ID of the item."
},
"creator": {
"type": "string",
"maxLength": 100,
"description": "Artist / author / creator name. Required for artwork."
},
"edition": {
"type": "string",
"maxLength": 40
},
"website": {
"type": "string",
"maxLength": 300,
"description": "https URL."
},
"category": {
"type": "string",
"maxLength": 60
},
"x_handle": {
"type": "string",
"maxLength": 40,
"description": "X handle, e.g. @proveitonchain or an x.com link."
},
"collection": {
"type": "string",
"maxLength": 100
},
"dimensions": {
"type": "string",
"maxLength": 100
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "Longer description (a publication can use this as its content)."
},
"external_url": {
"type": "string",
"maxLength": 300,
"description": "http(s) link shown on explorers."
}
},
"description": "Optional structured details. Shown as separate rows on the certificate and on Tokenscan.",
"additionalProperties": false
},
"file_name": {
"type": "string",
"maxLength": 200
},
"file_type": {
"type": "string",
"maxLength": 100,
"description": "MIME type, e.g. image/png. Deed and artwork need an image."
}
},
"additionalProperties": false
}Read the Agent identity attached to a vanity name: display name, operator, website, X handle, description, agent type/model and MCP endpoint, plus the current owner. Shown only while the address that set it still owns the name. Read-only.
| Argument | Type | Description |
|---|---|---|
| name* | string | The vanity name. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 4,
"description": "The vanity name."
}
},
"additionalProperties": false
}Status of a vanity name order: awaiting_payment, payment_seen, paid, registering, transferring, delivered (or expired, cancelled, needs_review, refunded), with the payment, register and transfer tx ids. Polling also moves a paid order forward. Read-only for the caller.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | order_id from buy_name. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{32}$",
"description": "order_id from buy_name."
}
},
"additionalProperties": false
}Status of a proof by record_id: awaiting_signature, expired, pending, or confirmed, with txid, asset, confirmations and links.
| Argument | Type | Description |
|---|---|---|
| record_id* | string | record_id returned by create_proof. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"record_id"
],
"properties": {
"record_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8,64}$",
"description": "record_id returned by create_proof."
}
},
"additionalProperties": false
}Current prices for every proof type. Each is a flat USD service fee plus the Bitcoin network fee on top: proof $2, publication $2, deed (Ownership Token) $5, artwork (Certificate of Provenance) $5. Returns the service fee in USD and sats, the address it is paid to, current network fee rates (sat/vB, never below 5) and an estimated network fee. Read-only; nothing is reserved.
| Argument | Type | Description |
|---|---|---|
| network | string | Default mainnet. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"network": {
"enum": [
"mainnet",
"testnet4",
"signet"
],
"type": "string",
"description": "Default mainnet."
}
},
"additionalProperties": false
}Add or edit the Agent identity on a name you hold. Step 1: call with name and profile (and optionally address) → returns `message`. Step 2: sign that exact message with the holder address (BIP-322, or the legacy "sign message" from Unisat, Xverse, Leather, Sparrow, Electrum or Bitcoin Core) and call again with the same name, profile, message and signature. The message is valid for 1 hour. Only the current holder can set it.
| Argument | Type | Description |
|---|---|---|
| name* | string | The vanity name you hold. |
| address | string | Holder address (defaults to the current owner). |
| message | string | Step 2: the exact message returned in step 1. |
| profile* | object | Agent identity shown as "Agent identity" on the verify page and on proveitonchain.com/agent/<NAME>. |
| signature | string | Step 2: base64 signature of message by the holder address. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"profile"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 4,
"description": "The vanity name you hold."
},
"address": {
"type": "string",
"maxLength": 100,
"description": "Holder address (defaults to the current owner)."
},
"message": {
"type": "string",
"maxLength": 1000,
"description": "Step 2: the exact message returned in step 1."
},
"profile": {
"type": "object",
"properties": {
"mcp_url": {
"type": "string",
"maxLength": 300,
"description": "The agent's own MCP endpoint (https)."
},
"website": {
"type": "string",
"maxLength": 300,
"description": "https URL."
},
"operator": {
"type": "string",
"maxLength": 100,
"description": "Person or company that runs the agent."
},
"x_handle": {
"type": "string",
"maxLength": 40,
"description": "@handle or x.com link."
},
"agent_type": {
"type": "string",
"maxLength": 100,
"description": "Agent type or model, free text (e.g. \"trading agent, Grok\")."
},
"description": {
"type": "string",
"maxLength": 500
},
"display_name": {
"type": "string",
"maxLength": 80,
"description": "Public name of the agent."
}
},
"description": "Agent identity shown as \"Agent identity\" on the verify page and on proveitonchain.com/agent/<NAME>.",
"additionalProperties": false
},
"signature": {
"type": "string",
"maxLength": 2000,
"description": "Step 2: base64 signature of message by the holder address."
}
},
"additionalProperties": false
}Look up any token on Bitcoin by asset name (e.g. A12044707814007245827 or GAMESOFTRUMP). For proofs made on Prove It Onchain it returns the claim, the pass/fail checks (exists, supply is 1, locked, claim record reachable and matching its on-chain hash), owner, creation tx, the certificate URL and the record URL. For other assets it returns their facts (owner, supply, divisibility, lock status) without proof checks. Read-only.
| Argument | Type | Description |
|---|---|---|
| asset* | string | Asset name, numeric (A…) or named. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"asset"
],
"properties": {
"asset": {
"type": "string",
"maxLength": 80,
"minLength": 4,
"description": "Asset name, numeric (A…) or named."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.