get-ens-name
Retrieve the primary ENS name associated with a specific blockchain address using MCPilot, enabling secure and efficient blockchain interactions without exposing private keys.
Instructions
Get the primary ENS name for address
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | ||
| blockNumber | No | ||
| chainId | No |
Implementation Reference
- The core handler function that implements the get-ens-name tool logic using wagmi's getEnsName.execute: async (args) => { const address = args.address as Address const chainId = args.chainId as typeof wagmiConfig['chains'][number]['id'] const blockNumber = args.blockNumber ? BigInt(args.blockNumber) : undefined const result = await getEnsName(wagmiConfig, { address, blockNumber, chainId, }) return { content: [ { type: "text", text: result ?? "undefined", }, ], } },
- Zod schema for input validation: requires address string, optional chainId and blockNumber numbers.parameters: z.object({ address: z.string(), chainId: z.coerce.number().optional(), blockNumber: z.coerce.number().optional(), }),
- packages/metamask-mcp/src/tools/get-ens-name.ts:7-35 (registration)The registration function that adds the get-ens-name tool to the FastMCP server.export function registerGetENSNameTools(server: FastMCP): void { server.addTool({ name: "get-ens-name", description: "Get the primary ENS name for address", parameters: z.object({ address: z.string(), chainId: z.coerce.number().optional(), blockNumber: z.coerce.number().optional(), }), execute: async (args) => { const address = args.address as Address const chainId = args.chainId as typeof wagmiConfig['chains'][number]['id'] const blockNumber = args.blockNumber ? BigInt(args.blockNumber) : undefined const result = await getEnsName(wagmiConfig, { address, blockNumber, chainId, }) return { content: [ { type: "text", text: result ?? "undefined", }, ], } }, }); };
- packages/metamask-mcp/src/index.ts:49-50 (registration)Top-level invocation of the tool registration in the main server initialization.registerGetENSAddressTools(server); registerGetENSNameTools(server);
- packages/metamask-mcp/src/tools/index.ts:12-12 (registration)Re-export of the registration module from tools index.export * from "./get-ens-name.js";