How do I use lattice-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@lattice-mcp List all stacks with their status" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

lattice-mcp

MCP server for the Lattice container orchestration platform. Gives Claude Code direct access to manage workers, stacks, containers, and deployments.

Quick Start

npx lattice-mcp --setup

This prompts for your Lattice API URL and API token, writes the config to ~/.mcp.json, and you're ready to go. Restart Claude Code after setup.

Manual Setup

Add to ~/.mcp.json:

{
  "mcpServers": {
    "lattice": {
      "command": "npx",
      "args": ["-y", "lattice-mcp"],
      "env": {
        "LATTICE_API_URL": "https://lattice-api.appleby.cloud",
        "LATTICE_API_TOKEN": "your-api-token"
      }
    }
  }
}

Generate an API token from the Lattice web dashboard under Settings > API Tokens.

Tools

Overview & Health

Tool	Description
`lattice_overview`	Fleet overview — worker counts, stack counts, failed stacks, CPU/memory
`lattice_health`	API health and database connectivity

Workers

Tool	Description
`lattice_list_workers`	List workers with status, IP, versions
`lattice_get_worker`	Detailed worker info
`lattice_get_worker_metrics`	CPU, memory, disk, network metrics
`lattice_reboot_worker`	Reboot a worker machine
`lattice_upgrade_worker`	Upgrade worker runner to latest
`lattice_stop_all_worker`	Stop all containers on a worker
`lattice_start_all_worker`	Start all containers on a worker

Stacks

Tool	Description
`lattice_list_stacks`	List stacks with status and worker assignment
`lattice_get_stack`	Full stack details including compose YAML
`lattice_update_stack`	Update stack configuration
`lattice_deploy_stack`	Deploy a stack (all or specific containers)
`lattice_restart_stack`	Restart all containers in a stack
`lattice_stop_stack`	Stop all containers in a stack
`lattice_start_stack`	Start all containers in a stack

Containers

Tool	Description
`lattice_list_containers`	List containers with status, image, ports, health
`lattice_get_container`	Full container details
`lattice_get_container_logs`	Recent container logs (stdout/stderr)
`lattice_get_container_lifecycle`	Lifecycle events (start, stop, health changes)
`lattice_start_container`	Start a stopped container
`lattice_stop_container`	Stop a running container
`lattice_restart_container`	Restart a container
`lattice_kill_container`	Force kill a container
`lattice_pause_container`	Pause a running container
`lattice_unpause_container`	Unpause a paused container
`lattice_remove_container`	Remove a container
`lattice_recreate_container`	Remove and recreate a container

Deployments

Tool	Description
`lattice_list_deployments`	List deployments with status and timing
`lattice_get_deployment`	Deployment details with container-level status
`lattice_get_deployment_logs`	Pull, create, start, swap events with timing
`lattice_rollback_deployment`	Rollback to previous state

System

Tool	Description
`lattice_get_audit_log`	Recent audit log entries
`lattice_update_api`	Trigger API self-update
`lattice_update_web`	Trigger web container update
`lattice_list_api_tokens`	List API tokens
`lattice_create_api_token`	Create a new API token
`lattice_delete_api_token`	Delete an API token

Example Prompts

"What's the status of all stacks?"
"Show me logs for the forta-api container"
"Deploy stack 5"
"Which containers are unhealthy?"
"Rollback the last deployment on stack 12"

Environment Variables

Variable	Required	Description
`LATTICE_API_URL`	Yes	Lattice API base URL
`LATTICE_API_TOKEN`	Yes	API token for authentication

License

MIT

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

lattice-mcp

lattice-mcp

Quick Start

Manual Setup

Tools

Overview & Health

Workers

Stacks

Containers

Deployments

System

Example Prompts

Environment Variables

License

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API