Safe MCP Server

Enable AI agents to manage Safe multisig wallets across multiple blockchains.

A production-ready Model Context Protocol server providing secure, programmatic access to Safe wallet functionality. Built with the official Safe SDK, it enables Claude and other AI systems to create, manage, and interact with Safe multisig wallets without compromising security.

Key Features

🔐 Security-First - Runtime-only key usage, no storage • 🌐 Multi-Chain - 8+ EVM networks supported • 🤖 AI-Native - Built for LLM integration • ⚡ Production-Ready - Real Safe SDK, no mocks • 🛠️ 10 Tools - Complete wallet lifecycle management

Quick Start

Prerequisites

• Node.js 18+
• RPC endpoints (Alchemy/Infura recommended)
• Private keys for transaction signing (optional for read-only)

Installation & Setup

Option 1: NPM Package (Recommended)

npm install -g safe-mcp-server

Option 2: Local Development

git clone https://github.com/your-org/mcp-safe
cd mcp-safe && npm install && npm run build

Integration with Claude

Claude Code CLI

Add the server using the modern CLI command:

# NPM package installation
claude mcp add safe --env SAFE_RPC_EIP155_1=https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY -- safe-mcp-server

# Local development
claude mcp add safe --env SAFE_RPC_EIP155_1=https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY -- node /absolute/path/to/mcp-safe/dist/index.js

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "safe": {
      "command": "safe-mcp-server",
      "env": {
        "SAFE_RPC_EIP155_1": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY",
        "SAFE_RPC_EIP155_11155111": "https://sepolia.infura.io/v3/YOUR_KEY"
      }
    }
  }
}

For local development, use absolute path: "command": "node" with "args": ["/absolute/path/to/mcp-safe/dist/index.js"]

Other MCP Clients

Point your MCP client to dist/index.js with appropriate environment variables for RPC endpoints.

Available Tools

Tool	Purpose
safe_create_wallet_config	Generate and validate wallet configuration
safe_predict_address	Calculate wallet address before deployment
safe_deploy_wallet	Deploy new Safe wallet
safe_get_info	Query wallet details and status
safe_get_balance	Check ETH and token balances
safe_propose_transaction	Create transaction proposals
safe_execute_transaction	Execute transactions directly
safe_add_owner	Add new wallet owners
safe_remove_owner	Remove existing owners
safe_change_threshold	Update signature requirements

Supported Networks

Ethereum • Polygon • Arbitrum • Optimism • Base • Gnosis • Sepolia • Local

Uses CAIP-2 format: eip155:1 (Ethereum), eip155:137 (Polygon), etc.

Example Usage

Create a wallet configuration:

# Test via CLI
echo '{"method":"tools/call","params":{"name":"safe_predict_address","arguments":{"owners":["0x742d35cc6634c0532925a3b844bc9e7595F0fA9B"],"threshold":1,"networkId":"eip155:11155111"}},"id":1}' | safe-mcp-server

Or simply ask Claude: "Create a 2-of-3 Safe wallet on Sepolia with these owners: [addresses]"

Security Best Practices

• Private Keys: Pass as runtime parameters, never store in config files • RPC Endpoints: Use authenticated providers (Alchemy, Infura) with API keys • Address Validation: Ensure all addresses are properly checksummed • Network Testing: Always test on testnets before mainnet operations

Environment Variables

Set RPC URLs for networks you want to support:

SAFE_RPC_EIP155_1=https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY
SAFE_RPC_EIP155_137=https://polygon-mainnet.g.alchemy.com/v2/YOUR_KEY
SAFE_RPC_EIP155_11155111=https://sepolia.infura.io/v3/YOUR_KEY

Development & Testing

# Run tests
npm test

# Manual testing with MCP Inspector  
npx @modelcontextprotocol/inspector npm start

# Type checking and linting
npm run build && npm run lint

Links

Safe Global Docs • Model Context Protocol • Safe SDK

---

Safe MCP Server • Real Safe SDK Integration • Production Ready