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