Web3

You can interact with Web3 networks through the MCP server, enabling token balance queries, smart contract calls, and token transfers across multiple EVM-compatible chains. This server acts as a bridge between your MCP client and blockchain networks, simplifying cross-chain operations with a single, consistent interface.

How to use

To use the Web3 MCP Server, connect your MCP client to the server as a standard MCP endpoint. You can perform actions such as fetching token balances across chains, calling smart contract functions, transferring native or ERC-20 tokens, and leveraging support for multiple EVM-compatible chains. Your client will send requests to the MCP server, which communicates with the blockchain networks and returns results.

How to install

Prerequisites you need before installing: Node.js and npm (or npx), and optionally Docker if you plan to run the server in a container.

Install Web3 MCP Server via Smithery for Claude Desktop automatically.

npx -y @smithery/cli install web3-mcp-server --client claude

Configuration for Claude Desktop and runtime options

You can configure Claude Desktop to run Web3 MCP Server using NPX, or run it via Docker. Include your wallet private key if you want the server to sign transactions (this is optional).

{
  "mcpServers": {
    "web3": {
      "command": "npx",
      "args": ["-y", "web3-mcp-server"],
      "env": {
        "PRIVATE_KEY": "0xYour-wallet-private-key (optional)"
      }
    }
  }
}

If you prefer Docker, use the following configuration to run the server in a container. Include your private key if needed.

{
  "mcpServers": {
    "web3": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "emanueljr/web3-mcp-server"],
      "env": {
        "PRIVATE_KEY": "0xYour-wallet-private-key (optional)"
      }
    }
  }
}

Notes on security and usage

If you supply a PRIVATE_KEY, ensure you store it securely and limit its exposure to trusted clients only. The server supports both native and ERC-20 token transfers and can call contract methods, so treat it as you would any gateway to on-chain operations.

Available tools

fetchBalances

Fetch token balances across multiple chains, enabling you to view holdings on different networks from a single interface.

callContract

Call smart contract functions on any supported EVM chain, with arguments and return data handled by the MCP client.

transferNative

Transfer native tokens on a chosen chain, enabling simple on-chain value movement.

transferERC20

Transfer ERC-20 tokens across supported chains, including approvals and transfer tracking.

multiChainSupport

Operate across multiple EVM-compatible chains with a unified API surface.