MCP Ethers Wallet

Implementation Reference

• src/tools/core.ts:533-564 (registration)

  Registration of the 'getContractCode' MCP tool, including schema and handler function.

  server.tool(
    "getContractCode",
    {
      address: z.string().describe(
        "The contract's address"
      ),
      provider: z.string().optional().describe(PROVIDER_DESCRIPTION),
      chainId: z.number().optional().describe(
        "Optional. The chain ID to use. If provided with a named network and they don't match, the RPC's chain ID will be used."
      )
    },
    async ({ address, provider, chainId }) => {
      try {
        const code = await ethersService.getContractCode(address, provider, chainId);
        
        return {
          content: [{ 
            type: "text", 
            text: code
          }]
        };
      } catch (error) {
        return {
          isError: true,
          content: [{ 
            type: "text", 
            text: `Error getting contract code: ${error instanceof Error ? error.message : String(error)}`
          }]
        };
      }
    }
  );

• src/tools/core.ts:544-563 (handler)

  The main handler function for the getContractCode tool. It retrieves the contract bytecode using ethersService.getContractCode and returns it as text content, handling errors appropriately.

  async ({ address, provider, chainId }) => {
    try {
      const code = await ethersService.getContractCode(address, provider, chainId);
      
      return {
        content: [{ 
          type: "text", 
          text: code
        }]
      };
    } catch (error) {
      return {
        isError: true,
        content: [{ 
          type: "text", 
          text: `Error getting contract code: ${error instanceof Error ? error.message : String(error)}`
        }]
      };
    }
  }

• src/tools/core.ts:536-543 (schema)

  Input schema using Zod for validating address (required string), provider (optional string), and chainId (optional number).

    address: z.string().describe(
      "The contract's address"
    ),
    provider: z.string().optional().describe(PROVIDER_DESCRIPTION),
    chainId: z.number().optional().describe(
      "Optional. The chain ID to use. If provided with a named network and they don't match, the RPC's chain ID will be used."
    )
  },

• src/tools/index.ts:21-31 (registration)

  Top-level registration function that calls registerCoreTools (which registers getContractCode) among other tool sets.

  export function registerAllTools(server: McpServer, ethersService: any) {
    // Register tool categories
    registerCoreTools(server, ethersService);
    registerERC20Tools(server, ethersService);
    registerERC721Tools(server, ethersService);
    registerERC1155Tools(server, ethersService);
    registerNetworkTools(server);
    registerPromptTools(server);
    
    silentLogger.info("All tools registered successfully");
  }