🧩 chainmind-mcp

chainmind-mcp is a secure MCP (Model Context Protocol) server module for ChainMind OS — enabling AI agents to execute transactions via MetaMask without ever exposing private keys.

This package acts as the signature layer for agent workflows. It prepares and formats transaction payloads, routes them to MetaMask for signing, and ensures human-in-the-loop final approval.

• 🔐 Built for trustless execution
• 🧠 Designed for LLM-powered agents
• 🧩 Compatible with Claude, GPT-4, and any agent using the MCP protocol

✨ Key Features

• Trustless Signing: MetaMask handles all signing — private keys stay client-side.
• Agent-Ready: Designed for natural language-driven execution flows.
• Modular: Works alongside other MCP tools like erc20-mcp, chainlist-mcp, and solc-mcp.
• LLM-Friendly: Easily connect with Claude, GPT-4, and other AI models.
• Secure by Design: Every transaction includes explicit user approval — no custodianship.

🚀 Quickstart

Requirements:

• Node.js (v20+)
• pnpm package manager

# Install via Git
git clone https://github.com/chainmind-os/chainmind-mcp.git
cd chainmind-mcp

pnpm install
pnpm build

Usage with LLM / ChainMind Agent

To connect this server to your LLM agent or CLI interface:

{
  "mcpServers": {
    "chainmind": {
      "command": "node",
      "args": ["./dist/index.js"]
    }
  }
}

🧱 Architecture Overview

LLM Agent → chainmind-mcp → MetaMask UI → User Signs → TX Sent to Blockchain

1. The LLM builds a transaction intent (e.g., "Transfer 0.1 ETH to 0x123")
2. chainmind-mcp formats a valid transaction payload
3. The payload is sent to MetaMask for final user approval
4. User signs or rejects the transaction
5. If signed, it's broadcasted to the chain

🦊 This module is built on top of the original MetaMask MCP prototype by xiawpohr — extended and modularized for full integration within the ChainMind OS architecture.

🛠️ Supported Tools

| Tool | Description | |------|-------------| | call | Execute a method without sending a transaction | | sign-message | Sign a message with MetaMask | | send-transaction | Broadcast a raw transaction | | verify-message | Verify signed messages | | deploy-contract | Deploy a contract with bytecode + constructor args | | read-contract | Read-only smart contract interaction | | write-contract | Execute write method on a smart contract | | get-account | Return current MetaMask account | | switch-chain | Switch active chain | | get-chain-id | Get current chain ID | | get-chains | List configured chains | | get-block-number | Return latest block number | | get-token-balance | Return ERC-20 token balance | | get-native-currency-balance | Return ETH/MATIC/AVAX balance | | get-transaction | Get transaction by hash or block ref | | get-transaction-receipt | Wait for transaction to be mined | | estimate-gas | Estimate gas usage | | estimate-fee-per-gas | Get gas base fee estimate | | get-ens-name / get-ens-address | ENS name/address resolution | | get-token | Get token metadata (symbol, decimals, etc.) |

🔗 Part of the ChainMind OS Stack

ChainMind OS is the agent operating system that securely bridges AI agents with Web3 execution.

📚 Documentation

📖 Full developer docs: https://docs.chainmind.online

Keywords: MCP, ChainMind, MetaMask