Coolify MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:359-360 (handler)

  The handler case in the main handleTool switch statement that executes the list_databases tool by making a GET request to the Coolify '/databases' API endpoint.

  case 'list_databases':
    return client.get('/databases');

• src/tools/definitions.ts:570-574 (schema)

  The tool schema definition including name, description, and input schema (empty object, no parameters required). This is used for MCP tool registration.

    name: 'list_databases',
    description: 'List all databases',
    inputSchema: { type: 'object', properties: {}, required: [] }
  },
  {

• src/tools/definitions.ts:4-42 (helper)

  list_databases is included in the READ_ONLY_TOOLS array, which determines if the tool is available in read-only mode.

  export const READ_ONLY_TOOLS = [
    'get_version',
    'health_check',
    'list_teams',
    'get_team',
    'get_current_team',
    'get_current_team_members',
    'get_team_members',
    'list_servers',
    'get_server',
    'get_server_resources',
    'get_server_domains',
    'list_projects',
    'get_project',
    'list_environments',
    'get_environment',
    'list_applications',
    'get_application',
    'get_application_logs',
    'get_application_envs',
    'get_application_deployments',
    'list_services',
    'get_service',
    'get_service_envs',
    'get_service_logs',
    'list_databases',
    'get_database',
    'get_database_backups',
    'get_database_logs',
    'list_deployments',
    'get_deployment',
    'list_private_keys',
    'get_private_key',
    'list_resources',
    'list_github_apps',
    'get_github_app',
    'get_github_app_repositories',
    'get_github_app_repository_branches'
  ];

• src/index.ts:36-38 (registration)

  The MCP server registers all tools dynamically using getToolDefinitions(), which includes the list_databases schema.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: getToolDefinitions()
  }));