{"_id":"@amirhmoradi/coolify-enhanced-mcp","_rev":"2-57041020f5f646e95fec7ec65afb8317","name":"@amirhmoradi/coolify-enhanced-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@amirhmoradi/coolify-enhanced-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","coolify","paas","infrastructure","deployment","ai","claude"],"author":{"name":"Amir H. Moradi"},"license":"MIT","_id":"@amirhmoradi/coolify-enhanced-mcp@1.0.0","maintainers":[{"name":"amirhmoradi","email":"contact@amirhmoradi.com"}],"homepage":"https://github.com/amirhmoradi/coolify-enhanced#readme","bugs":{"url":"https://github.com/amirhmoradi/coolify-enhanced/issues"},"bin":{"coolify-enhanced-mcp":"dist/bin/cli.js"},"dist":{"shasum":"952a840d330ffc6a74a0007ed606247ba93df57e","tarball":"https://registry.npmjs.org/@amirhmoradi/coolify-enhanced-mcp/-/coolify-enhanced-mcp-1.0.0.tgz","fileCount":59,"integrity":"sha512-f692w8nlu50La6pT/1kseIfssIusvyIXJmUaDt59IyjSZKToidvz5DcIUhOI/Jaw4d0qc+Eq2KA4BAraWzdzAA==","signatures":[{"sig":"MEYCIQCMn07F80HAM/ZmxuScEtDeCaQ6AIP5j0n2BwfT51P3/wIhAMjY7yc85dDgKDWLYc4BjqF8LSz5vTwTFd2z28t8Pxuy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@amirhmoradi%2fcoolify-enhanced-mcp@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":224074},"main":"dist/src/index.js","type":"module","types":"./dist/src/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"f298495915dca8042e64175b09af6cbc2e8854ee","scripts":{"dev":"tsc --watch","lint":"eslint src/","test":"vitest run","build":"tsc","start":"node dist/src/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"amirhmoradi","email":"contact@amirhmoradi.com"},"repository":{"url":"git+https://github.com/amirhmoradi/coolify-enhanced.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.9.4","description":"MCP server for Coolify with enhanced features (permissions, backups, templates, networks)","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/coolify-enhanced-mcp_1.0.0_1771710534719_0.23041885233795845","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package has moved to @corelix-io/coolify-enhanced-mcp. Please update your dependency: npm install @corelix-io/coolify-enhanced-mcp"}},"time":{"created":"2026-02-21T21:48:54.637Z","modified":"2026-10-02T16:11:08.301Z","1.0.0":"2026-02-21T21:48:54.872Z"},"bugs":{"url":"https://github.com/amirhmoradi/coolify-enhanced/issues"},"author":{"name":"Amir H. Moradi"},"license":"MIT","homepage":"https://github.com/amirhmoradi/coolify-enhanced#readme","keywords":["mcp","model-context-protocol","coolify","paas","infrastructure","deployment","ai","claude"],"repository":{"url":"git+https://github.com/amirhmoradi/coolify-enhanced.git","type":"git","directory":"mcp-server"},"description":"MCP server for Coolify with enhanced features (permissions, backups, templates, networks)","maintainers":[{"name":"amirhmoradi","email":"contact@amirhmoradi.com"}],"readme":"# Coolify Enhanced MCP Server\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that enables AI assistants to manage [Coolify](https://coolify.io) infrastructure through natural language. Works with both standard Coolify and the [coolify-enhanced](https://github.com/amirhmoradi/coolify-enhanced) addon.\n\n## Features\n\n- **99+ MCP tools** covering all Coolify API endpoints\n- **Enhanced tools** for permissions, resource backups, custom templates, and network management (when coolify-enhanced is installed)\n- **Auto-detection** of enhanced features — falls back to core tools for standard Coolify\n- **Tool annotations** — read-only, destructive, and idempotent hints for AI safety\n- **Retry logic** with exponential backoff for transient API failures\n- **Works with** Claude Desktop, Cursor, VS Code Copilot, Kiro IDE, and any MCP-compatible client\n\n## Quick Start\n\n### Prerequisites\n\n- Node.js 18+\n- A Coolify instance with API enabled\n- An API token (create in Coolify: Settings > Keys & Tokens > API tokens)\n\n### Configuration\n\n#### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"coolify\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@amirhmoradi/coolify-enhanced-mcp\"],\n      \"env\": {\n        \"COOLIFY_BASE_URL\": \"https://coolify.example.com\",\n        \"COOLIFY_ACCESS_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n#### Cursor / VS Code\n\nAdd to your MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"coolify\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@amirhmoradi/coolify-enhanced-mcp\"],\n      \"env\": {\n        \"COOLIFY_BASE_URL\": \"https://coolify.example.com\",\n        \"COOLIFY_ACCESS_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `COOLIFY_BASE_URL` | Yes | — | Coolify instance URL |\n| `COOLIFY_ACCESS_TOKEN` | Yes | — | API token with read/write/deploy scopes |\n| `COOLIFY_ENHANCED` | No | `false` | Force enable enhanced features |\n| `COOLIFY_MCP_TIMEOUT` | No | `30000` | API request timeout in milliseconds |\n| `COOLIFY_MCP_RETRIES` | No | `3` | Number of retry attempts for failed requests |\n\n## Available Tools\n\n### Core Tools (Standard Coolify)\n\n#### Servers\n| Tool | Description |\n|------|-------------|\n| `list_servers` | List all servers |\n| `get_server` | Get server details |\n| `get_server_resources` | Get resources on a server |\n| `get_server_domains` | Get domains for a server |\n| `validate_server` | Validate server connectivity |\n| `create_server` | Register a new server |\n| `update_server` | Update server settings |\n| `delete_server` | Delete a server |\n\n#### Projects & Environments\n| Tool | Description |\n|------|-------------|\n| `list_projects` | List all projects |\n| `get_project` | Get project details |\n| `create_project` | Create a project |\n| `update_project` | Update project settings |\n| `delete_project` | Delete a project |\n| `list_environments` | List environments in a project |\n| `get_environment` | Get environment details |\n| `create_environment` | Create an environment |\n| `delete_environment` | Delete an environment |\n\n#### Applications\n| Tool | Description |\n|------|-------------|\n| `list_applications` | List all applications |\n| `get_application` | Get application details |\n| `create_application` | Create from public git repo |\n| `update_application` | Update application settings |\n| `delete_application` | Delete an application |\n| `start_application` | Start/deploy |\n| `stop_application` | Stop |\n| `restart_application` | Restart |\n| `get_application_logs` | Get container logs |\n| `deploy` | Deploy by UUID or tag |\n\n#### Databases\n| Tool | Description |\n|------|-------------|\n| `list_databases` | List all databases |\n| `get_database` | Get database details |\n| `create_database` | Create (postgres, mysql, mariadb, mongodb, redis, clickhouse, dragonfly, keydb) |\n| `update_database` | Update settings |\n| `delete_database` | Delete with cleanup options |\n| `start_database` | Start |\n| `stop_database` | Stop |\n| `restart_database` | Restart |\n\n#### Services\n| Tool | Description |\n|------|-------------|\n| `list_services` | List all services |\n| `get_service` | Get service details |\n| `create_service` | Create one-click or compose service |\n| `update_service` | Update settings |\n| `delete_service` | Delete with cleanup options |\n| `start_service` | Start/deploy |\n| `stop_service` | Stop |\n| `restart_service` | Restart |\n\n#### Deployments\n| Tool | Description |\n|------|-------------|\n| `list_deployments` | List running deployments |\n| `get_deployment` | Get deployment details |\n| `cancel_deployment` | Cancel a deployment |\n| `list_app_deployments` | Deployment history for an app |\n\n#### Environment Variables\n| Tool | Description |\n|------|-------------|\n| `list_app_envs` / `list_service_envs` | List env vars |\n| `create_app_env` / `create_service_env` | Create env var |\n| `update_app_env` / `update_service_env` | Update env var |\n| `bulk_update_app_envs` / `bulk_update_service_envs` | Bulk update |\n| `delete_app_env` / `delete_service_env` | Delete env var |\n\n#### Database Backups\n| Tool | Description |\n|------|-------------|\n| `list_db_backups` | List backup configs |\n| `create_db_backup` | Create scheduled backup |\n| `update_db_backup` | Update backup config |\n| `delete_db_backup` | Delete backup config |\n| `list_db_backup_executions` | List execution history |\n\n#### Security & Teams\n| Tool | Description |\n|------|-------------|\n| `list_private_keys` | List SSH keys |\n| `get_private_key` | Get key details |\n| `create_private_key` | Store new SSH key |\n| `delete_private_key` | Delete SSH key |\n| `list_teams` | List teams |\n| `get_current_team` | Get current team |\n| `get_team_members` | Get team members |\n\n#### System\n| Tool | Description |\n|------|-------------|\n| `get_version` | Coolify version |\n| `health_check` | Health check |\n| `list_resources` | All resources |\n\n### Enhanced Tools (coolify-enhanced addon)\n\nThese tools are automatically available when the coolify-enhanced addon is detected.\n\n#### Granular Permissions\n| Tool | Description |\n|------|-------------|\n| `list_project_access` | List users with project access |\n| `grant_project_access` | Grant access with permission level |\n| `update_project_access` | Change permission level |\n| `revoke_project_access` | Revoke access |\n| `check_user_permission` | Check specific permission |\n\n#### Resource Backups\n| Tool | Description |\n|------|-------------|\n| `list_resource_backups` | List backup schedules |\n| `create_resource_backup` | Create volume/config/full backup |\n| `get_resource_backup` | Get schedule + executions |\n| `trigger_resource_backup` | Trigger immediate backup |\n| `delete_resource_backup` | Delete backup schedule |\n\n#### Custom Templates\n| Tool | Description |\n|------|-------------|\n| `list_template_sources` | List GitHub template sources |\n| `create_template_source` | Add template repository |\n| `get_template_source` | Get source details |\n| `update_template_source` | Update source settings |\n| `delete_template_source` | Remove template source |\n| `sync_template_source` | Sync from GitHub |\n| `sync_all_templates` | Sync all sources |\n\n#### Network Management\n| Tool | Description |\n|------|-------------|\n| `list_server_networks` | List managed networks |\n| `create_network` | Create shared network |\n| `get_network` | Get network details |\n| `delete_network` | Delete network |\n| `sync_networks` | Sync from Docker |\n| `migrate_proxy` | Proxy isolation migration |\n| `cleanup_proxy` | Cleanup old proxy networks |\n| `list_resource_networks` | Networks for a resource |\n| `attach_resource_network` | Attach to network |\n| `detach_resource_network` | Detach from network |\n\n## Development\n\n```bash\ncd mcp-server\nnpm install\nnpm run build\nnpm start\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}