Getting Started

4 min

Run the Litmus MCP Server in Docker and start using it in under a minute.

Minimal: SSE only

docker run -d --name litmus-mcp-server \
  -p 8000:8000 \
  ghcr.io/litmusautomation/litmus-mcp-server:latest

The SSE endpoint is now at http://localhost:8000/sse. Wire it into an MCP client (see Clients) and you're done.

With the built-in Web UI

If you want the bundled chat interface (no MCP client required), expose port 9000 and provide one LLM API key:

docker run -d --name litmus-mcp-server \
  -p 8000:8000 -p 9000:9000 \
  -e ANTHROPIC_API_KEY=<key> \
  ghcr.io/litmusautomation/litmus-mcp-server:latest

Open http://localhost:9000, add a Litmus Edge instance from the config page, and start chatting.

Choose your path

If you want to...	Go here
Connect Claude Desktop, Cursor, VS Code, Windsurf, or Claude Code	Clients
Chat from the browser without installing a client	Web UI
Keep your settings across container replacement	Persistent Configuration
Run the server locally (no Docker) for STDIO clients	STDIO Mode
Understand what credentials to send	Headers Reference
See the full tool catalog	Tools Reference

ARM64 hosts

The image is built for linux/amd64. On Apple Silicon or other ARM64 machines, pin the platform:

docker run -d --name litmus-mcp-server \
  --platform linux/amd64 \
  -p 8000:8000 \
  ghcr.io/litmusautomation/litmus-mcp-server:latest

See Docker for additional options.