WAHA MCP Server

Instructions

Implementation Reference

• src/index.ts:2429-2446 (handler)

  The main handler function for the "waha_get_contact" MCP tool. It validates the contactId input, calls the WAHA client's getContact method, and returns a formatted text response containing the contact information as JSON.

  private async handleGetContact(args: any) {
    const contactId = args.contactId;
  
    if (!contactId) {
      throw new Error("contactId is required");
    }
  
    const contact = await this.wahaClient.getContact(contactId);
  
    return {
      content: [
        {
          type: "text",
          text: `Contact information for ${contactId}:\n${JSON.stringify(contact, null, 2)}`,
        },
      ],
    };
  }

• src/index.ts:870-883 (schema)

  The input schema definition for the "waha_get_contact" tool, specifying that a 'contactId' string (format: number@c.us) is required.

  {
    name: "waha_get_contact",
    description: "Get contact information by ID.",
    inputSchema: {
      type: "object",
      properties: {
        contactId: {
          type: "string",
          description: "Contact ID (format: number@c.us)",
        },
      },
      required: ["contactId"],
    },
  },

• src/index.ts:1134-1135 (registration)

  Registration of the tool handler in the MCP CallToolRequestSchema switch statement, dispatching calls to handleGetContact.

    return await this.handleGetContact(args);
  case "waha_get_all_contacts":

• src/client/waha-client.ts:1230-1245 (helper)

  Supporting WAHA client method that performs the actual API request to retrieve contact information via GET /api/contacts?contactId=...&session=...

  async getContact(contactId: string): Promise<any> {
    if (!contactId) {
      throw new WAHAError("contactId is required");
    }
  
    const queryParams = { 
      contactId,
      session: this.session
    };
    const queryString = this.buildQueryString(queryParams);
    const endpoint = `/api/contacts${queryString}`;
  
    return this.request<any>(endpoint, {
      method: "GET",
    });
  }