# Chia Explorer

> MCP server that answers questions about the Chia blockchain

- **Type:** MCP server
- **Install:** `agentstack add mcp-spacetime-technology-chia-explorer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Spacetime-Technology](https://agentstack.voostack.com/s/spacetime-technology)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.2
- **License:** MIT
- **Upstream author:** [Spacetime-Technology](https://github.com/Spacetime-Technology)
- **Source:** https://github.com/Spacetime-Technology/chia-explorer

## Install

```sh
agentstack add mcp-spacetime-technology-chia-explorer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# chia-explorer

MCP server that answers questions about the Chia blockchain. Read-only, no keys, no signing.

Backed by the public [coinset.org](https://www.coinset.org) full-node API for chain data and [CoinGecko](https://www.coingecko.com) for XCH price. Offer strings and CLVM puzzles are decoded locally via the [chia-wallet-sdk](https://github.com/xch-dev/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.

```bash
npx chia-explorer
```

If you want it on your PATH:

```bash
npm install -g chia-explorer
```

Requires Node.js 20+.

## Use it with your AI client

### Claude Code

```bash
claude mcp add chia-explorer -- npx chia-explorer
```

### Claude Desktop

Edit `claude_desktop_config.json` (Settings → Developer → Edit Config):

```json
{
  "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:

```json
{
  "mcpServers": {
    "chia-explorer": {
      "command": "npx",
      "args": ["chia-explorer"]
    }
  }
}
```

Restart Cursor and enable the server under Settings → MCP.

### Codex CLI

Edit `~/.codex/config.toml`:

```toml
[mcp_servers.chia-explorer]
command = "npx"
args = ["chia-explorer"]
```

### VS Code (native MCP)

Create `.vscode/mcp.json` in your workspace:

```json
{
  "servers": {
    "chia-explorer": {
      "command": "npx",
      "args": ["chia-explorer"]
    }
  }
}
```

### Windsurf

Edit `~/.codeium/windsurf/mcp_config.json`:

```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**](https://github.com/Spacetime-Technology/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.

```bash
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(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 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](https://github.com/Spacetime-Technology)
- **Source:** [Spacetime-Technology/chia-explorer](https://github.com/Spacetime-Technology/chia-explorer)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.2 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.2** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-spacetime-technology-chia-explorer
- Seller: https://agentstack.voostack.com/s/spacetime-technology
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.