Using Suzko with Claude / Cursor / VS Code (MCP)

The Suzko MCP server lets Claude, Cursor, VS Code Copilot, and any other MCP-aware AI client manage your account directly. Provision services, register domains, deploy code, file tickets — without leaving your editor.

What it can do

• Deploy — list/create/control projects, set env vars
• Domains — search, register, transfer, manage DNS
• Billing — check balance, view invoices, view subscriptions
• Services — list, get details, generate SSO links
• Support — open tickets, reply to threads
• BYOS server admin — SSH-register your own server, install Docker, deploy containers, manage SSL, edit env files

Roughly 56 tools across those areas.

Install

npm install -g @suzko/mcp-server

Or run via npx:

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

Adjust path syntax for your MCP client's config:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
• Cursor: ~/.cursor/mcp.json
• VS Code (Continue extension): ~/.continue/config.json

Authenticate

First MCP request triggers OAuth. The AI client will surface a sign-in URL — open it in a browser, authorize Suzko MCP, return. Credentials cache at ~/.suzko/mcp-credentials.json.

Example interactions

"Suzko, list my deploy projects" Claude calls deploy_list_projects, shows you the list.

"Register example-app.com" Claude calls domain_search, shows availability, then domain_register after you confirm.

"Deploy this folder as a new project" Claude reads the folder, creates a Git repo on your behalf, creates a Deploy project pointing at it.

Approval for cost-bearing actions

Anything that costs money or has lasting consequences (register a domain, charge a card, terminate a service) requires explicit confirmation. The MCP returns an approval token; the AI must call the action again WITH the token. 5-minute expiry.

This protects you from "claude accidentally bought 47 domains while brainstorming."

Revoking access

/dashboard/profile → API Tokens shows every device + MCP that's authorized. Revoke kills the credentials immediately.

Where to file MCP-specific bugs

Open a ticket under Tools / Developer, mention "MCP server" in the subject.