create_dockercompose_application
Deploy applications using Docker Compose configurations in Coolify's self-hosted PaaS environment by specifying project, environment, server, and compose YAML content.
Instructions
Create a new application from Docker Compose configuration
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_uuid | Yes | Project UUID | |
| environment_name | Yes | Environment name | |
| environment_uuid | No | Environment UUID (optional) | |
| server_uuid | Yes | Server UUID | |
| destination_uuid | No | Destination UUID (optional if server has single destination) | |
| docker_compose_raw | Yes | Docker Compose YAML content (base64 encoded) | |
| name | No | Application name (optional, auto-generated if not provided) | |
| description | No | Application description | |
| instant_deploy | No | Deploy immediately after creation |
Implementation Reference
- src/tools/handlers.ts:206-211 (handler)Handler implementation for the create_dockercompose_application tool. Validates required parameters (project_uuid, environment_name, server_uuid, docker_compose_raw) and sends a POST request to the Coolify API endpoint '/applications/dockercompose' with the arguments.case 'create_dockercompose_application': requireParam(args, 'project_uuid'); requireParam(args, 'environment_name'); requireParam(args, 'server_uuid'); requireParam(args, 'docker_compose_raw'); return client.post('/applications/dockercompose', args);
- src/tools/definitions.ts:394-412 (schema)Tool schema definition including name, description, and inputSchema with properties and required fields for validating inputs to create_dockercompose_application.{ name: 'create_dockercompose_application', description: 'Create a new application from Docker Compose configuration', inputSchema: { type: 'object', properties: { project_uuid: { type: 'string', description: 'Project UUID' }, environment_name: { type: 'string', description: 'Environment name' }, environment_uuid: { type: 'string', description: 'Environment UUID (optional)' }, server_uuid: { type: 'string', description: 'Server UUID' }, destination_uuid: { type: 'string', description: 'Destination UUID (optional if server has single destination)' }, docker_compose_raw: { type: 'string', description: 'Docker Compose YAML content (base64 encoded)' }, name: { type: 'string', description: 'Application name (optional, auto-generated if not provided)' }, description: { type: 'string', description: 'Application description' }, instant_deploy: { type: 'boolean', description: 'Deploy immediately after creation', default: false } }, required: ['project_uuid', 'environment_name', 'server_uuid', 'docker_compose_raw'] } },
- src/index.ts:36-38 (registration)Registration of all tools via getToolDefinitions() which includes create_dockercompose_application in the MCP server's listTools handler.this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: getToolDefinitions() }));