Troubleshoot Panel Live Server¶

Port Already in Use¶

Change the port:

pls serve --port 5078

Or find and stop the process using the port.

macOS / Linux:

lsof -ti:5077 | xargs kill -9

Windows (PowerShell):

Get-Process -Id (Get-NetTCPConnection -LocalPort 5077).OwningProcess | Stop-Process -Force

Windows (Command Prompt):

netstat -ano | findstr :5077
taskkill /PID <pid-from-above> /F

Server Not Responding¶

Check server health:

pls status

Or query the health endpoint directly:

curl http://localhost:5077/api/health

On Windows (PowerShell), curl is aliased to Invoke-WebRequest, which needs -UseBasicParsing on older versions:

Invoke-WebRequest http://localhost:5077/api/health -UseBasicParsing

A healthy server returns {"status": "ok", ...}.

Visualizations Not Displaying¶

1. Confirm the server is running: pls status
2. Check that show is listed when you ask your AI assistant for available MCP tools
3. Restart the MCP server if the Panel subprocess failed to start (check startup logs)

Next Steps¶

• Run as MCP Server: connect to your AI client
• Architecture: understand how the components fit together