Zora Coins MCP Server

Instructions

Implementation Reference

• src/index.ts:152-161 (handler)

  The handler function for the 'zora_get_coin_holders' tool. It calls CoinsSDK.getCoinHolders with input parameters and returns the response as JSON text content.

  async ({ address, chainId, after, count }) => {
    // @ts-expect-error - TypeScript can't resolve barrel exports properly
    const resp = await CoinsSDK.getCoinHolders({
      address,
      chainId,
      after,
      count,
    });
    return { content: [{ type: "text", text: json(resp) }] };
  }

• src/index.ts:145-150 (schema)

  Zod input schema defining parameters for the tool: address (required string), chainId (optional number, defaults to Base chain), after (optional cursor string), count (optional int 1-100).

  inputSchema: {
    address: z.string(),
    chainId: z.number().default(DEFAULT_CHAIN.id),
    after: z.string().optional(),
    count: z.number().int().min(1).max(100).optional(),
  },

• src/index.ts:140-162 (registration)

  Registration of the 'zora_get_coin_holders' tool using server.registerTool, including title, description, input schema, and inline handler function.

  server.registerTool(
    "zora_get_coin_holders",
    {
      title: "Get coin holders",
      description: "List holders of a coin with balances and profile data.",
      inputSchema: {
        address: z.string(),
        chainId: z.number().default(DEFAULT_CHAIN.id),
        after: z.string().optional(),
        count: z.number().int().min(1).max(100).optional(),
      },
    },
    async ({ address, chainId, after, count }) => {
      // @ts-expect-error - TypeScript can't resolve barrel exports properly
      const resp = await CoinsSDK.getCoinHolders({
        address,
        chainId,
        after,
        count,
      });
      return { content: [{ type: "text", text: json(resp) }] };
    }
  );