MCPilot

Instructions

Implementation Reference

• packages/metamask-mcp/src/tools/read-contract.ts:17-57 (handler)

  Implements the core logic of the 'read-contract' tool by calling readContract from @wagmi/core, parsing ABI, and formatting the result or error as text content.

  execute: async (_args) => {
    try {
      const abi = JSON.parse(_args.abi) as Abi
      const address = _args.abi as Address
      const functionName = _args.functionName
      const args = _args.args
      const result = await readContract(wagmiConfig, {
        abi,
        address,
        functionName,
        args,
      })
      return {
        content: [
          {
            type: "text",
            text: `${result}`,
          },
        ],
      }
    } catch (error) {
      if (error instanceof TransactionExecutionError) {
        return {
          content: [
            {
              type: "text",
              text: error.cause.message,
            }
          ]
        }
      }
      return {
        content: [
          {
            type: "text",
            text: (error as Error).message,
          }
        ]
      }
    }
  },

• packages/metamask-mcp/src/tools/read-contract.ts:11-16 (schema)

  Zod schema defining the input parameters for the 'read-contract' tool: abi (string), address (string), functionName (string), args (array of strings).

  parameters: z.object({
    abi: z.string(),
    address: z.string(),
    functionName: z.string(),
    args: z.string().array()
  }),

• packages/metamask-mcp/src/tools/read-contract.ts:7-59 (registration)

  Registers the 'read-contract' tool on the FastMCP server, including name, description, schema, and handler.

  export function registerReadContractTools(server: FastMCP): void {
    server.addTool({
      name: "read-contract",
      description: "Call a read-only function on a contract, and returning the response",
      parameters: z.object({
        abi: z.string(),
        address: z.string(),
        functionName: z.string(),
        args: z.string().array()
      }),
      execute: async (_args) => {
        try {
          const abi = JSON.parse(_args.abi) as Abi
          const address = _args.abi as Address
          const functionName = _args.functionName
          const args = _args.args
          const result = await readContract(wagmiConfig, {
            abi,
            address,
            functionName,
            args,
          })
          return {
            content: [
              {
                type: "text",
                text: `${result}`,
              },
            ],
          }
        } catch (error) {
          if (error instanceof TransactionExecutionError) {
            return {
              content: [
                {
                  type: "text",
                  text: error.cause.message,
                }
              ]
            }
          }
          return {
            content: [
              {
                type: "text",
                text: (error as Error).message,
              }
            ]
          }
        }
      },
    });
  };

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

  Invokes the registration of the 'read-contract' tool during server initialization.

  registerReadContractTools(server);