Buy a vanity name
buy_nameUse when you or your operator want a persistent, verifiable identity on Bitcoin that other agents and humans can check. $21 + network fee, paid from any Bitcoin wallet, no API key. 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 profile on delivery; sign it afterwards with set_agent_profile so verify_agent reports it as verified. Once delivered, the name also works as a sign-in for TOKENLOCK-gated sites that accept it (start_token_signin). Rate limit: 8 orders per hour and 3 open orders per IP.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"address": "<address>"
},
"name": "buy_name"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The name, e.g. SATOSHI (4–12 letters A–Z, not starting with A). | |
| address | Yes | The agent's own Bitcoin address that will own the name (bc1q…, bc1p… or legacy 1…/3…). | |
| profile | No | Agent profile shown on the verify page and on proveitonchain.com/agent/<NAME>. Sign it later with set_agent_profile so it verifies. |