WSAPI WhatsApp MCP Server

Instructions

Implementation Reference

• src/tools/contacts.ts:155-183 (handler)

  The complete ToolHandler for 'whatsapp_get_contact_picture'. Defines the name, description, inputSchema, and the handler function that validates input using getContactSchema, logs the action, fetches the profile picture via wsapiClient.get(`/contacts/${contactId}/picture`), and returns the result.
  export const getContactPicture: ToolHandler = { name: 'whatsapp_get_contact_picture', description: 'Get the profile picture of a WhatsApp contact.', inputSchema: { type: 'object', properties: { contactId: { type: 'string', description: 'Contact ID (phone number with @s.whatsapp.net)', }, }, required: ['contactId'], }, handler: async (args: any) => { const input = validateInput(getContactSchema, args); logger.info('Getting contact picture', { contactId: input.contactId }); const result = await wsapiClient.get(`/contacts/${input.contactId}/picture`); logger.info('Retrieved contact picture successfully', { contactId: input.contactId }); return { success: true, picture: result, message: 'Contact picture retrieved successfully', }; }, };
• src/validation/schemas.ts:173-175 (schema)

  Zod validation schema 'getContactSchema' used by the tool handler for input validation. Ensures contactId matches phone number pattern.
  export const getContactSchema = z.object({ contactId: phoneNumberSchema, });
• src/tools/contacts.ts:247-255 (registration)

  Export of the contactTools object that bundles getContactPicture (whatsapp_get_contact_picture) for registration in the MCP server.
  export const contactTools = { getContacts, getContact, createContact, updateContact, getContactPicture, getContactBusinessProfile, subscribeToContactPresence, };
• src/server.ts:56-76 (registration)

  Server registration logic that imports and registers all tools from contactTools (including whatsapp_get_contact_picture) into the MCP server's tools Map.
  // 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}`); }); });