# Suzko Ops Mcp Server

> MCP server from suzko-ops/mcp-server.

- **Type:** MCP server
- **Install:** `agentstack add mcp-suzko-ops-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [suzko-ops](https://agentstack.voostack.com/s/suzko-ops)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [suzko-ops](https://github.com/suzko-ops)
- **Source:** https://github.com/suzko-ops/mcp-server

## Install

```sh
agentstack add mcp-suzko-ops-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

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

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

### Claude Code CLI

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

## Authentication

```bash
# 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

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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [suzko-ops](https://github.com/suzko-ops)
- **Source:** [suzko-ops/mcp-server](https://github.com/suzko-ops/mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-suzko-ops-mcp-server
- Seller: https://agentstack.voostack.com/s/suzko-ops
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.