WSAPI WhatsApp MCP Server

Instructions

Implementation Reference

• src/tools/chats.ts:52-68 (handler)

  The handler implementation for the 'whatsapp_archive_chat' tool. It validates the input using updateChatArchiveSchema and makes a PUT request to the WSAPI to archive or unarchive the specified chat.

  export const archiveChat: ToolHandler = {
    name: 'whatsapp_archive_chat',
    description: 'Archive or unarchive a chat.',
    inputSchema: {
      type: 'object',
      properties: {
        chatId: { type: 'string', description: 'Chat ID' },
        archived: { type: 'boolean', description: 'Whether to archive or unarchive' },
      },
      required: ['chatId', 'archived'],
    },
    handler: async (args: any) => {
      const input = validateInput(updateChatArchiveSchema, args);
      await wsapiClient.put(`/chats/${input.chatId}/archive`, { archived: input.archived });
      return { success: true, message: `Chat ${input.archived ? 'archived' : 'unarchived'} successfully` };
    },
  };

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

  Zod schema used for input validation in the whatsapp_archive_chat handler. Defines chatId (referencing chatIdSchema) and archived as boolean.

  export const updateChatArchiveSchema = z.object({
    chatId: chatIdSchema,
    archived: z.boolean(),
  });

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

  Registers all tools including chatTools (which contains whatsapp_archive_chat) into the server's tools Map by iterating over tool categories.

  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/tools/chats.ts:88-88 (registration)

  Exports the chatTools object grouping several chat-related tools, including archiveChat (whatsapp_archive_chat), which is later imported and registered in server.ts.

  export const chatTools = { getChats, getChat, setChatPresence, archiveChat, pinChat };

• src/tools/chats.ts:55-68 (schema)

  Inline inputSchema definition for the whatsapp_archive_chat tool, used by the MCP server for tool call validation.

    inputSchema: {
      type: 'object',
      properties: {
        chatId: { type: 'string', description: 'Chat ID' },
        archived: { type: 'boolean', description: 'Whether to archive or unarchive' },
      },
      required: ['chatId', 'archived'],
    },
    handler: async (args: any) => {
      const input = validateInput(updateChatArchiveSchema, args);
      await wsapiClient.put(`/chats/${input.chatId}/archive`, { archived: input.archived });
      return { success: true, message: `Chat ${input.archived ? 'archived' : 'unarchived'} successfully` };
    },
  };