Chia Explorer

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 assetid, NFT with launcherid, 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.

npx chia-explorer

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.

npx chia-skills install

What's in the box:

• watch-address — push notification when XCH, a CAT, or an NFT lands at (or leaves) an address
• watch-tx-confirmation — ping when a specific tx_id moves from mempool to confirmed
• watch-xch-price — alert when XCH crosses a threshold in any CoinGecko currency
• watch-fee-market — catch cheap fee windows to broadcast
• watch-prefarm-spend — flag new strategic-reserve outflows with destinations labelled
• address-daily-digest — daily summary of one or more addresses with USD values
• offer-safety-check — decode an offer1... and check both sides against market prices
• coin-lineage / nft-provenance — walk coin or NFT history N hops in either direction
• invoice-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.

Tools

| 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(parentcoininfo \|\| puzzlehash \|\| 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 assetid, NFTs with launcherid) | | 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 coinid+height) and optionally parse the conditions a spend emits | | get_mempool | List txids currently in the mempool (paginated, with optional full items) | | is_in_mempool | Check whether a specific txid is sitting in the mempool right now | | estimate_fee | Recommended mojo fee for inclusion in 1/5/15 minutes (configurable targettimes + spendtype 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 state
• address_summary — balance and recent activity for an address
• block_summary — block details plus transaction counts
• prefarm_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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Spacetime-Technology
• Source: Spacetime-Technology/chia-explorer
• License: MIT

Install and usage instructions live in the source repository linked above.