get_application_deployments

Retrieve deployment history for a specific application using its UUID to monitor and manage deployment status within Coolify's self-hosted PaaS environment.

Instructions

Get all deployments for an application

Input Schema

TableJSON Schema

Name	Required	Description	Default
`uuid`	Yes	Application UUID

Implementation Reference

src/tools/handlers.ts:435-437 (handler)
The core handler logic for the 'get_application_deployments' tool. It requires an 'uuid' parameter (application UUID) and makes a GET request to the Coolify API endpoint `/deployments/applications/${uuid}` to retrieve the deployments.
```
case 'get_application_deployments':
  requireParam(args, 'uuid');
  return client.get(`/deployments/applications/${args.uuid}`);
```

src/tools/definitions.ts:1166-1173 (schema)

The JSON schema definition for the tool, specifying the input parameters: an object with a required 'uuid' string (Application UUID).

  name: 'get_application_deployments',
  description: 'Get all deployments for an application',
  inputSchema: {
    type: 'object',
    properties: { uuid: { type: 'string', description: 'Application UUID' } },
    required: ['uuid']
  }
},

src/index.ts:36-38 (registration)
The MCP server registration where all tools, including 'get_application_deployments', are listed via getToolDefinitions(). This responds to ListTools requests.
```
this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: getToolDefinitions()
}));
```

src/tools/handlers.ts:429-502 (registration)

The handleTool function exports the dispatcher switch that routes to the specific handler case for this tool. (Note: full function spans larger, but captures the dispatch context.)

      return client.get(`/deployments/${args.uuid}`);

    case 'cancel_deployment':
      requireParam(args, 'uuid');
      return client.post(`/deployments/${args.uuid}/cancel`);

    case 'get_application_deployments':
      requireParam(args, 'uuid');
      return client.get(`/deployments/applications/${args.uuid}`);

    // Private Keys
    case 'list_private_keys':
      return client.get('/security/keys');

    case 'create_private_key':
      requireParam(args, 'name');
      requireParam(args, 'private_key');
      return client.post('/security/keys', args);

    case 'get_private_key':
      requireParam(args, 'uuid');
      return client.get(`/security/keys/${args.uuid}`);

    case 'update_private_key':
      requireParam(args, 'uuid');
      return client.patch(`/security/keys/${args.uuid}`, args);

    case 'delete_private_key':
      requireParam(args, 'uuid');
      return client.delete(`/security/keys/${args.uuid}`);

    // GitHub Apps
    case 'list_github_apps':
      return client.get('/github-apps');

    case 'create_github_app':
      requireParam(args, 'name');
      return client.post('/github-apps', args);

    case 'get_github_app':
      requireParam(args, 'github_app_id');
      return client.get(`/github-apps/${args.github_app_id}`);

    case 'update_github_app':
      requireParam(args, 'github_app_id');
      return client.patch(`/github-apps/${args.github_app_id}`, args);

    case 'delete_github_app':
      requireParam(args, 'github_app_id');
      return client.delete(`/github-apps/${args.github_app_id}`);

    case 'get_github_app_repositories':
      requireParam(args, 'github_app_id');
      return client.get(`/github-apps/${args.github_app_id}/repositories`);

    case 'get_github_app_repository_branches':
      requireParam(args, 'github_app_id');
      requireParam(args, 'owner');
      requireParam(args, 'repo');
      return client.get(`/github-apps/${args.github_app_id}/repositories/${args.owner}/${args.repo}/branches`);

    // Resources
    case 'list_resources':
      return client.get('/resources');

    // Teams
    case 'get_team_members':
      requireParam(args, 'team_id');
      return client.get(`/teams/${args.team_id}/members`);

    default:
      throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
  }
}

src/tools/definitions.ts:24-24 (registration)
Included in READ_ONLY_TOOLS array, ensuring it's available even in read-only mode.
```
'get_application_deployments',
```

Coolify MCP Server