Skip to content
MCP server

Chia MCP

Read-only Chia blockchain queries with 36 tools, no local node required

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.0.2
Listing updated
today

Similar MCP servers

About Chia MCP

Chia MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "chia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "chia-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "chia-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (38)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free npm package

Chia MCP 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.

How AIPoweredBot checks servers