getContractCode

Retrieve smart contract bytecode from Ethereum networks by providing a contract address and optional network details.

Input Schema

TableJSON Schema

Name	Required	Description
`address`	Yes	The contract's address
`provider`	No	Optional. Either a network name or custom RPC URL. Use getAllNetworks to see available networks and their details, or getNetwork to get info about a specific network. You can use any network name returned by these tools as a provider value.
`chainId`	No	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.

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");
}

MCP Ethers Wallet