@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:

Tool returns a cost preview with a confirmation token
AI presents the cost to the user
User approves → AI calls the confirm tool with the token
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

MCP Servers