Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

## [2.7.1] - 2026-02-25

### Fixed

- **Documentation overhaul** - Comprehensive update to all project documentation:
- Fixed stale tool counts across README.md and CLAUDE.md (35 → 38)
- Fixed incorrect tool names in README (`get_server_resources` → `server_resources`, `get_server_domains` → `server_domains`)
- Added detailed Available Tools entries for `teams`, `cloud_tokens`, `search_docs`, `github_apps`
- Added deployment log `page` param and `logs_meta` to deployment tool docs
- Added example prompts for documentation search, teams, and cloud provider management
- Removed hardcoded tool count references from CLAUDE.md documentation standards

## [2.7.0] - 2026-02-25

### Added
Expand Down
4 changes: 2 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co

## Project Overview

MCP (Model Context Protocol) server for Coolify that provides 35 token-optimized tools for AI assistants to manage infrastructure through natural language. Tools cover servers, projects, environments, applications, databases, services, deployments, private keys, smart diagnostics, and batch operations. v2.0.0 reduced token usage by 85% (from ~43,000 to ~6,600 tokens) by consolidating related operations into single tools with action parameters.
MCP (Model Context Protocol) server for Coolify that provides 38 token-optimized tools for AI assistants to manage infrastructure through natural language. Tools cover servers, projects, environments, applications, databases, services, deployments, private keys, teams, cloud tokens, documentation search, smart diagnostics, and batch operations. v2.0.0 reduced token usage by 85% (from ~43,000 to ~6,600 tokens) by consolidating related operations into single tools with action parameters.

## Commands

Expand Down Expand Up @@ -134,7 +134,7 @@ When making changes to the codebase, ensure documentation is updated:
- Follow [Keep a Changelog](https://keepachangelog.com/) format

2. **README.md** - Update if:
- Tool count changes (update "34 tools" in Features section)
- Tool count changes (update tool count in Features section)
- New tools added (add to appropriate category in Available Tools)
- New example prompts needed
- Response size improvements made (update comparison table)
Expand Down
44 changes: 39 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
[![codecov](https://codecov.io/gh/StuMason/coolify-mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/StuMason/coolify-mcp)
[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/stumason-coolify-mcp-badge.png)](https://mseep.ai/app/stumason-coolify-mcp)

> **The most comprehensive MCP server for Coolify** - 35 optimized tools, smart diagnostics, and batch operations for managing your self-hosted PaaS through AI assistants.
> **The most comprehensive MCP server for Coolify** - 38 optimized tools, smart diagnostics, documentation search, and batch operations for managing your self-hosted PaaS through AI assistants.

A Model Context Protocol (MCP) server for [Coolify](https://coolify.io/), enabling AI assistants to manage and debug your Coolify instances through natural language.

Expand Down Expand Up @@ -191,6 +191,24 @@ Deploy nginx:latest from Docker Hub
Deploy from public repo https://github.com/org/repo
```

### Documentation & Help

```text
How do I set up Docker Compose with Coolify?
Search the docs for health check configuration
How do I fix a 502 Bad Gateway error?
What are Coolify environment variables?
```

### Teams & Cloud Providers

```text
Who has access to my Coolify instance?
Show me the current team members
List my cloud provider tokens
Validate my Hetzner API token
```

## Environment Variables

| Variable | Required | Default | Description |
Expand Down Expand Up @@ -238,8 +256,8 @@ These tools accept human-friendly identifiers instead of just UUIDs:

- `list_servers` - List all servers (returns summary)
- `get_server` - Get server details
- `get_server_resources` - Get resources running on a server
- `get_server_domains` - Get domains configured on a server
- `server_resources` - Get resources running on a server
- `server_domains` - Get domains configured on a server
- `validate_server` - Validate server connection

### Projects
Expand Down Expand Up @@ -284,12 +302,28 @@ These tools accept human-friendly identifiers instead of just UUIDs:

- `list_deployments` - List running deployments (returns summary)
- `deploy` - Deploy by tag or UUID
- `deployment` - Manage deployments with `action: get|cancel|list_for_app` (supports `lines` param to limit log output)
- `deployment` - Manage deployments with `action: get|cancel|list_for_app` (supports `lines` and `page` params for paginated log output with `logs_meta`)

### Private Keys

- `private_keys` - Manage SSH keys with `action: list|get|create|update|delete`

### GitHub Apps

- `github_apps` - Manage GitHub App integrations with `action: list|get|create|update|delete`

### Teams

- `teams` - Manage teams with `action: list|get|get_members|get_current|get_current_members`

### Cloud Tokens

- `cloud_tokens` - Manage cloud provider tokens (Hetzner/DigitalOcean) with `action: list|get|create|update|delete|validate`

### Documentation

- `search_docs` - Search Coolify documentation using full-text search. Indexes 1,500+ doc chunks on first call, returns ranked results with titles, URLs, and snippets (~849 tokens for 5 results)

### Batch Operations

Power user tools for operating on multiple resources at once:
Expand All @@ -303,9 +337,9 @@ Power user tools for operating on multiple resources at once:

- **Context-Optimized**: Responses are 90-99% smaller than raw API, preventing context window exhaustion
- **Smart Lookup**: Find apps by domain (`stuartmason.co.uk`), servers by IP, not just UUIDs
- **Docs Search**: Built-in full-text search across Coolify documentation — your AI assistant can look up how-tos and troubleshooting without leaving the conversation
- **Batch Operations**: Restart entire projects, bulk update env vars, emergency stop all apps
- **Production Ready**: 98%+ test coverage, TypeScript strict mode, comprehensive error handling
- **Always Current**: Weekly OpenAPI drift detection ensures the server stays in sync with Coolify

## Related Links

Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "@masonator/coolify-mcp",
"scope": "@masonator",
"version": "2.7.0",
"version": "2.7.1",
"description": "MCP server implementation for Coolify",
"type": "module",
"main": "./dist/index.js",
Expand Down
Loading