Prove It Onchain
● Activeio.github.pappyg45/proveitonchain
Bitcoin names, proofs and free agent checks, plus TOKENLOCK token-gated access for sites and APIs.
Connect this server
One click to install, or copy the config below. Suits: Cursor · HTTP clients.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"proveitonchain": {
"url": "https://proveitonchain.com/mcp"
}
}
}claude mcp add --transport http proveitonchain https://proveitonchain.com/mcpcode --add-mcp '{"name":"proveitonchain","type":"http","url":"https://proveitonchain.com/mcp"}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- Crypto & Web3
- Version
- 1.4.0
- Registry
- active
- Published
- 11/18/2026
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks healthy: Prove It Onchain is maintained, open source, hosted endpoint answering without a key.
- Maintained
- Active
- Last commit 4 days ago (Nov 18, 2026), 0 open issues.
- Official registry
- Active
- Published as io.github.pappyg45/proveitonchain in the official MCP registry, version 1.4.0.
- Source
- Open source, MIT
- Public repository under the MIT licence, 0 stars, 0 forks.
- Runs
- Hosted by the publisher
- Your client talks to proveitonchain.com: prompts and tool arguments leave your machine for that host.
- Credentials
- None needed to connect
- The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.
Live check
checked Nov 22, 2026, 00:07 UTCStatus history & uptime →The endpoint answered the MCP handshake as "Prove It Onchain" and listed 19 tools. Answering since Nov 18, 2026.
Context cost ≈ 7k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 19 tools.
Tools (19)
- get_quote1 param
Use before create_proof to see what a proof will cost right now. Proof $1 + network fee, no API key. Current prices for every proof type. Each is a flat USD service fee plus the Bitcoin network fee on top: proof $1, publication $1, deed (Ownership Token) $1, artwork (Certificate of Provenance) $1. 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.
Show parametersHide parameters
networkstringDefault mainnet.
create_proof12 paramsUse to timestamp an output, file, or claim so it can't be disputed later: for example a report you generated, a dataset hash, a prediction, or a statement your operator wants on record. $1 + network fee (publication, deed and artwork $1), no API key. Creates a one-of-one proof token on Bitcoin for a claim, file, or SHA-256, paid and signed by your 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 ($1, needs claim), publication ($1, Proof of Publication: needs metadata.name plus a file, sha256 or metadata.description; the file is hashed and never stored), deed ($1, Ownership Token for a personal item, not legal title: needs metadata.name and a photo as file), artwork ($1, 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.
Show parametersHide parameters
addressstringrequiredThe agent's own Bitcoin address. It pays, signs, and receives the token. Native SegWit bc1q… recommended.typestringDefault proof.claimstringThe public claim, e.g. "I wrote this song on 2026-11-17". Required for type proof; generated from metadata for other types.detailsstringOptional longer details for the claim.sha256stringSHA-256 (hex) of a file, if you do not want to send the file itself.filestringSmall file as base64 or a data: URL (keep under ~3 MB). For larger files use file_url or sha256.file_namestringfile_typestringMIME type, e.g. image/png. Deed and artwork need an image.file_urlstringhttps URL of the file (up to 6 MB); the server downloads and hashes it.metadataobjectOptional structured details. Shown as separate rows on the certificate and on Tokenscan.fee_ratenumberNetwork fee rate in sat/vB. Minimum 5; default is the current standard rate.networkstringDefault mainnet.
broadcast3 paramsUse after create_proof, once you have signed the PSBT with your own wallet. Relays the 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.
Show parametersHide parameters
record_idstringrequiredrecord_id returned by create_proof.signed_psbtstringSigned PSBT, base64 or hex.signed_tx_hexstringFully signed raw transaction hex (alternative to signed_psbt).
get_proof_status1 paramUse after broadcast to see whether your proof has confirmed. Free. Status of a proof by record_id: awaiting_signature, expired, pending, or confirmed, with txid, asset, confirmations and links.
Show parametersHide parameters
record_idstringrequiredrecord_id returned by create_proof.
- verify1 param
Use when someone shows you a proof, certificate or token and you want to check it before relying on it, or you need the facts about any asset on Bitcoin. Free, no API key. For agent names, verify_agent gives a clearer identity verdict. Looks 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.
Show parametersHide parameters
assetstringrequiredAsset name, numeric (A…) or named.
check_name1 paramUse when you or your operator want a name on Bitcoin and need to know if it is free and what it costs before buying. Name $21 + network fee, no API key. 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. A name you hold can also unlock TOKENLOCK-gated sites and APIs (see tokenlock_info).
Show parametersHide parameters
namestringrequiredThe name to check, e.g. SATOSHI.
- verify_agent3 params
Use before trusting another agent's claimed identity, for example when an agent says it is PROVEITBOT, asks you to pay it, or gives you an MCP endpoint or website. Free, no API key, read-only. Checks the name on Bitcoin and returns: whether it exists, the address that owns it now, whether its agent profile was signed by that current owner (the signature is re-checked), the profile fields, the registration tx/block/date, and a verdict: "verified: profile signed by current owner", "name exists, no signed profile", "name exists, profile set at purchase but not signed by the owner", or "not registered". Optionally pass the address and profile fields the other agent claimed; claim_checks shows which match. A verified name proves which Bitcoin address controls the name and signed the profile, and when. It does not prove legal identity or that the agent or operator is human or trustworthy. Spec: https://proveitonchain.com/agent-id
Show parametersHide parameters
namestringrequiredThe name the agent claims, e.g. PROVEITBOT.addressstringOptional: the Bitcoin address the agent claims holds the name.claimedobjectOptional: profile fields the agent claimed (e.g. its mcp_url or website). Each is compared with the signed profile.
buy_name4 paramsUse 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.
Show parametersHide parameters
namestringrequiredThe name, e.g. SATOSHI (4–12 letters A–Z, not starting with A).addressstringrequiredThe agent's own Bitcoin address that will own the name (bc1q…, bc1p… or legacy 1…/3…).emailstringOptional. Email for a receipt when payment is seen and when the name is delivered. Leave it off if you do not want a receipt. Never shown on the public status pprofileobjectAgent profile shown on the verify page and on proveitonchain.com/agent/<NAME>. Sign it later with set_agent_profile so it verifies.
get_name_order1 paramUse after buy_name to follow your order until the name is delivered. Free. 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.
Show parametersHide parameters
order_idstringrequiredorder_id from buy_name.
cancel_name_order1 paramUse if you created a name order by mistake or chose a different name. Cancel an unpaid vanity name order and release the name. Refused once a payment has been seen. Do not pay a cancelled order.
Show parametersHide parameters
order_idstringrequiredorder_id from buy_name.
- get_agent_profile1 param
Use when you want the raw profile fields of a name. To decide whether to trust an agent, use verify_agent instead. Free. Reads the agent profile 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.
Show parametersHide parameters
namestringrequiredThe vanity name.
set_agent_profile5 paramsUse after your name is delivered to sign its agent profile, so other agents calling verify_agent see "verified: profile signed by current owner". Free (no Bitcoin transaction). Adds or edits the agent profile 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.
Show parametersHide parameters
namestringrequiredThe vanity name you hold.profileobjectrequiredAgent profile shown on the verify page and on proveitonchain.com/agent/<NAME>. Sign it later with set_agent_profile so it verifies.addressstringHolder address (defaults to the current owner).messagestringStep 2: the exact message returned in step 1.signaturestringStep 2: base64 signature of message by the holder address.
create_challenge1 paramUse when another agent or person claims a name (e.g. "I am PROVEITBOT") and you want live proof they control the wallet that holds it right now. Free, no API key. Returns challenge_id, the exact message for them to sign, the holder address that must sign it, expires_at (10 minutes) and a share_url (a signing page for humans). Send them the message or share_url; when they reply with a signature, call verify_challenge. Single use. A pass proves wallet control at that moment, not legal identity.
Show parametersHide parameters
namestringrequiredThe name or token they claim to hold, e.g. PROVEITBOT.
verify_challenge3 paramsUse after create_challenge, when the other party returns a signature. Free. Checks the signature (BIP-322 simple/full or legacy sign-message) against the address that holds the name right now. Returns valid true/false and, on failure, a code: bad_signature, not_holder, holder_changed, expired or already_used. Each challenge can pass once. A pass proves the signer controls the wallet holding the name at that moment, not legal identity.
Show parametersHide parameters
challenge_idstringrequiredchallenge_id from create_challenge.signaturestringrequiredBase64 signature of the exact message.addressstringOptional: the address they say signed it.
productsUse first if you are not sure which tool you need. Free, read-only. Lists both Prove It Onchain products and which tools belong to each: (1) Bitcoin vanity names with a signed agent profile ($21 + network fee), proofs ($1 + network fee) and free identity checks; (2) TOKENLOCK, zero-trust access for the token era: an extra layer in front of your login, admin, or API so only verified token holders get through, or sign in to a gated site with a verifiable identity.
tokenlock_infoUse when you or your operator want an extra layer in front of a login, admin, or API so only verified token holders get through, or you want to know how an agent signs in to a TOKENLOCK-gated site. Free, read-only. TOKENLOCK ("Zero-trust access for the token era") is a self-serve token gate for security teams, AI agents, and mining operations: content stays on your own server; visitors (people or agents) "Sign in with your Token" and Prove It Onchain does the Token check. Self-verify (public spec, no dependence on our API) is Coming soon, Enterprise. Recommended: check the pass on your server so locked content is never sent until that check. A browser-only gate.js snippet is a soft gate (content still reaches the browser; fine for teasers). Returns what it is, plans and prices (unlimited sign-ins, priced by monthly active wallets: Free 1 site / 100 active wallets a month; Starter $19/month; Pro $49/month or $490/year; Business $149/month; Enterprise custom; paid in BTC), integrations with install snippets (recommended: npm @proveitonchain/tokenlock for Next.js and Express, Cloudflare Worker, PHP drop-in; gate.js is a soft gate if used alone), a for_agents section (gate your own API; sign in with a verifiable identity) and links (landing, dashboard, docs, live demo).
check_token_access2 paramsUse before letting someone (or another agent) into something gated by a Bitcoin token or name, or before you try to sign in to a TOKENLOCK-gated site, to see whether a Bitcoin address holds that token right now. Free, read-only, no signature. Holds means the address owns the name/token or has a balance above zero. This is the same holding check TOKENLOCK runs at sign-in, but it does not prove the caller controls the address: for that, use start_token_signin/finish_token_signin (a gate pass) or create_challenge/verify_challenge.
Show parametersHide parameters
assetstringrequiredToken or name on Bitcoin, e.g. GOTPROOF or PROVEITBOT.addressstringrequiredBitcoin address to check (bc1q, bc1p or legacy).
start_token_signin5 paramsUse when you (an agent) want to sign in to a site or API gated by TOKENLOCK, using a Bitcoin name or token your own wallet holds (for example a name bought with buy_name). Free; nothing is paid or sent. Step 1 of 2: returns challenge_id and the exact `message` to sign. For a TOKENLOCK site, pass its publishable site_key (pk_…, public on its sign-in page) and the site origin; the tokens it accepts come from the site. Without a site_key you can name the assets (or any_name) to get a general pass. Then sign `message` with your wallet (BIP-322 or legacy sign-message) and call finish_token_signin within 10 minutes. Counts as a sign-in on the site's plan only when it passes.
Show parametersHide parameters
site_keystringThe site's publishable key pk_… (from its sign-in page). Omit for a general pass.originstringThe gated site's origin, e.g. https://example.com. Required with site_key.assetsarrayWithout site_key: tokens or names that unlock (any one is enough).any_namebooleanWithout site_key: accept any vanity name on Bitcoin.pass_ttl_secondsintegerHow long the pass lasts (default 900).
finish_token_signin4 paramsUse after start_token_signin, once your wallet has signed the message. Free. Checks the signature and that the address holds an accepted token or name right now, and returns a short-lived `pass` (pp1.…). Give the pass to the gated site the way it asks: sites using the npm package or Cloudflare template take it at POST /api/tokenlock/session ({"pass": "…"}) and set a cookie; your own API can take it in a header and check it with verifyPass. If the site accepts any name, send your name. Single use per challenge. A pass proves you controlled a wallet holding the token at sign-in, not who you are.
Show parametersHide parameters
challenge_idstringrequiredchallenge_id from start_token_signin.addressstringrequiredThe Bitcoin address that signed.signaturestringrequiredBase64 signature of the exact message (BIP-322 or legacy sign-message).namestringYour vanity name, when the site accepts any name.
Checked by Serverdex with a plain initialize + tools/list call to proveitonchain.com/mcp, no credentials, about once a day. A failed check is never a removal.
On GitHub
read Nov 18, 2026- Stars
- 0
- Forks
- 0
- Last push
- Nov 18, 2026
- License
- MIT
JavaScriptai-agentsbitcoinmcpmodel-context-protocolprooftimestamp
From the README
proveitonchain-mcp Give your agent a name on Bitcoin, check other agents' names for free, and token-gate access with TOKENLOCK. 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. Two products, one server: 1. Names and proofs on Bitcoin: vanity names with a signed agent profile, one-of-one proofs, free identity and proof checks. 2. TOKENLOCK, Zero-trust access for the token era: an extra layer in front of your login, admin, or API. Only verified token holders get through. Built for security teams, AI agents, and mining operations. Agents can also sign in to a gated site with a verifiable identity. 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.…
Read the full README on GitHub →Remotes
- streamable-http
https://proveitonchain.com/mcp
Alternatives to Prove It Onchain
All Prove It Onchain alternatives →Best Crypto & Web3 servers →The most-starred Crypto & Web3 servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Oh My Posh Validator | 23,772 | Nov 2026 | Working |
| Solana MCP by Vybe | 2,811 | Oct 2026 | Working |
| Solana MCP by Vybe | 2,811 | Oct 2026 | Working |
| Oracle3 prediction-market agent tools | 569 | Nov 2026 | Local / not checked |
| Flyto Core | 483 | Nov 2026 | Local / not checked |
Prove It Onchain: questions people ask
- Is Prove It Onchain a remote or a local MCP server?
- According to its entry in the official MCP registry, Prove It Onchain ships as a hosted endpoint (streamable-http) that your client connects to by URL.
- Does Prove It Onchain need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
- Is Prove It Onchain safe to use?
- Looks healthy: Prove It Onchain is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- Is Prove It Onchain still maintained?
- Active: the repository's last commit 4 days ago. Last push Nov 18, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
- What tools does Prove It Onchain expose?
- 19 tools as listed by the server itself during the live check, including get_quote, create_proof, broadcast, get_proof_status, verify. The full list with parameters is in the Live check section above.
- How do I add Prove It Onchain to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More Crypto & Web3 servers
Browse all Crypto & Web3 →Parallax Protocol
ParallaxProtocol
Read-only Parallax PoW chain data: blocks, transactions, mining, supply, explorer and network health
Monad MCP
pareen
Monad blockchain gateway for AI agents: balances, transfers, swaps, DeFi, with Privy signing.
Carrydesk
pelazas
Funding-carry rankings for Hyperliquid perps, metered per call in USDC via x402.
PERPBRAIN
PERPBRAIN
Read-only Hyperliquid data and simulation with verifiable receipts. No order tool.
NodeProxy Web Surface Markdown Parser
pgalyen1987
x402 MCP web parser: URLs to Markdown for agents. USDC on Base, Polygon, Arbitrum, Ethereum.
AgentData - Executable Liquidity / Exit-Cost
phenicea
Size-aware exit cost, depeg risk & liquidity fragility for a Base token (x402, testnet).
Add the badge to your site
Show visitors that Prove It Onchain is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/io-github-pappyg45-proveitonchain?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Prove It Onchain — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/io-github-pappyg45-proveitonchain?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-pappyg45-proveitonchain) [](https://serverdex.io/install/vscode/io-github-pappyg45-proveitonchain) [](https://serverdex.io/install/claude-code/io-github-pappyg45-proveitonchain)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/io-github-pappyg45-proveitonchain"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-pappyg45-proveitonchain"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-pappyg45-proveitonchain"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).