ThomasMarches/substrate-mcp-rs

Overview

A Model Context Protocol (MCP) server for Substrate blockchains, written in Rust and using the subxt crate to interface with chain data. It enables AI agents and tools to query and interact with Substrate-based networks through the MCP standard.

Best for

Best for
Developers building MCP-compatible AI tools that need to interact with Substrate blockchains

Use cases

• Connecting AI assistants to Substrate blockchain data via MCP
• Building developer tools that query on-chain state or events
• Integrating Substrate chain interactions into MCP-compatible workflows

How to use

Install

cargo build --release

Tools exposed

• query_balance
• list_pallets
• list_pallet_entries
• dynamic_runtime_call
• send_dynamic_signed_transaction
• query_storage
• get_latest_events
• find_events
• get_latest_block
• get_block_by_hash
• find_extrinsics
• get_system_info
• custom_rpc

Tested with

Cursor, Claude Code, VS Code

Example client config

{\n  "mcpServers": {\n    "substrate-mcp-rs": {\n      "command": "$PROJECT_ROOT_ABSOLUTE_PATH/target/release/substrate-mcp-rs",\n      "args": []\n    }\n  }\n}

Notes

A Model Context Protocol (MCP) server for Substrate blockchains, written in Rust and using the subxt crate to interface with chain data. It enables AI agents and tools to query and interact with Substrate-based networks through the MCP standard.

12 stars on GitHub. Last updated 2025-10-12. Licensed MIT.

Use cases

• Connecting AI assistants to Substrate blockchain data via MCP
• Building developer tools that query on-chain state or events
• Integrating Substrate chain interactions into MCP-compatible workflows

Pros

• Leverages Rust’s performance and safety for blockchain operations
• Built on the well-maintained subxt crate for reliable Substrate interaction
• Open source with a permissive license for customization

Cons

• Small user base (12 stars) indicates limited community support
• Early-stage project may lack extensive documentation or examples
• Requires familiarity with both Substrate and MCP protocols

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.