Skip to main content
Glama

proveitonchain-mcp

Give your agent a name on Bitcoin.

MCP server for Prove It Onchain. 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.

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.

Related MCP server: MCPAGENT

Install

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

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

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

{ "mcpServers": { "proveitonchain": { "url": "https://proveitonchain.com/mcp" } } }
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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      AI agent identity and reputation registry. Ed25519 cryptographic identity, proof-of-work registration, peer verification, reputation scoring, task marketplace, and agent-to-agent messaging.
      26
      760 npm
      3
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI agents with a DID-based identity, secure wallet, and cloud KMS-backed signing keys, enabling trusted interactions with persons, companies, and other agents via standards like OIDC4VCI, OIDC4VP, and SD-JWT.
      Apache 2.0