MCPilot

Instructions

Implementation Reference

• packages/metamask-mcp/src/tools/get-ens-address.ts:16-33 (handler)

  The main handler function that executes the tool logic: normalizes the ENS name, calls wagmi's getEnsAddress with optional chainId and blockNumber, and returns the address as text content.

  execute: async (args) => {
    const name = args.name
    const chainId = args.chainId as typeof wagmiConfig['chains'][number]['id']
    const blockNumber = args.blockNumber ? BigInt(args.blockNumber) : undefined
    const result = await getEnsAddress(wagmiConfig, {
      name: normalize(name),
      blockNumber,
      chainId,
    })
    return {
      content: [
        {
          type: "text",
          text: result ?? "undefined",
        },
      ],
    }
  },

• packages/metamask-mcp/src/tools/get-ens-address.ts:11-15 (schema)

  Zod schema defining the input parameters: required 'name' (string), optional 'chainId' and 'blockNumber' (numbers).

  parameters: z.object({
    name: z.string(),
    chainId: z.coerce.number().optional(),
    blockNumber: z.coerce.number().optional(),
  }),

• packages/metamask-mcp/src/tools/get-ens-address.ts:7-35 (registration)

  The registration function that adds the 'get-ens-address' tool to the FastMCP server, including name, description, schema, and handler.

  export function registerGetENSAddressTools(server: FastMCP): void {
    server.addTool({
      name: "get-ens-address",
      description: "Get the ENS address for name",
      parameters: z.object({
        name: z.string(),
        chainId: z.coerce.number().optional(),
        blockNumber: z.coerce.number().optional(),
      }),
      execute: async (args) => {
        const name = args.name
        const chainId = args.chainId as typeof wagmiConfig['chains'][number]['id']
        const blockNumber = args.blockNumber ? BigInt(args.blockNumber) : undefined
        const result = await getEnsAddress(wagmiConfig, {
          name: normalize(name),
          blockNumber,
          chainId,
        })
        return {
          content: [
            {
              type: "text",
              text: result ?? "undefined",
            },
          ],
        }
      },
    });
  };

• packages/metamask-mcp/src/index.ts:49-49 (registration)

  Top-level call to register the get-ens-address tool during server setup.

  registerGetENSAddressTools(server);