WSAPI WhatsApp MCP Server

Instructions

Implementation Reference

• src/tools/contacts.ts:15-36 (handler)

  The handler function for the 'whatsapp_get_contacts' tool. It fetches the list of all WhatsApp contacts using wsapiClient.get('/contacts') and returns them along with a count.
  export const getContacts: ToolHandler = { name: 'whatsapp_get_contacts', description: 'Get list of all WhatsApp contacts.', inputSchema: { type: 'object', properties: {}, }, handler: async () => { logger.info('Getting contacts list'); const result = await wsapiClient.get('/contacts'); logger.info('Retrieved contacts successfully', { count: result.length }); return { success: true, contacts: result, count: result.length, message: `Retrieved ${result.length} contacts`, }; }, };
• src/tools/contacts.ts:18-21 (schema)

  Input schema for whatsapp_get_contacts tool (no required parameters).
  inputSchema: { type: 'object', properties: {}, },
• src/server.ts:53-79 (registration)

  Tool registration logic in setupToolHandlers(). The contactTools object (containing whatsapp_get_contacts) is included in toolCategories and its tools are registered in the Map used for tool execution.
  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:16-16 (registration)

  Import of contactTools which provides the whatsapp_get_contacts handler.
  import { contactTools } from './tools/contacts.js';