Chia MCP

chia-mcp

A Model Context Protocol (MCP) server that exposes 36 tools for querying the Chia blockchain (up to 38 with push_tx and local-node options). Uses Coinset hosted nodes — no local Chia node required.

Quick Start

Claude Desktop

Add to your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{

"mcpServers": { "chia": { "command": "npx", "args": ["-y", "chia-mcp"] } } }

Claude Code

claude mcp add chia -- npx -y chia-mcp

claude mcp add chia --env CHIA_NETWORK=testnet11 -- npx -y chia-mcp

Cursor

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{

"mcpServers": { "chia": { "command": "npx", "args": ["-y", "chia-mcp"] } } }

VS Code

Add to your User Settings (JSON) or .vscode/mcp.json:

{

"mcp": { "servers": { "chia": { "command": "npx", "args": ["-y", "chia-mcp"] } } } }

Testnet

Set CHIA_NETWORK to use testnet11:

{

"mcpServers": { "chia": { "command": "npx", "args": ["-y", "chia-mcp"], "env": { "CHIA_NETWORK": "testnet11" } } } }

Environment Variables

Available Tools

Blockchain State

• `get_blockchain_state` — Current chain state: peak height, sync status, difficulty, sub-slot iters, mempool size, network space estimate.
• `get_network_info` — Network name and address prefix (xch/txch).
• `get_routes` — List all available RPC endpoints on the node (only available on non-Coinset nodes).

Blocks

• `get_block` — Full block by header hash (transactions, proofs, rewards).
• `get_block_record` — Block record by header hash (lighter than full block).
• `get_block_record_by_height` — Block record metadata at a height (lighter than full block).
• `get_block_records` — Block records for a height range [start, end).
• `get_blocks` — Full blocks for a height range [start, end).
• `get_block_spends` — All coin spends in a block by header hash.
• `get_block_spends_with_conditions` — Coin spends with parsed CLVM conditions by header hash.
• `get_additions_and_removals` — All coins created/spent in a block.
• `get_unfinished_block_headers` — Unfinished block headers (blocks in progress).
• `get_block_count_metrics` — Block count metrics (compact/uncompact counts).

Coins

• `get_coin_record_by_name` — Single coin by its ID (sha256 of parent+puzzle_hash+amount).
• `get_coin_records_by_names` — Multiple coins by IDs (batch lookup).
• `get_coin_records_by_puzzle_hash` — Coins locked to a puzzle hash, with optional spent/height filters.
• `get_coin_records_by_puzzle_hashes` — Coins locked to multiple puzzle hashes (batch lookup).
• `get_coin_records_by_hint` — Coins tagged with a hint (common in CAT/NFT transactions).
• `get_coin_records_by_hints` — Coins tagged with multiple hints (batch lookup).
• `get_coin_records_by_parent_ids` — Coins created by specific parent coins (trace lineage).
• `get_puzzle_and_solution` — CLVM puzzle and solution for a spent coin at a given height.
• `get_puzzle_and_solution_with_conditions` — Puzzle, solution, AND parsed CLVM conditions for a spent coin.
• `get_memos_by_coin_name` — Memos/messages associated with a coin.

Mempool

• `get_all_mempool_tx_ids` — List all pending transaction IDs.
• `get_all_mempool_items` — All mempool items with full details (can be large).
• `get_mempool_item_by_tx_id` — Single mempool item by transaction ID.
• `get_mempool_items_by_coin_name` — Mempool items referencing a specific coin.
• `get_fee_estimate` — Fee estimates for target inclusion times.

Transactions

• `push_tx` — Submit a signed spend bundle to the mempool.
• `get_aggsig_additional_data` — AGG_SIG additional data for signature verification.

Network

• `get_network_space` — Estimate total network space between two blocks.

Composite (higher-level queries, multiple RPCs)

• `get_address_summary` — Complete balance summary for an address or puzzle hash. Pages through ALL unspent coins to produce an accurate total with a complete flag. This is the correct way to check a balance.
• `decode_offer` — Decode a Chia offer string (offer1...) into a structured summary: coin spends, amounts, coin IDs, puzzle sizes, signature status. Uses the official chia-wallet-sdk for correct parsing.
• `trace_coin_lineage` — Trace a coin's ancestry back to its origin (coinbase). Follows parent links up to max_depth hops.
• `summarize_block` — Compact summary of all coin movements in a block: counts, totals, largest movements, net flow by puzzle hash. Much more useful than raw get_additions_and_removals (which can be 1+ MB).

Utilities (local computation, no RPC)

• `address_encode` — Convert a puzzle hash to a bech32m Chia address (xch1.../txch1...).
• `address_decode` — Decode a bech32m Chia address back to its puzzle hash.
• `coin_id` — Compute a coin ID from parent_coin_id + puzzle_hash + amount.

Tool Examples

Quick reference showing input → output shape for the most commonly used tools.

get_blockchain_state

Input:  {} (no parameters)

Output: { peak_height: 9470000, sync: { synced: true }, difficulty: 2528, space: "33501849665552384", mempool_size: 3, ... }

get_coin_record_by_name

Input:  { name: "0xabc123..." }

Output: { coin: { parent_coin_info: "0x...", puzzle_hash: "0x...", amount: 1750000000000 }, confirmed_block_index: 5000000, spent_block_index: 5000042, coinbase: false, timestamp: 1700000000 }

get_coin_records_by_puzzle_hash

Input:  { puzzle_hash: "0xabc123...", include_spent_coins: false }

Output: [ { coin: { ... }, confirmed_block_index: ..., spent_block_index: 0 }, ... ] Note: Response truncated at 50KB. For complete balance, use get_address_summary instead.

get_address_summary

Input:  { address: "xch1abc123..." }

Output: { total_balance_mojos: "1750000000000", total_balance_xch: "1.75", coin_count: 3, complete: true, oldest_coin_height: 4500000, newest_coin_height: 9400000 } Note: Pages through ALL unspent coins. The complete flag indicates whether the full balance was reached.

trace_coin_lineage

Input:  { coin_id: "0xabc123...", max_depth: 10 }

Output: { lineage: [ { coin_id: "0x...", parent: "0x...", amount: 1750000000000, height: 5000042 }, ... ], depth_reached: 5, reached_coinbase: true }

summarize_block

Input:  { header_hash: "0xabc123..." }

Output: { height: 5000042, is_transaction_block: true, num_additions: 12, num_removals: 6, total_amount_created: "3500000000000", total_amount_spent: "3500000000000", top_movements: [ ... ] } Note: Much smaller than raw get_additions_and_removals (which can be 1+ MB).

decode_offer

Input:  { offer: "offer1..." }

Output: { valid: true, summary: { offered: { xch: "1.0" }, requested: { "asset_id_abc...": 100 } }, coin_spends: 3, has_signature: true }

address_encode

Input:  { puzzle_hash: "0xabc123...", prefix: "xch" }

Output: { address: "xch1abc123..." } Note: Local computation — no RPC call.

address_decode

Input:  { address: "xch1abc123..." }

Output: { puzzle_hash: "0xabc123..." } Note: Local computation — no RPC call.

coin_id

Input:  { parent_coin_info: "0x...", puzzle_hash: "0x...", amount: 1750000000000 }

Output: { coin_id: "0xabc123..." } Note: SHA256(parent + puzzle_hash + amount). Accepts string amounts for values > Number.MAX_SAFE_INTEGER.

Resources

Network State (live)

• `chia://network/mainnet` — Mainnet connection info and live blockchain state.
• `chia://network/testnet11` — Testnet11 connection info and live blockchain state.

Guides (embedded documentation)

• `chia://guide/coin-model` — Chia's coin/UTXO model, spend bundles, token standards, and common LLM mistakes.
• `chia://guide/rpc-quickstart` — Common RPC calls with curl examples and Coinset endpoints.
• `chia://guide/recipes` — Step-by-step recipes for balance checks, transaction tracing, CAT detection — with failure modes.

How It Works

This server wraps the Chia full node RPC API using Coinset's hosted endpoints:

• Mainnet: https://api.coinset.org/
• Testnet11: https://testnet11.api.coinset.org/

All RPC calls are simple HTTP POST requests with JSON bodies. No authentication required.

Coinset Hosted Node vs Local Node

Most tools work against any Chia full node (Coinset-hosted or your own). Three tools are Coinset extensions — they do not exist in chia-blockchain's full node RPC API and will return HTTP 404 against a local node or the simulator:

Simulator portability: Code written against Coinset's extended endpoints will not work against the simulator or a local node. The simulator (chia dev sim) and standard chia-blockchain nodes support the same standard RPC surface. Develop against the simulator using standard RPCs for maximum portability; use Coinset extensions for production querying convenience.

Shared RPCs: get_network_info and get_aggsig_additional_data are shared RPC endpoints available on all Chia services (not full-node-specific). They work on both Coinset and local nodes.

Deliberately omitted RPCs: Three upstream full node RPCs are not exposed as tools: get_constants (static data better served by constants.json), get_recent_signage_point_or_eos (internal consensus detail not useful for agents), and create_block_generator (timelord/farmer internal). All other full node RPCs are exposed.

Prompts

The server provides 9 prompts that encode tool sequencing and failure modes for common Chia tasks:

Known Limitations

• `get_routes` unavailable on Coinset hosted nodes — Returns HTTP 404. This i