Sitequest MCP Server

A remote Model Context Protocol (MCP) server for managing VPS servers and domains on Sitequest. Lets AI assistants provision, monitor, and configure infrastructure through natural language.

Features

• VPS Management -- List, create, monitor, power control, OS reinstall, resize
• SSH & File Operations -- Execute commands, read/write files, manage SSH security
• Firewall & Backups -- Configure firewall rules, create/restore/delete backups
• Domain Management -- Register, transfer, configure DNS records, WHOIS privacy, DNSSEC
• Billing Integration -- Provision resources with automatic payment via saved mandate
• Scope-Based Access -- Fine-grained API key permissions per tool category

Quickstart

1. Get an API Key

Create an API key in the Sitequest Dashboard with the scopes you need.

2. Connect Your Client

VS Code / GitHub Copilot -- Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "sitequest": {
      "type": "http",
      "url": "https://hosting.site.quest/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sitequest-api-key}"
      }
    }
  },
  "inputs": [
    {
      "id": "sitequest-api-key",
      "type": "promptString",
      "description": "Sitequest API key",
      "password": true
    }
  ]
}

Claude Desktop -- Add to claude_desktop_config.json:

{
  "mcpServers": {
    "sitequest": {
      "type": "streamableHttp",
      "url": "https://hosting.site.quest/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor -- Add to MCP settings:

{
  "mcpServers": {
    "sitequest": {
      "url": "https://hosting.site.quest/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

See examples/ for more client configurations.

Endpoint

URL	POST https://hosting.site.quest/mcp
Transport	Streamable HTTP (stateless)
Protocol	JSON-RPC 2.0 / MCP 2025-03-26
Auth	Authorization: Bearer <api-key>

Available Tools

Pricing (no scope required)

Tool	Description
get_domain_pricing	List TLD pricing or check a specific domain's price
check_domain	Check domain availability (single or batch, up to 20 TLDs)
get_vps_pricing	Get VPS component pricing per hostsystem

VPS

Tool	Scope	Description
list_vms	vps:read	List all VPS with status, specs, and usage metrics
get_vm	vps:read	Detailed VPS info with live config and status
get_vm_monitoring	vps:read	CPU/memory/ping history and downtime stats
get_vm_traffic	vps:read	Current-month bandwidth and daily traffic log
vm_power	vps:manage	Start, stop, or restart a VPS
vm_reinstall_os	vps:manage	Reinstall OS (destructive, requires confirm)
vm_mount_iso	vps:manage	Mount or unmount an ISO image
vm_reset_password	vps:manage	Generate new root password (requires confirm)
rename_vm	vps:manage	Update display name
exec_command	vps:manage	Execute a one-shot SSH command
list_files	vps:manage	List directory contents via SFTP
read_file	vps:manage	Read file content via SFTP (max 10 MB)
write_file	vps:manage	Write file content via SFTP (max 10 MB)
ssh_security	vps:manage	Get/set SSH security settings with rescue fallback
list_backups	vps:manage	List all backups for a VPS
create_backup	vps:manage	Create a new backup (requires confirm)
restore_backup	vps:manage	Restore from backup (destructive, requires confirm)
delete_backup	vps:manage	Delete a backup (requires confirm)
get_firewall	vps:manage	Get firewall status and rules
manage_firewall	vps:manage	Add/remove rules, enable/disable firewall
create_vm	vps:provision	Create new VPS (charges saved mandate, requires confirm)
cancel_vm	vps:provision	Cancel VPS subscription at end of billing period
uncancel_vm	vps:provision	Reactivate a cancelled VPS before expiry
upgrade_vm	vps:provision	Upgrade resources with pro-rated charge (requires confirm)

Domains

Tool	Scope	Description
list_domains	domains:read	List all domains with status, DNS count, expiry
get_domain	domains:read	Detailed domain info with DNS records and registrar data
list_dns_records	domains:read	List DNS records for a domain
add_dns_record	domains:manage	Create a DNS record (A, AAAA, CNAME, MX, TXT, SRV, etc.)
edit_dns_record	domains:manage	Update an existing DNS record
delete_dns_record	domains:manage	Remove a DNS record (requires confirm)
set_nameservers	domains:manage	Update domain nameservers
set_transfer_lock	domains:manage	Enable or disable transfer lock
set_whois_privacy	domains:manage	Enable or disable WHOIS privacy
set_dnssec	domains:manage	Enable or disable DNSSEC
get_authcode	domains:manage	Retrieve domain auth code for transfer
register_domain	domains:provision	Register new domain (charges mandate, requires confirm)
transfer_domain	domains:provision	Transfer domain to Sitequest (requires auth code + confirm)
cancel_domain	domains:provision	Cancel domain at end of billing period
uncancel_domain	domains:provision	Reactivate a cancelled domain before expiry

Orders

Tool	Scope	Description
get_order_status	vps:provision or domains:provision	Track order by ID or token

Scopes

API keys use granular scopes to control access:

Scope	Access
vps:read	View VPS instances and metrics
vps:manage	Power control, SSH, files, backups, firewall
vps:provision	Create, upgrade, cancel VPS
domains:read	View domains and DNS records
domains:manage	Edit DNS, nameservers, WHOIS, DNSSEC
domains:provision	Register, transfer, cancel domains

Keys can also be restricted to specific VPS or domain IDs for narrower access.

Rate Limits

60 requests per minute per API key. Rate limit headers are included in every response:

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset

Safety

All destructive operations (reinstall OS, delete backups, register/cancel domains, etc.) require an explicit confirm: true parameter. The server will not execute them without confirmation.

Documentation

Full documentation: site.quest/docs/api/mcp

License

MIT