WhatsApp MCP Server

Instructions

Implementation Reference

• src/whatsapp_mcp/whatsapp_client.py:93-103 (handler)

  The handler implementation for get_auth_status which checks the authentication state of the WhatsApp client.

  async def get_auth_status(self) -> dict[str, Any]:
      await self.ensure_started()
      assert self._page is not None
  
      state = await self._detect_state()
  
      return {
          "state": state,
          "base_url": self.settings.base_url,
          "page_url": self._page.url,
          "page_title": await self._page.title(),

• src/whatsapp_mcp/mcp_server.py:150-155 (registration)

  Registration of the get_auth_status tool within the MCP server definition.

  "get_auth_status": ToolDefinition(
      name="get_auth_status",
      description="Open WhatsApp Web if needed and report whether login is complete.",
      input_schema={"type": "object", "properties": {}, "additionalProperties": False},
      handler=lambda _: self.client.get_auth_status(),
  ),