WhatsApp MCP Server

Implementation Reference

• src/mcp.ts:71-111 (registration)

  Registration of the 'search_contacts' MCP tool, including inline input schema (zod) and the handler function that executes the search logic by calling searchDbForContacts from database.ts and returns formatted JSON results.
  "search_contacts", { query: z .string() .min(1) .describe("Search term for contact name or phone number part of JID"), }, async ({ query }) => { mcpLogger.info( `[MCP Tool] Executing search_contacts with query: "${query}"`, ); try { const contacts = searchDbForContacts(query, 20); const formattedContacts = contacts.map((c) => ({ jid: c.jid, name: c.name ?? c.jid.split("@")[0], })); return { content: [ { type: "text", text: JSON.stringify(formattedContacts, null, 2), }, ], }; } catch (error: any) { mcpLogger.error( `[MCP Tool Error] search_contacts failed: ${error.message}`, ); return { isError: true, content: [ { type: "text", text: `Error searching contacts: ${error.message}`, }, ], }; } }, );
• src/mcp.ts:78-110 (handler)

  The executor/handler function for the search_contacts tool. Logs execution, calls searchDbForContacts(query, 20), formats contacts with jid and name, returns as text/JSON or error.
  async ({ query }) => { mcpLogger.info( `[MCP Tool] Executing search_contacts with query: "${query}"`, ); try { const contacts = searchDbForContacts(query, 20); const formattedContacts = contacts.map((c) => ({ jid: c.jid, name: c.name ?? c.jid.split("@")[0], })); return { content: [ { type: "text", text: JSON.stringify(formattedContacts, null, 2), }, ], }; } catch (error: any) { mcpLogger.error( `[MCP Tool Error] search_contacts failed: ${error.message}`, ); return { isError: true, content: [ { type: "text", text: `Error searching contacts: ${error.message}`, }, ], }; } },
• src/mcp.ts:72-76 (schema)

  Input schema for search_contacts tool using Zod: requires 'query' string min length 1.
  { query: z .string() .min(1) .describe("Search term for contact name or phone number part of JID"),
• src/database.ts:353-384 (helper)

  Core helper function implementing contact search: queries SQLite 'contacts' table for matches in name/notify/phone_number/jid using LIKE, limits results, formats as {jid, name}.
  export function searchDbForContacts( query: string, limit: number = 20 ): { jid: string; name: string | null }[] { const db = getDb(); try { const pattern = `%${query}%`; const stmt = db.prepare(` SELECT jid, COALESCE(name, notify, phone_number, jid) AS display_name FROM contacts WHERE LOWER(COALESCE(name, notify, phone_number, jid)) LIKE LOWER(?) LIMIT ? `); const rows = stmt.all(pattern, limit) as { jid: string; display_name: string | null; }[]; return rows.map((r) => ({ jid: r.jid, name: r.display_name, })); } catch (error) { console.error("Error searching contacts:", error); return []; } }
• src/database.ts:66-72 (schema)

  Database schema definition for the 'contacts' table used by search_contacts.
  CREATE TABLE IF NOT EXISTS contacts ( jid TEXT PRIMARY KEY, name TEXT, notify TEXT, phone_number TEXT ); `);