WSAPI WhatsApp MCP Server

Instructions

Implementation Reference

• src/tools/contacts.ts:70-108 (handler)

  Full ToolHandler definition and implementation for 'whatsapp_create_contact', including name, description, inputSchema, and the async handler that validates input with createContactSchema and posts to wsapiClient('/contacts')
  export const createContact: ToolHandler = { name: 'whatsapp_create_contact', description: 'Create a new WhatsApp contact.', inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'Contact ID (phone number with @s.whatsapp.net)', }, fullName: { type: 'string', description: 'Full name of the contact (max 255 characters)', }, firstName: { type: 'string', description: 'First name of the contact (max 255 characters)', }, }, required: ['id', 'fullName', 'firstName'], }, handler: async (args: any) => { const input = validateInput(createContactSchema, args); logger.info('Creating contact', { id: input.id, fullName: input.fullName, }); await wsapiClient.post('/contacts', input); logger.info('Contact created successfully', { id: input.id }); return { success: true, message: 'Contact created successfully', }; }, };
• src/validation/schemas.ts:177-181 (schema)

  Zod validation schema (createContactSchema) used by the handler's validateInput for input parameters: id, fullName, firstName
  export const createContactSchema = z.object({ id: phoneNumberSchema, fullName: z.string().min(1).max(255), firstName: z.string().min(1).max(255), });
• src/tools/contacts.ts:247-255 (registration)

  Exports contactTools object containing the createContact handler (whatsapp_create_contact) for later registration in the server
  export const contactTools = { getContacts, getContact, createContact, updateContact, getContactPicture, getContactBusinessProfile, subscribeToContactPresence, };
• src/server.ts:53-79 (registration)

  Server method that registers all tools from collections like contactTools into this.tools Map, including whatsapp_create_contact
  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 containing whatsapp_create_contact for server registration
  import { contactTools } from './tools/contacts.js';