@suzko/mcp-server

AI-powered infrastructure management for VS Code, Claude, and Cursor.

Quick Start

VS Code (Copilot agent mode)

Add to your settings.json:

{
  "mcp": {
    "servers": {
      "suzko": {
        "command": "npx",
        "args": ["-y", "@suzko/mcp-server"],
        "env": {
          "SUZKO_API_BASE": "https://www.suzko.com"
        }
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "suzko": {
      "command": "npx",
      "args": ["-y", "@suzko/mcp-server"]
    }
  }
}

Claude Code CLI

claude mcp add suzko -- npx -y @suzko/mcp-server

Authentication

# Login (opens browser)
npx @suzko/mcp-server auth login

# Check status
npx @suzko/mcp-server auth status

# Logout
npx @suzko/mcp-server auth logout

Credentials are stored in ~/.suzko/mcp-credentials.json.

Tools

Deploy (12 tools)

• list_deploy_templates — Browse available service templates
• list_deploy_projects — List your deployed projects
• create_deploy_project — Create a new project (with cost confirmation)
• confirm_deploy_project — Confirm project creation
• get_deploy_project — Project details and status
• control_deploy_project — Start/stop/restart/delete
• get_deploy_logs — Runtime logs
• get_deploy_build_logs — Build output
• redeploy_project — Trigger redeployment
• set_deploy_env — Set environment variables
• check_subdomain — Check subdomain availability
• get_deploy_usage — Usage stats and billing

Domains (12 tools)

• search_domains — Check domain availability
• get_tld_pricing — TLD pricing table
• suggest_domain_names — AI domain name suggestions
• register_domain / confirm_domain_registration — Register with confirmation
• transfer_domain / confirm_domain_transfer — Transfer with confirmation
• list_domains — Your owned domains
• get_domain_details — Full domain info
• update_domain_nameservers — Update NS records
• get_domain_lock_status / toggle_domain_lock — Lock management

DNS (5 tools)

• enable_dns_management — Enable DNS for a domain
• list_dns_records — List all records
• create_dns_record — Create A/AAAA/CNAME/TXT/MX/NS/SRV/CAA
• update_dns_record — Update records
• delete_dns_record — Delete records

Account & Billing (7 tools)

• get_account_info — Profile and account details
• list_invoices / get_invoice — Billing history
• list_subscriptions — Active subscriptions
• check_perks — Feature access
• list_orders — Order history
• get_account_balance — Credit balance

Services (4 tools)

• list_services — WHMCS hosting services
• get_service_details — Service configuration
• get_service_sso_url — Control panel SSO link
• upgrade_service — Upgrade guidance

Support (5 tools)

• list_tickets / get_ticket — Ticket management
• open_support_ticket — Create tickets
• reply_to_ticket — Reply to tickets
• close_ticket — Close tickets

BYOS Server Admin (12 tools)

• connect_server — Register a server via SSH
• list_servers — List registered servers
• inspect_server — System diagnostics
• run_server_command — Execute commands (with safety checks)
• install_docker — Install Docker
• deploy_to_server — Deploy via SCP + docker-compose
• list_server_containers / manage_server_container — Docker management
• setup_ssl — SSL certificate setup
• get_server_status — System status
• get_server_logs — Log reading
• manage_env_file — .env file management

Resources

The server exposes read-only resources via suzko:// URIs:

• suzko://services — Active hosting services
• suzko://deploy/projects — Deploy projects
• suzko://domains — Registered domains
• suzko://invoices — Billing history
• suzko://perks — Subscription perks

Prompts

Pre-built workflow templates:

• deploy-app — Deploy an application
• find-domain — Search and register domains
• troubleshoot-service — Diagnose service issues
• setup-server — Set up a new server (BYOS)

Human-in-the-Loop

Tools that create resources or cost money use a two-step confirmation:

1. Tool returns a cost preview with a confirmation token
2. AI presents the cost to the user
3. User approves → AI calls the confirm tool with the token
4. Action is executed

Confirmation tokens expire after 5 minutes and are single-use.

Environment Variables

Variable	Default	Description
SUZKO_API_BASE	https://www.suzko.com	API base URL

Development

cd packages/mcp-server
bun install
bun run build    # Compile TypeScript
bun run dev      # Watch mode