chia-explorer
MCP server that answers questions about the Chia blockchain. Read-only, no keys, no signing.
Backed by the public coinset.org full-node API for chain data and CoinGecko for XCH price. Offer strings and CLVM puzzles are decoded locally via the chia-wallet-sdk native module — no extra services. Supports mainnet (default) and testnet11. Auto-detects network from xch or txch address prefixes.
What it can answer
- What is the current netspace? Peak height? Sync status?
- What is the header hash of block N? How many transactions in that block? What coins were created or destroyed?
- What is the balance of
xch1... (or txch1..., or a raw puzzle hash)?
- Look up a coin by name. Calculate a coin name from its fields. Find the children produced by spending a coin.
- Fetch the CLVM puzzle reveal and solution for a spent coin, plus an automatic classification (xch / cat / nft / did) and parsed conditions.
- Decode a Chia
offer1... string locally and tell you what's being traded. Same for any raw spend bundle.
- Decompile any puzzle reveal and identify its kind (CAT with asset_id, NFT with launcher_id, settlement-payments, plain p2, etc.).
- What's currently in the mempool? Is my specific transaction pending? What fee should I pay for inclusion in 1/5/15 minutes?
- Convert between addresses and puzzle hashes in either direction.
- What is XCH worth in USD (or EUR, GBP, BTC, ...) right now? What's this balance worth?
- How much XCH is left in the strategic reserve? Where has it been sent? Which destinations are known partners, market makers, or exchanges?
Install
The server is a single npm package. No global install needed — every config below uses npx so it stays up to date.
If you want it on your PATH:
npm install -g chia-explorer
Requires Node.js 20+.
Use it with your AI client
Claude Code
claude mcp add chia-explorer -- npx chia-explorer
Claude Desktop
Edit claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"chia-explorer": {
"command": "npx",
"args": ["chia-explorer"]
}
}
}
Restart Claude Desktop.
Cursor
Create or edit ~/.cursor/mcp.json (global) or .cursor/mcp.json inside a project:
{
"mcpServers": {
"chia-explorer": {
"command": "npx",
"args": ["chia-explorer"]
}
}
}
Restart Cursor and enable the server under Settings → MCP.
Codex CLI
Edit ~/.codex/config.toml:
[mcp_servers.chia-explorer]
command = "npx"
args = ["chia-explorer"]
VS Code (native MCP)
Create .vscode/mcp.json in your workspace:
{
"servers": {
"chia-explorer": {
"command": "npx",
"args": ["chia-explorer"]
}
}
}
Windsurf
Edit ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"chia-explorer": {
"command": "npx",
"args": ["chia-explorer"]
}
}
}
Anything else that speaks MCP
It's a standard stdio MCP server. The recipe is always the same: command = npx, args = ["chia-explorer"]. Set COINGECKO_API_KEY as an env var if you have one.
Example prompts
Drop these into a chat once the server is wired up.
Offers
Decode this offer and tell me what's being traded: offer1qqr83wcuu2rykcmqvpsxgfgqmqys...
I just got sent this offer1... string in Discord. Is it safe to take? What do I give and what do I get?
Smart-coin inspection
What kind of coin is 0xabc...123? Pull its puzzle reveal at height 6500000 and tell me if it's a CAT, NFT, DID, or plain XCH.
Walk the children of coin 0xabc... for two hops. Classify each child.
Mempool and fees
Is 0xdeadbeef... (my tx) currently in the mempool?
How many transactions are pending right now? What does the fee market look like for inclusion in the next minute?
What fee should I attach to a take_offer spend to get included in the next 5 minutes?
Balances and pricing
What's the XCH balance of xch1yxqsmyuyjdlgxw4sqjg4vqlqv5ms2qzex00586nu643jqemmarwslh08yl? How much is that in USD and EUR right now?
Convert 1.5 XCH to GBP, EUR, BTC, and SAT.
Chain state
What block was Chia at one hour ago — height, header hash, transaction count?
Is the network synced? What's the current netspace in EiB?
Strategic reserve
How much of the 21M XCH strategic reserve has been spent? Where did the most recent five outflows go — partners, market makers, or exchanges?
Show me every spend from the Swiss cold wallet, with the destination labelled.
Identifier glue
Convert this puzzle hash to a mainnet address: 4bf5122f344554c53bde2ebb8cd2b7e3d1600ad631c385a5d7cce23c7785459a.
What's the coin name for parent 0xaaa..., puzzle hash 0xbbb..., amount 1000000000000?
Pre-built workflows: chia-skills
chia-skills is a companion package of Claude Code skills built on top of this MCP. It turns the read-only tools below into finished workflows you can actually schedule and get notified about: deposit alerts, price triggers, offer safety checks, NFT provenance, invoice watching.
What's in the box:
watch-address — push notification when XCH, a CAT, or an NFT lands at (or leaves) an addresswatch-tx-confirmation — ping when a specific tx_id moves from mempool to confirmedwatch-xch-price — alert when XCH crosses a threshold in any CoinGecko currencywatch-fee-market — catch cheap fee windows to broadcastwatch-prefarm-spend — flag new strategic-reserve outflows with destinations labelledaddress-daily-digest — daily summary of one or more addresses with USD valuesoffer-safety-check — decode an offer1... and check both sides against market pricescoin-lineage / nft-provenance — walk coin or NFT history N hops in either directioninvoice-watch — generate an invoice, watch for the matching deposit, emit a paid receipt
Skills are read-only and idempotent, persist state between runs, and accept structured inputs so other skills or agents can chain them. If you want to see what's possible with chia-explorer beyond ad-hoc prompts, start there. If you want to write your own, the skills repo is the reference.
| Tool | What it does |
|---|
get_blockchain_state | Peak height, netspace (EiB), difficulty, sync status |
get_netspace | Just the netspace in bytes, EiB, and PiB |
get_peak_height | Just the peak height |
get_block_by_height | Block record + header hash for a height |
get_block_by_hash | Block record for a header hash |
count_block_transactions | Coin spends, additions, removals counts for a block |
get_block_additions_and_removals | Every coin created and destroyed in a block (full lists, not just counts) |
get_balance | Balance of an address or puzzle hash (paginated, unspent coins) |
get_coin_records_by_puzzle_hash | Raw coin records for a puzzle hash or address |
get_coin_records_by_parent_ids | Children of one or more spent coins (the usual coin-lineage step) |
get_coin_by_name | Coin record by coin name |
calculate_coin_name | sha256(parent_coin_info || puzzle_hash || amount) — no RPC |
get_puzzle_and_solution | CLVM puzzle reveal + solution for a spent coin, plus automatic puzzle classification and parsed conditions |
decode_offer | Decode a offer1... string locally into offered / requested assets (XCH, CATs with asset_id, NFTs with launcher_id) |
decode_spend_bundle | Same trade-summary shape as decode_offer but for any raw hex spend bundle (e.g. a mempool item) |
decompile_puzzle | Classify any CLVM puzzle reveal (or fetch via coin_id+height) and optionally parse the conditions a spend emits |
get_mempool | List tx_ids currently in the mempool (paginated, with optional full items) |
is_in_mempool | Check whether a specific tx_id is sitting in the mempool right now |
estimate_fee | Recommended mojo fee for inclusion in 1/5/15 minutes (configurable target_times + spend_type bias) |
address_to_puzzle_hash | bech32m decode — no RPC |
puzzle_hash_to_address | bech32m encode — no RPC |
get_xch_price | Current XCH spot price in one or more currencies (CoinGecko) |
convert_xch_to_fiat | Convert a mojo amount to fiat using the current XCH price |
get_prefarm_status | Live per-wallet balances of the 21M XCH strategic reserve, plus total spent |
get_prefarm_spends | Outflows from the reserve, with destinations labelled when known (partners / market makers / exchanges). Filter by wallet, height, or count |
list_prefarm_addresses | The hardcoded registry: custody wallets and known destination addresses. No network call |
list_chips | All Chia Improvement Proposals from the canonical README index in Chia-Network/chips, across every status (Living, Draft, Review, Final, Stagnant, Withdrawn, Obsolete, Grandfathered). Draft and Review entries link to open PRs; Final entries link to merged files. Status comes from the README; front matter is enriched in. Filter by status or category |
get_chip | One CHIP by number. Returns the merged version (if any), any open PR drafts proposing the same number, and optionally the full markdown |
list_chip_drafts | Open PRs against Chia-Network/chips that add or modify a CHIP, with parsed front matter and PR context (author, reviewers, draft flag) |
search_chips | Keyword search across merged CHIPs and open PR drafts (title, description, abstract, authors) |
list_forks | Every Chia consensus fork (hard and soft) with status (Activated, Planned, …), activation block, build, and a link to the purpose (CHIP, post-mortem, blog post). Sourced from the canonical docs page at docs.chia.net, with the source's last_updated date included so callers can judge freshness |
Blockchain tools take an optional network: "mainnet" | "testnet11" (default mainnet). The price, CHIPs, and forks tools take no network arg. The prefarm tools are mainnet only.
Optional config
COINGECKO_API_KEY — if set, sent as x-cg-demo-api-key to lift the free-tier rate limit. The price tools work without it.GITHUB_TOKEN — if set, sent as Authorization: Bearer … to the GitHub API. Lifts the unauthenticated 60/hr limit to 5000/hr for CHIPs listings. Raw file fetches don't need it. The CHIPs tools work without it.
Prompts
network_status — quick snapshot of current chain stateaddress_summary — balance and recent activity for an addressblock_summary — block details plus transaction countsprefarm_summary — strategic reserve balances, recent outflows, and known destinations
What it isn't
- A wallet. No private keys, no signing, no
push_tx.
- A full node. Talks to public coinset.org RPC.
- A mempool watcher. Snapshot data only.
License
MIT