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()