moonsong-labs/substrate-mcp

Table of Contents

• 📖 About
• 🛠️ Prerequisites
• ⬇ Installation
  • Quick Install
  • Download from Releases
  • Install from Source (Requires cargo)
  • Build Locally (Requires cargo)
• 🤖 Usage with Claude Code
• 🎛️ Configuration
  • GitHub API Rate Limits
• ⚙️ Available Tools
  • Release Analysis
  • Chain Exploration
  • Extrinsic Operations
• 🚀 Available Prompts
  • Polkadot SDK Release Analysis
    • release_comparison
    • analyze_release
    • polkadot_upgrade
  • Development & Scaffolding
    • scaffold_pallet
  • Security Analysis
    • security_review
• 📜 License

📖 About

Substrate MCP is a Rust-based Model Context Protocol server for the Polkadot ecosystem. It lets AI agents explore chain metadata and state, decode extrinsics, submit dev extrinsics, scaffold pallets, and analyze Polkadot SDK releases to understand their impact on your codebase.

🛠 Prerequisites

• Rust Toolchain

• For the subxt_execute tool, install the subxt CLI:

cargo install subxt-cli

⬇ Installation

Choose one of the following installation methods:

Quick Install

curl -sSfL https://raw.githubusercontent.com/Moonsong-Labs/substrate-mcp/main/install.sh | bash

This will:

• Download the appropriate binary for your platform
• Install it to ~/.substrate-mcp/bin/substrate-mcp
• Add the binary to your PATH

Download from Releases

Download the binary for your platform from the latest release.

Install from Source

cargo install --locked --git https://github.com/Moonsong-Labs/substrate-mcp

Build Locally

git clone https://github.com/Moonsong-Labs/substrate-mcp.git
cd substrate-mcp
cargo build --release

The binary will be available at ./target/release/substrate-mcp

🤖 Usage with Claude Code

To use this MCP server with Claude Code, add it to your Claude Code configuration.

{
  "mcpServers": {
    "substrate-mcp": {
      "command": "substrate-mcp"
    }
  }
}