get_deployment
Retrieve deployment details including status, configuration, and logs for a specific deployment UUID in Coolify self-hosted PaaS.
Instructions
Get deployment details
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uuid | Yes | Deployment UUID |
Implementation Reference
- src/tools/handlers.ts:427-429 (handler)The execution logic for the 'get_deployment' tool. It requires a 'uuid' parameter and fetches the deployment details from the Coolify API endpoint `/deployments/{uuid}` using the CoolifyClient.case 'get_deployment': requireParam(args, 'uuid'); return client.get(`/deployments/${args.uuid}`);
- src/tools/definitions.ts:609-617 (schema)The input schema and metadata definition for the 'get_deployment' tool, specifying that it requires a 'uuid' string parameter.name: 'get_deployment', description: 'Get deployment details', inputSchema: { type: 'object', properties: { uuid: { type: 'string', description: 'Deployment UUID' } }, required: ['uuid'] } },
- src/index.ts:36-38 (registration)Registration of all tools (including 'get_deployment') via the MCP server's listTools handler, which returns the tool definitions from getToolDefinitions().this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: getToolDefinitions() }));
- src/index.ts:41-67 (registration)The MCP server's callTool handler that dispatches to handleTool, which contains the switch case implementing 'get_deployment'.this.server.setRequestHandler(CallToolRequestSchema, async (request) => { if (!this.client) { throw new McpError(ErrorCode.InternalError, 'Client not initialized'); } const { name, arguments: args } = request.params; // Block write operations in read-only mode if (isReadOnlyMode() && !READ_ONLY_TOOLS.includes(name)) { throw new McpError( ErrorCode.InvalidRequest, `Operation '${name}' is not allowed in read-only mode. Set COOLIFY_READONLY=false to enable write operations.` ); } try { const result = await handleTool(this.client, name, args || {}); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }; } catch (error) { if (error instanceof McpError) throw error; const message = error instanceof Error ? error.message : 'Unknown error'; throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${message}`); } });