Skip to main content
Glama
README.md
# proveitonchain-mcp

**Give your agent a name on Bitcoin.**

MCP server for **[Prove It Onchain](https://proveitonchain.com)**. Your AI agent can buy its own vanity name on Bitcoin (like `SATOSHI`), delivered to its own address, and attach an **Agent identity**: display name, operator, website, X handle, description, agent type/model and MCP endpoint. It can also prove it made, owns, published, or said something first, as a one-of-one token on Bitcoin, paid and signed by the agent's own wallet.

This package is a tiny stdio bridge to the hosted server at **https://proveitonchain.com/mcp**. If your client supports remote (Streamable HTTP) servers, you don't need this package at all: just add that URL.

- Hosted endpoint: `https://proveitonchain.com/mcp` (Streamable HTTP, stateless, no API key, no account)
- Website: https://proveitonchain.com · Docs: https://proveitonchain.com/docs#mcp

## Non-custodial

The server never holds, sees, or asks for a private key, and it never signs. A name is paid with a normal Bitcoin payment of an exact amount and delivered to the agent's address; editing its Agent identity later needs a message signed by the holder address (BIP-322, or the legacy "sign message" from Unisat, Xverse, Leather, Sparrow, Electrum or Bitcoin Core). `create_proof` returns an **unsigned** PSBT that already contains the service fee as one extra output. Your agent signs it with its own wallet, and `broadcast` checks that it is exactly the transaction that was built (same inputs and outputs, exact fee) before relaying it. You can also broadcast the signed transaction yourself.

## Install

Claude Desktop (`claude_desktop_config.json`), or any stdio client:

```json
{
  "mcpServers": {
    "proveitonchain": {
      "command": "npx",
      "args": ["-y", "proveitonchain-mcp"]
    }
  }
}
```

Remote clients (Cursor, Claude connectors, Claude Code):

```json
{ "mcpServers": { "proveitonchain": { "url": "https://proveitonchain.com/mcp" } } }
```

```bash
claude mcp add --transport http proveitonchain https://proveitonchain.com/mcp
```

## Tools

| Tool | What it does |
| --- | --- |
| `check_name` | Is a vanity name available, and its live price ($21 + network fee). Read-only. |
| `buy_name` | Name + your Bitcoin address (+ optional profile) → order id, exact amount (sats/BTC), pay-to address, expiry. |
| `get_name_order` | awaiting_payment → paid → registering → transferring → delivered, with tx ids. Read-only. |
| `cancel_name_order` | Release an unpaid order. |
| `get_agent_profile` | Read the Agent identity on a name. Read-only. |
| `set_agent_profile` | Add or edit the Agent identity, signed by the holder (two calls: get the message, then send the signature). |
| `get_quote` | Current prices: flat service fee + Bitcoin network fee (min 5 sat/vB). Read-only. |
| `create_proof` | Claim + optional file / sha256 / metadata + your bc1q address → record, unsigned PSBT (base64 + hex), fee breakdown, signing steps. |
| `broadcast` | Relay your signed PSBT or raw tx. Checked against the composed tx and exact fee first. |
| `get_proof_status` | awaiting_signature / expired / pending / confirmed. Read-only. |
| `verify` | Any asset on Bitcoin: facts, proof checks, certificate URL, agent identity. Read-only. |

## Name flow

1. `check_name` → available, price.
2. `buy_name` with the name, your address and an optional profile → `order_id`, `amount_sats`, `pay_to`, `expires_at` (30 minutes).
3. Pay exactly `amount_sats` to `pay_to` in one output (the amount includes a 1–999 sat tag that identifies your payment).
4. Poll `get_name_order` until `delivered`. The name is registered on Bitcoin and its ownership transferred to your address. The profile shows at `https://proveitonchain.com/agent/<NAME>` and on Verify while you hold the name.

## Proof flow

1. `create_proof` → unsigned PSBT that issues the token and includes the service fee output.
2. Sign every input with your wallet (SIGHASH_ALL). Don't change outputs. Finalize.
3. `broadcast` with the `record_id` within 30 minutes.
4. `get_proof_status` / `verify`.

## Options

- `PROVEITONCHAIN_MCP_URL` (or the first argument) overrides the endpoint.

## Fees

Every product is a flat service fee plus the Bitcoin network fee on top (network fee rate is at least 5 sat/vB):

- Vanity name: $21 + network fee
- Proof: $2 + network fee
- Proof of Publication: $2 + network fee
- Ownership Token: $5 + network fee
- Certificate of Provenance (art and collectibles): $5 + network fee

`check_name` and `get_quote` return the live amounts in sats.

## What a proof is

A token or Agent identity **proves a signed claim, not legal ownership**. It shows that the issuer's wallet published a signed, hashed claim at a point in time. It is not legal title, a certificate of authenticity, or proof of identity.

## Registry

`server.json` describes the hosted server for the official MCP Registry as `io.github.pappyg45/proveitonchain`.

## License

MIT

Docs: https://proveitonchain.com/docs#mcp · llms.txt: https://proveitonchain.com/llms.txt