What is Web3 Assistant Mcp

web3-assistant-mcp is a secure toolkit designed for interacting with blockchain smart contracts, offering multi-chain support.

Use cases

Use cases include analyzing smart contract ABIs, invoking contract methods, managing local wallet addresses, and facilitating interactions with contracts on different blockchain networks.

How to use

To use web3-assistant-mcp, ensure you have Node.js 18+ and pnpm installed. Configure your environment variables by copying .env.example to .env, then install the dependencies using ‘pnpm install’ and build the project with ‘pnpm build’.

Key features

Key features include Smart Contract ABI Analysis, Contract Method Invocation (view/nonpayable/payable), Local Wallet Address Management, and Multi-chain Support.

Where to use

web3-assistant-mcp can be used in various fields such as decentralized finance (DeFi), non-fungible tokens (NFTs), and any application requiring smart contract interactions across multiple blockchain networks.

Web3 Assistant MCP

A secure blockchain smart contract interaction toolkit with multi-chain support.

Key Features

• 📑 Smart Contract ABI Analysis
• 📡 Contract Method Invocation (view/nonpayable/payable)
• 🔑 Local Wallet Address Management
• 🌐 Multi-chain Support

Project Structure

web3-assistant-mcp/
├── src/
│   ├── common/
│   │   ├── clients/        # Blockchain client implementations
│   │   ├── constants/      # Network configurations
│   │   ├── services/       # Core services (contract, wallet)
│   │   └── utils/          # Helper functions
│   ├── tools/              # MCP tool implementations
│   └── types/              # TypeScript type definitions
├── test/                   # Test suites
├── .env.example            # Environment template
└── smithery.yaml           # MCP server configuration

Quick Start

Prerequisites

• Node.js 18+
• pnpm
• Configure environment variables (copy .env.example):

cp .env.example .env

Installation

pnpm install

Build

pnpm build

MCP Configuration Example

{
  "mcpServers": {
    "web3-assistant": {
      "command": "node",
      "args": [
        "***/dist/index.js"
      ],
      "env": {
        "ALCHEMY_KEY": "your_alchemy_key",
        "INFURA_KEY": "your_infura_key",
        "ANKR_KEY": "your_ankr_key",
        "PRIVATE_KEY": "your_wallet_private_key"
      }
    }
  }
}

Path Note: When using MCP locally, replace *** with the absolute path to your MCP server directory.

MCP Tools Documentation

🔍 analyze_contract_abi - ABI Analysis

{
  "abi": "[Contract ABI JSON string]"
}

Features:

• Parse contract ABI and list callable methods
• Auto-detect method types (view/pure/payable)
• Input/output parameter types
• State mutability

📞 call_contract - Contract Interaction

Supported Operations:

• Read contract state (view/pure)
• Send transactions (nonpayable)
• Token transfers (payable)

👜 local_wallet_address - Wallet Address

No parameters required:

{
  "address": "0x..."
}

Network Configuration

Pre-configured networks in src/common/constants/networks:

• mainnet: Ethereum Mainnet
• sepolia: Ethereum Sepolia
• base: Base Mainnet
• baseSepolia: Base Testnet

Security Guidelines

1. Private Key Management: Configure via environment variables
2. Transaction Verification: Confirm details for payable methods
3. Gas Limits: Automatic safe gas calculation