Chia Explorer MCP Server

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.

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

Blockchain tools take an optional network: "mainnet" | "testnet11" (default mainnet). The price and CHIPs 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