WSAPI WhatsApp MCP Server

Instructions

Implementation Reference

• src/tools/instance.ts:8-17 (handler)

  The main ToolHandler object implementing the whatsapp_get_instance_settings tool. Includes name, description, inputSchema, and the async handler function that logs the action, fetches instance settings from '/instance/settings' endpoint using wsapiClient, and returns success response with settings.

  export const getInstanceSettings: ToolHandler = {
    name: 'whatsapp_get_instance_settings',
    description: 'Get current instance settings.',
    inputSchema: { type: 'object', properties: {} },
    handler: async () => {
      logger.info('Getting instance settings');
      const result = await wsapiClient.get('/instance/settings');
      return { success: true, settings: result, message: 'Instance settings retrieved successfully' };
    },
  };

• src/tools/instance.ts:11-11 (schema)

  Input schema for the tool, which is an empty object since the tool takes no parameters.

  inputSchema: { type: 'object', properties: {} },

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

  The setupToolHandlers method in WSAPIMCPServer that registers all tools, including those from instanceTools (which contains whatsapp_get_instance_settings), by iterating over tool categories and adding each tool to the tools Map.

  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/server.ts:20-20 (registration)

  Import statement bringing in the instanceTools object containing the whatsapp_get_instance_settings handler.

  import { instanceTools } from './tools/instance.js';

• src/tools/instance.ts:60-60 (registration)

  Export of the instanceTools object that groups the instance-related tools, including getInstanceSettings for registration in the server.

  export const instanceTools = { getInstanceSettings, updateInstanceSettings, restartInstance, updateApiKey };