WSAPI WhatsApp MCP Server

Instructions

Implementation Reference

• src/tools/groups.ts:38-51 (handler)

  The main ToolHandler implementation for 'whatsapp_get_group'. Defines the tool name, description, inline inputSchema, and the async handler function. The handler validates input using getGroupSchema and calls wsapiClient.get(`/groups/${groupId}`) to retrieve group information.

  export const getGroup: ToolHandler = {
    name: 'whatsapp_get_group',
    description: 'Get information about a specific group.',
    inputSchema: {
      type: 'object',
      properties: { groupId: { type: 'string', description: 'Group ID (with @g.us)' } },
      required: ['groupId'],
    },
    handler: async (args: any) => {
      const input = validateInput(getGroupSchema, args);
      const result = await wsapiClient.get(`/groups/${input.groupId}`);
      return { success: true, group: result };
    },
  };

• src/validation/schemas.ts:200-202 (schema)

  Zod validation schema used in the handler for input validation. Defines required 'groupId' field using groupIdSchema (z.string().regex(/@g\.us$/)).

  export const getGroupSchema = z.object({
    groupId: groupIdSchema,
  });

• src/server.ts:53-79 (registration)

  Registers all tools including groupTools (which contains whatsapp_get_group) by iterating over tool categories and adding each ToolHandler to the server's tools Map keyed by name.

  private setupToolHandlers(): void {
    logger.info('Setting up tool handlers');
  
    // Register all tool categories
    const toolCategories = [
      messagingTools,
      contactTools,
      groupTools,
      chatTools,
      sessionTools,
      instanceTools,
      accountTools,
    ];
  
    toolCategories.forEach(category => {
      Object.values(category).forEach(tool => {
        if (this.tools.has(tool.name)) {
          logger.warn(`Tool ${tool.name} already registered, skipping`);
          return;
        }
        this.tools.set(tool.name, tool);
        logger.debug(`Registered tool: ${tool.name}`);
      });
    });
  
    logger.info(`Registered ${this.tools.size} tools`);
  }

• src/validation/schemas.ts:5-5 (schema)

  Base schema for groupId validation used by getGroupSchema. Ensures group ID ends with @g.us.

  const groupIdSchema = z.string().regex(/@g\.us$/);

• src/validation/schemas.ts:305-312 (helper)

  Helper function used in the handler to validate input against the schema, throwing detailed errors if invalid.

  export function validateInput<T>(schema: z.ZodSchema<T>, data: unknown): T {
    const result = schema.safeParse(data);
    if (!result.success) {
      const errors = result.error.errors.map(err => `${err.path.join('.')}: ${err.message}`);
      throw new Error(`Validation failed: ${errors.join(', ')}`);
    }
    return result.data;
  }