lattice-mcp
MCP server for the Lattice container orchestration platform, enabling Claude Code to manage workers, stacks, containers, and deployments through natural language.
README
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.