Coolify MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:157-165 (handler)

  Handler implementation for the create_public_application tool. Validates required parameters and delegates to CoolifyClient POST /applications/public.

  case 'create_public_application':
    requireParam(args, 'project_uuid');
    requireParam(args, 'environment_name');
    requireParam(args, 'server_uuid');
    requireParam(args, 'git_repository');
    requireParam(args, 'git_branch');
    requireParam(args, 'build_pack');
    requireParam(args, 'ports_exposes');
    return client.post('/applications/public', args);

• src/tools/definitions.ts:285-306 (schema)

  JSON schema definition for the input parameters of the create_public_application tool.

  {
    name: 'create_public_application',
    description: 'Create a new public application from a public Git repository',
    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)' },
        git_repository: { type: 'string', description: 'Public Git repository URL' },
        git_branch: { type: 'string', description: 'Git branch name' },
        build_pack: { type: 'string', description: 'Build pack type (nixpacks, dockerfile, dockercompose)' },
        ports_exposes: { type: 'string', description: 'Ports to expose (e.g., "3000,8080")' },
        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', 'git_repository', 'git_branch', 'build_pack', 'ports_exposes']
    }
  },