WhatsApp MCP Server

Instructions

Implementation Reference

• src/whatsapp_mcp/server.py:43-56 (handler)

  The primary MCP tool handler for 'open_session', decorated with @mcp.tool() for registration, handles the tool execution by delegating to auth_manager.

  @mcp.tool()
  async def open_session(ctx: Context) -> str:
      """Open a new WhatsApp session."""
      try:
          # Open a new session
          success, message_text = await auth.auth_manager.open_session()
          if success:
              return f"Success: {message_text}"
          else:
              return f"Error: {message_text}"
      except Exception as e:
          logger.error(f"Error opening session: {e}")
          return f"Error: {str(e)}"

• src/whatsapp_mcp/modules/auth.py:58-70 (handler)

  The core implementation logic for opening a WhatsApp session in the AuthManager class, initializes WhatsAppClient and manages session state.

  async def open_session(self) -> Tuple[bool, str]:
      """Open a new session."""
      if self.session:
          return False, "Session already exists"
  
      client = WhatsAppClient()
      success = await client.initialize()
  
      if success:
          self.session = client
          return True, "Session created successfully"
  
      return False, "Failed to create session"

• src/whatsapp_mcp/models.py:9-12 (schema)

  Pydantic input schema model defined for the open_session tool (empty as tool takes no parameters).

  class CreateSessionModel(BaseModel):
      """Input schema for open_session tool."""
  
      pass

• src/whatsapp_mcp/server.py:43-43 (registration)

  The @mcp.tool() decorator registers the open_session function as an MCP tool.

  @mcp.tool()