# Dilmune Cloud Services (DCS)

> Dilmune Cloud (https://dilmune.com) is a cloud hosting platform for developers. Provision servers, deploy sites, manage databases, and run serverless functions — all from your AI assistant.

## What You Can Do

- **Servers**: Provision cloud servers on Hetzner, DigitalOcean, or Vultr. Install software (PHP, Node.js, Python, Go, Ruby, Docker, Redis, etc.), manage firewalls, cron jobs, and daemon processes.
- **Sites**: Deploy static sites, web apps (Next.js, Nuxt, Remix, Astro, Laravel, etc.), or WordPress from a Git repo. Auto-deploy on push, rollback to previous deployments, manage environment variables, custom domains, and SSL certificates.
- **Databases**: Create and manage PostgreSQL and MySQL databases. Execute SQL queries, inspect schemas, create and restore backups.
- **Serverless Functions**: Deploy JavaScript/TypeScript/WASM functions with inline code or from a Git repo. Invoke them, view metrics (latency, error rate, cold starts), and check logs.
- **Monitoring**: View real-time server metrics (CPU, memory, disk, network), set up alert rules, and retrieve logs.
- **Dashboard**: Get an overview of all your resources, system health, and recent activity.

## Connect Your AI Assistant

DCS provides an MCP (Model Context Protocol) server that lets AI assistants manage your cloud infrastructure directly.

**MCP Endpoint**: `https://mcp.dilmune.com/mcp`
**Auth**: OAuth 2.1 (you'll be prompted to log in with your DCS account)
**Protocol**: MCP 2024-11-05 (Streamable HTTP transport)

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "dilmune-cloud": {
      "url": "https://mcp.dilmune.com/mcp"
    }
  }
}
```

### Claude Code (CLI)

Run:
```
claude mcp add dilmune-cloud --transport http https://mcp.dilmune.com/mcp
```

### Cursor

Add to `.cursor/mcp.json` in your project:
```json
{
  "mcpServers": {
    "dilmune-cloud": {
      "url": "https://mcp.dilmune.com/mcp"
    }
  }
}
```

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:
```json
{
  "mcpServers": {
    "dilmune-cloud": {
      "url": "https://mcp.dilmune.com/mcp"
    }
  }
}
```

## Example Prompts

Once connected, try:

- "Create a server on Hetzner in Germany with Node.js and PostgreSQL"
- "Deploy my Next.js app from github.com/user/repo to my server"
- "Create a PostgreSQL database and show me the schema"
- "Set up a cron job to back up my database every night at 2am"
- "Check my server's CPU and memory usage"
- "Create a serverless function that returns the current time"
- "Roll back my site to the previous deployment"
- "Add a custom domain and enable SSL for my site"
- "Show me my recent activity across all resources"

## Available Tools (64 total)

### Servers (6 tools)
list_servers, get_server, create_server, delete_server, reboot_server, get_server_events

### SSH Keys (3 tools)
list_ssh_keys, create_ssh_key, delete_ssh_key

### Databases (9 tools)
list_databases, get_database, create_database, delete_database, get_database_schema, execute_query, create_backup, list_backups, restore_backup

### Sites & Deployments (17 tools)
list_sites, get_site, create_site, update_site, delete_site, deploy_site, list_deployments, rollback_deployment, get_build_logs, list_domains, add_domain, get_env_vars, update_env_vars, enable_ssl, run_site_command, list_site_commands, get_site_command

### Software (2 tools)
install_software, uninstall_software

### Cron Jobs (3 tools)
list_cron_jobs, create_cron_job, delete_cron_job

### Daemons (3 tools)
list_daemons, create_daemon, control_daemon

### Firewall (4 tools)
get_firewall, create_firewall_rule, delete_firewall_rule, toggle_firewall

### Monitoring (5 tools)
get_server_metrics, list_alerts, create_alert_rule, get_resource_status, get_logs

### Serverless Functions (9 tools)
list_functions, get_function, create_function, delete_function, deploy_function, invoke_function, rollback_function, get_function_metrics, get_function_logs

### Dashboard (3 tools)
get_dashboard_stats, get_dashboard_health, get_activity_log

## Full API Reference

For complete tool parameters and schemas, see: https://dilmune.com/llms-full.txt

## Links

- Website: https://dilmune.com
- Dashboard: https://cloud.dilmune.com
- API Docs: https://docs.dilmune.com
- Blog: https://blog.dilmune.com