---
id: tilt-mcp
version: "0.1.3"
license: MIT
license_treatment: permissive
maintenance: aging
---

# tilt-mcp — Model Context Protocol server for Tilt - interact with Tilt resources through MCP

License: permissive · Maintenance: aging · Downloads: 80.8K/mo

## What it is and what it does

Tilt MCP Server is a bridge that lets Large Language Models and AI assistants interact with your Tilt development environment. It implements the Model Context Protocol, exposing two main capabilities: listing all active Tilt resources with their current status, and fetching recent logs from any resource. The server is built on fastmcp and runs as a standalone process that MCP-compatible clients (like Claude Desktop or mcp-cli) can connect to.

The package is designed for developers using Tilt to manage Kubernetes-based development workflows. It enables AI-powered debugging, automated monitoring, and natural-language queries about your services—for example, asking an AI assistant to show failing services or retrieve logs from a specific resource. It requires Python 3.8 or higher and an existing Tilt installation; the server communicates with Tilt via its API to fetch resource and log data.

Use it for:

- Ask an AI assistant to list all currently running Tilt resources and their health status without manually checking the Tilt UI
- Retrieve the last N lines of logs from a specific service for debugging, triggered through natural language to an LLM
- Identify and debug failing or unhealthy services by querying Tilt state through an AI assistant
- Automate monitoring workflows where an LLM periodically checks resource status and alerts on anomalies
- Integrate Tilt resource visibility into an AI-powered development assistant or chatbot

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Tilt MCP Server exposes Tilt development environment resources and logs to LLM applications through the Model Context Protocol, enabling AI assistants to query resource status and retrieve logs programmatically.

Yes, if you use Tilt for Kubernetes development and want to integrate it with LLM applications. Install friction is minimal and the MIT license is permissive. However, the package is in Alpha with no updates since initial release, so treat it as experimental; verify that fastmcp is maintained and that the API meets your stability requirements before relying on it in production workflows.

## Install

pip install tilt-mcp
uv add tilt-mcp
poetry add tilt-mcp

## Installing tilt-mcp

Before you install: Low install friction with a single pure-Python dependency (fastmcp). The package is in Alpha status and has not seen updates since its initial release 395 days ago, though the repository remains active and unarchived.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions, making it suitable for both commercial and private projects.

Quickstart:

pip install tilt-mcp

# Configure in Claude Desktop config file (e.g., ~/.config/claude/claude_desktop_config.json):
# {
#   "mcpServers": {
#     "tilt": {
#       "command": "tilt-mcp"
#     }
#   }
# }

# Or run directly:
python -m tilt_mcp.server

Requires Tilt to be installed, configured, and running; an MCP-compatible client (e.g., Claude Desktop) to connect to the server; Python 3.8 or higher.

Verify before relying:

- Whether fastmcp is actively maintained and what its own dependency footprint is
- Stability and API compatibility guarantees for an Alpha-stage package
- Performance characteristics when querying large numbers of resources or logs

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 80.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mcp server tilt integration, llm access to tilt resources, kubernetes development ai assistant, tilt logs through model context protocol, ai-powered tilt debugging, mcp tools for tilt, llm kubernetes monitoring, mcp-server, kubernetes-dev, llm-integration

[View on SkillFed](https://skillfed.io/packages/tilt-mcp) · [View on PyPI](https://pypi.org/project/tilt-mcp/)