Chia MCP
Read-only Chia blockchain queries with 36 tools, no local node required
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"chia-mcp": {
"command": "npx",
"args": [
"-y",
"chia-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"chia-mcp": {
"command": "npx",
"args": [
"-y",
"chia-mcp"
]
}
}
}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.


