# maintenant

> maintenant is an open-source MCP server for developer tools. Docker and Kubernetes monitoring data for AI agents, read-only mode included. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, Linux, CLI, API
- **Website:** https://docs.maintenant.dev/features/mcp/
- **Repository:** https://github.com/kolapsis/maintenant
- **MCP Registry name:** io.github.kOlapsis/maintenant
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-15

## About

maintenant is a single Go binary that auto-discovers containers, endpoints, certificates, heartbeats and image updates, and its MCP server is built into the same process. The docs describe 51 tools spanning containers, resources, alerts, CVEs, Kubernetes, Docker Swarm, alert routing and the status page.

The important distinction is write access. Seventeen of those tools write: they acknowledge alerts, pause monitors, open incidents and create or change notification channels, triggers and escalation policies, so an unrestricted /mcp endpoint is effectively an admin API. Setting MAINTENANT_MCP_READ_ONLY=true registers only the 34 read-only tools, and the write tools are not listed at all. A demo build serves only the read-only set.

Local clients connect through a stdio relay to a Unix socket created with mode 0600 next to the database. Remote clients such as Claude web, Claude Desktop or Cursor use streamable HTTP with a static OAuth2 client you configure.

## Features

- **51 monitoring tools:** Containers, endpoints, heartbeats, certificates, resources, CVEs, Kubernetes and Swarm in one server.
- **Read-only mode:** One environment variable limits the server to its 34 read tools.
- **Stdio socket relay:** Local clients reach the running instance through a 0600 Unix socket.
- **OAuth2 for remote use:** Streamable HTTP with a single configured client for Claude and Cursor.
- **Alert actions:** Write tools can acknowledge alerts, pause monitors and open incidents.
- **Single-binary install:** Runs from Docker Compose, Kubernetes manifests or a systemd install.

## Good for

- Ask an assistant why a container keeps restarting
- Review certificate expiry and image updates across a stack
- Acknowledge alerts from an editor during an incident
- Give an agent monitoring access without letting it change anything

## Install

### Claude Code (Terminal)

```sh
claude mcp add maintenant -- docker run -i --rm ghcr.io/kolapsis/maintenant:1.11.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "maintenant": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kolapsis/maintenant:1.11.0"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "maintenant": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kolapsis/maintenant:1.11.0"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "maintenant": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kolapsis/maintenant:1.11.0"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "maintenant": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kolapsis/maintenant:1.11.0"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "maintenant": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kolapsis/maintenant:1.11.0"
      ]
    }
  }
}
```

## FAQ

### Can the agent change my setup?

Yes by default: 17 tools write. Setting MAINTENANT_MCP_READ_ONLY=true removes them, leaving 34 read-only tools.

### How do local clients connect?

Through --mcp-stdio, which relays to the instance's mcp.sock and needs MAINTENANT_MCP=true or MAINTENANT_MCP_SOCKET=true.

### How do Claude web or Desktop connect?

Enable MAINTENANT_MCP, set an OAuth2 client ID and secret, and add https://your-host/mcp as a remote server.

### Does it touch my containers?

The registry entry says it can acknowledge alerts but never touches containers.

### Is maintenant free?

Yes. maintenant is open source, so you can use and self-host it for free.

### How do I add maintenant to Claude Code?

Run this command in your terminal: claude mcp add maintenant -- docker run -i --rm ghcr.io/kolapsis/maintenant:1.11.0

### What are the best alternatives to maintenant?

The closest alternatives to maintenant are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/maintenant
