# Your agent's bitcoin custody desk.

Ask what a custodian's single point of failure is, what has gone wrong in custody before, who holds the bitcoin behind an ETF, how big stablecoins and tokenized assets are today, and where the primary source for each of those lives. Every answer links its source and states its as-of date.

Documentation: https://proofofcustody.io/ai

## Connect Proof of Custody

Server URL: https://proofofcustody.io/api/mcp
Transport: Streamable HTTP.
Authentication: none. No API key, custom headers or account required.
The service is free and read-only. It cannot move funds, open accounts or change anything.

## Tell your agent

```text
Add the Proof of Custody MCP server at https://proofofcustody.io/api/mcp. On the first Monday of each month, brief me on what changed in bitcoin custody: new or updated custody incidents, corrections and methodology changes, and any score that moved more than 5 points, with links. Each week, tell me if a new custody incident or hardware wallet advisory was published.
```

Your agent handles the schedule. Proof of Custody supplies the data when the agent calls it. Claude scheduled tasks, Hermes, OpenClaw and other agents with scheduling can run the prompt.

## One-click setup

- Claude: https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Proof%20of%20Custody&connectorUrl=https%3A%2F%2Fproofofcustody.io%2Fapi%2Fmcp (confirm the prefilled dialog, choose No sign in, Add, then enable Proof of Custody in the chat's Connectors menu)
- Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=proof-of-custody&config=eyJ1cmwiOiJodHRwczovL3Byb29mb2ZjdXN0b2R5LmlvL2FwaS9tY3AifQ==
- VS Code: vscode:mcp/install?%7B%22name%22%3A%22proof-of-custody%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fproofofcustody.io%2Fapi%2Fmcp%22%7D

## How to add in Meta Muse

Muse can build its own client for an MCP server and keep it as a skill. Tell Muse: "Build a client for the MCP server at https://proofofcustody.io/api/mcp and save it as a skill called Proof of Custody. Use it whenever I ask about bitcoin custody."

## How to add in ChatGPT

1. Open https://chatgpt.com/plugins
2. Select +, then Add custom MCP server.
3. Name it Proof of Custody. Paste https://proofofcustody.io/api/mcp and choose no authentication.
4. Select Create as a plugin. Install it, then select Proof of Custody with @ in a chat.

## Tools

- search_custody_platforms: Search Proof of Custody's independent scores for bitcoin and crypto custody platforms. Covers 90+ platforms across exchanges, qualified custodians, ETFs, IRAs, collaborative multisig and multi-institution custody, each scored 0-100 on a published six-category weighted methodology. Use to compare custody options, to read a named provider's published score and custody model, or to list top-scored platforms. Returns published data with the methodology attached, not a recommendation.
- get_custody_platform: Full Proof of Custody record for one platform: overall score, per-category scores, custody model, fees, insurance position, strengths and limitations. Use after search_custody_platforms, or when a specific provider is named.
- compare_custody_platforms: Compare two or more custody platforms side by side on Proof of Custody's scores and custody architecture. Comparison is the shape most useful for a custody decision, because the differences that matter are structural rather than promotional.
- assess_custody_independence: Apply the Custody Independence Standard: a published four-pillar test of whether a custody arrangement has genuine independence or only nominal distribution. Pillars are vendor, entropy, control and operational independence. Use for 'how many hardware wallets do I need', 'is my multisig actually safe', or to compare custody architectures rather than brands. Architecture-neutral: self-managed, collaborative and institutional arrangements are assessed on identical criteria.
- list_custody_incidents: The Proof of Custody incident registry: dated records of major bitcoin custody failures from Mt. Gox to the 2026 Coldcard entropy defect, each with root cause, reported loss, the lesson, and which custody configurations the failure class could reach. Self-custody failures are included on equal terms with custodial ones. Use for questions about custody risk, historical hacks, or whether a given setup would have survived a class of event.
- get_coldcard_incident_status: Live status of the July 2026 Coldcard entropy failure: a firmware defect that caused affected hardware wallets to skip their hardware random number generator, making generated keys reconstructible offline. Returns the affected-model matrix with fixed firmware versions, confirmed and suspected loss figures, and open questions. Use for any question about Coldcard safety, whether a device or seed is affected, what to do about it, or whether self-custody is still safe after the incident. This is a developing story; the record is updated as primary sources move.
- get_hardware_wallet_scores: Proof of Custody's hardware wallet rubric: six weighted dimensions — entropy and key generation 25%, firmware integrity 20%, supply chain 15%, disclosure conduct 15%, multisig and recovery portability 15%, privacy and data handling 10%. Entropy is weighted highest because a key generated from predictable randomness cannot be protected by anything downstream. Use for 'best hardware wallet', 'X vs Y device', or what to replace a device with. Returns per-device sourced rationale.
- get_etf_custody_concentration: Filing-derived analysis of custodian concentration across US spot bitcoin ETFs: which custodian holds each fund's bitcoin, and the resulting Nakamoto coefficient at the custody layer. Use for questions about bitcoin ETF safety, IBIT or FBTC custody, whether ETFs are diversified, or ETF versus direct ownership.
- find_source: Source router. Given a topic or question about bitcoin or digital-asset market structure (ETF holdings or custodians, stablecoin supply or attestations, tokenized assets, x402 and agent payments, agentic commerce protocols, MCP registries, proof of reserves, regulators and licences, hardware wallet advisories, custody incidents), returns the primary or near-primary sources to read, with cadence, access terms and whether the URL answered today. Use before answering a factual question so the citation is the primary source.
- whats_new: What changed on Proof of Custody since a date: corrections, methodology changes, live incident updates and daily dataset refreshes (stablecoins, tokenized assets, x402, ETF net assets). Use for a scheduled briefing, or to check whether a cached answer went stale. Defaults to the last 30 days.
- watch_counterparties: Watchtower for a holder's counterparties. Give it the names of the exchanges, custodians, ETFs, IRA providers or hardware wallets someone uses and it returns, for each, the published custody model and single point of failure, incidents in the registry, hardware rubric status where it is a device, and any correction or score change since a date. Use for 'anything I should know about where I hold bitcoin' and for scheduled checks. Nothing is logged about the names passed in.
- search_transcripts: Full-text search across 320+ Onramp Media podcast transcripts (The Last Trade, Final Settlement and others) for what a guest or host said about a topic. Returns episode, show, date, matching passages and the episode URL. Use for 'what did X say about Y' and for sourcing a quote. Transcripts are machine-generated; verify a quote against the audio before publishing it.
- get_stablecoin_supply: Daily snapshot of stablecoin supply: total USD-pegged circulating supply, USDT and USDC share, and the top 25 by supply, credited to DefiLlama with the as-of date. Use for 'how big is the stablecoin market', 'USDT vs USDC share', or a stablecoin's supply.
- get_tokenized_assets: Daily snapshot of tokenized-asset (RWA) protocols by TVL, credited to DefiLlama, with a pointer to RWA.xyz for issued asset value by class (tokenized Treasuries, credit, commodities). Use for 'how big is tokenization', 'largest RWA protocols', or where to find tokenized Treasury fund sizes.
- get_x402_services: Daily snapshot of the x402 agent-payments ecosystem: how many x402-payable services the Coinbase Bazaar lists, by network, asset and scheme, plus the x402 Foundation's 30-day transaction, volume, buyer and seller counts. Use for 'what is x402', 'how many services accept x402', or 'which networks do x402 services use'.

## Datasets behind the tools (CC BY 4.0, JSON)

- https://proofofcustody.io/data/bitcoin-custody-dataset.json (91 platform scores)
- https://proofofcustody.io/data/custody-incidents.json (failure registry and live incidents)
- https://proofofcustody.io/data/hardware-wallet-scores.json
- https://proofofcustody.io/data/etf-custody-concentration.json
- https://proofofcustody.io/data/stablecoins.json (daily, credited to DefiLlama)
- https://proofofcustody.io/data/tokenized-assets.json (daily, credited to DefiLlama; RWA.xyz linked for issued value)
- https://proofofcustody.io/data/x402-services.json (daily, credited to the Coinbase x402 Bazaar and x402.org)
- https://proofofcustody.io/data/sources.json (the source router, reachability checked daily)
- https://proofofcustody.io/data/changes.json (corrections and methodology changes)
- https://proofofcustody.io/data/refresh-log.json (the daily heartbeat)

## Privacy

No accounts and no keys. The server logs one line per call: tool name, the calling client's name and version, and the user agent. It does not log tool arguments. Nothing from these logs reaches Onramp Bitcoin's sales or marketing, and nothing is sold or shared. Full text: https://proofofcustody.io/ai#privacy

## Terms

Everything returned is published under CC BY 4.0: reuse with attribution and a link. Read-only. Scores are editorial assessments of public information, not investment advice. Snapshots credited to other publishers are theirs; cite them for the figures. Proof of Custody is published by Onramp Bitcoin, which is scored by the same methodology as every other platform, and every response carries that disclosure. Coverage is selected, not exhaustive. Full text: https://proofofcustody.io/ai#terms

## Support

Changes: https://proofofcustody.io/changelog and https://proofofcustody.io/data/changes.json
Issues and field requests: https://github.com/onrampbtc/bitcoin-custody-dataset/issues