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

... View full README on GitHub