# Chia MCP

> Chia MCP is an open-source MCP server for finance and payments. Read-only Chia blockchain queries with 36 tools, no local node required. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/chia-network/chia-mcp
- **MCP Registry name:** io.github.Chia-Network/chia-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Everything runs against hosted Coinset full nodes, so there is nothing to sync. Set CHIA_NETWORK to testnet11 to switch from mainnet, or point CHIA_FULL_NODE_URL at another endpoint; the README warns that local nodes need mTLS client certificates, which this server does not support without a reverse proxy.

Beyond thin wrappers over node RPC calls, a few composite tools do the multi-call work: a full address balance that pages through every unspent coin and reports whether it is complete, offer decoding, coin lineage tracing back to coinbase, and a compact per-block movement summary that avoids the 1 MB-plus raw additions and removals. Three utilities encode and decode addresses and compute coin IDs locally.

Transaction submission through push_tx is off by default and must be enabled with an environment variable.

## Features

- **Blocks and chain state:** Fetches chain state, blocks, block records, spends and unfinished headers.
- **Coin lookups:** Finds coins by ID, puzzle hash, hint or parent, with batch variants.
- **Mempool and fees:** Lists pending transactions, looks up items by coin and estimates fees.
- **Address balance summary:** Pages through all unspent coins and flags whether the total is complete.
- **Offer decoding:** Turns an offer1 string into offered and requested assets and spend details.
- **Opt-in push_tx:** Submitting signed spend bundles stays disabled until CHIA_MCP_ENABLE_PUSH_TX is set.

## Good for

- Check an XCH address balance from an assistant
- Trace a coin back to its origin
- Decode a Chia offer before accepting it
- Summarize coin movements in a block
- Look up fee estimates and pending mempool transactions

## Install

### Claude Code (Terminal)

```sh
claude mcp add chia-mcp -- npx -y chia-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "chia-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "chia-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get_blockchain_state`: Current chain state including peak height, sync status, difficulty and mempool size.
- `get_network_info`: Network name and address prefix.
- `get_routes`: Lists RPC endpoints available on the node.
- `get_block`: Full block by header hash.
- `get_block_record`: Block record by header hash.
- `get_block_record_by_height`: Block record metadata at a height.
- `get_block_records`: Block records for a height range.
- `get_blocks`: Full blocks for a height range.
- `get_block_spends`: All coin spends in a block.
- `get_block_spends_with_conditions`: Coin spends with parsed CLVM conditions.
- `get_additions_and_removals`: Coins created and spent in a block.
- `get_unfinished_block_headers`: Headers of blocks in progress.
- `get_block_count_metrics`: Block count metrics.
- `get_coin_record_by_name`: Single coin by ID.
- `get_coin_records_by_names`: Batch coin lookup by IDs.
- `get_coin_records_by_puzzle_hash`: Coins locked to a puzzle hash.
- `get_coin_records_by_puzzle_hashes`: Coins locked to several puzzle hashes.
- `get_coin_records_by_hint`: Coins tagged with a hint.
- `get_coin_records_by_hints`: Coins tagged with several hints.
- `get_coin_records_by_parent_ids`: Coins created by given parent coins.
- `get_puzzle_and_solution`: CLVM puzzle and solution for a spent coin.
- `get_puzzle_and_solution_with_conditions`: Puzzle, solution and parsed conditions for a spent coin.
- `get_memos_by_coin_name`: Memos associated with a coin.
- `get_all_mempool_tx_ids`: All pending transaction IDs.
- `get_all_mempool_items`: All mempool items with details.
- `get_mempool_item_by_tx_id`: Single mempool item by transaction ID.
- `get_mempool_items_by_coin_name`: Mempool items referencing a coin.
- `get_fee_estimate`: Fee estimates for target inclusion times.
- `push_tx`: Submit a signed spend bundle (disabled by default).
- `get_aggsig_additional_data`: AGG_SIG additional data.
- `get_network_space`: Estimated network space between two blocks.
- `get_address_summary`: Full balance summary for an address or puzzle hash.
- `decode_offer`: Decode an offer string into a structured summary.
- `trace_coin_lineage`: Trace a coin's ancestry toward its origin.
- `summarize_block`: Compact summary of coin movements in a block.
- `address_encode`: Puzzle hash to bech32m address.
- `address_decode`: Address to puzzle hash.
- `coin_id`: Compute a coin ID from parent, puzzle hash and amount.

## FAQ

### Do I need to run a Chia node?

No. It uses Coinset hosted nodes by default.

### Can it use testnet?

Yes, set CHIA_NETWORK to testnet11.

### Can it send transactions?

Only if you set CHIA_MCP_ENABLE_PUSH_TX to 1 or true to enable push_tx.

### Which clients are documented?

Claude Desktop, Claude Code, Cursor and VS Code, all launched with npx -y chia-mcp.

### Is Chia MCP free?

Yes. Chia MCP is open source, so you can use and self-host it for free.

### How do I add Chia MCP to Claude Code?

Run this command in your terminal: claude mcp add chia-mcp -- npx -y chia-mcp

### What are the best alternatives to Chia MCP?

The closest alternatives to Chia MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/chia-mcp
