ServGhost

List all VPS, dedicated, RDP or GPU plans with prices per location. RDP is only available in NL/RO/MD/RU. GPU is only available in IS/NL/RO/MD (Russia excluded due to NVIDIA export controls).

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "vps",
        "dedicated",
        "rdp",
        "gpu"
      ],
      "description": "vps, dedicated, rdp, or gpu"
    },
    "location": {
      "type": "string",
      "description": "optional location slug to filter (iceland, panama, moldova, romania, switzerland, netherlands, russia)"
    }
  }
}

List the 7 offshore jurisdictions ServGhost operates in, with privacy/legal features.

{
  "type": "object",
  "properties": {}
}

Calculate the final price (USD) for a plan + location + billing period, including discounts and any RAM / disk / extra-IP upgrades.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "vps",
        "dedicated",
        "rdp",
        "gpu"
      ]
    },
    "plan": {
      "type": "string",
      "description": "plan name (e.g. \"IS-S\", \"PA-M\", \"DS-1-CH\", \"NL-L\" for GPU H100)"
    },
    "location": {
      "type": "string"
    },
    "billing": {
      "type": "integer",
      "enum": [
        1,
        3,
        6,
        12
      ],
      "description": "months billed — 3/6/12 trigger 25/35/50% discounts."
    },
    "extra_ips": {
      "type": "integer",
      "default": 0
    },
    "ram_upgrade": {
      "type": "integer",
      "enum": [
        0,
        32,
        64,
        128,
        256
      ],
      "default": 0
    }
  },
  "required": [
    "type",
    "plan",
    "location",
    "billing"
  ]
}

Deploy a server from your USD balance. BALANCE-ONLY: you must topup_create first (min $30, see topup_bonus for free credit tiers), wait for the topup to confirm, then call this. If your balance is short, returns {insufficient_balance: true, topup_required: true, deficit_usd, topup: {suggested_usd, suggested_bonus, ...}} — call topup_create with that amount and retry. If no account_token is provided, a new account is created and the token is returned — STORE IT. Server is active immediately on success.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "vps",
        "dedicated",
        "rdp",
        "gpu"
      ]
    },
    "plan": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "os": {
      "type": "string",
      "default": "ubuntu-24",
      "description": "OS slug. RDP must use a win-* slug; GPU must use a Linux + CUDA slug like ubuntu-22-cuda, ubuntu-22-pytorch, ubuntu-22-comfyui, ubuntu-22-ollama."
    },
    "billing": {
      "type": "integer",
      "enum": [
        1,
        3,
        6,
        12
      ],
      "default": 1,
      "description": "months billed. 3/6/12 commits get 25/35/50% discount."
    },
    "extra_ips": {
      "type": "integer",
      "default": 0
    },
    "root_password": {
      "type": "string",
      "description": "optional initial root password"
    },
    "account_token": {
      "type": "string",
      "description": "optional Bearer token; if absent, a new account is created"
    },
    "dry_run": {
      "type": "boolean",
      "default": false,
      "description": "set true for a synthetic deploy preview — no balance debit, no provisioning"
    }
  },
  "required": [
    "type",
    "plan",
    "location"
  ]
}

Top up your USD balance with crypto. Minimum $30, maximum $2000 per top-up. Bonus credit is applied automatically on confirmation: $100 → +$25, $250 → +$75, $500 → +$200, $1000 → +$500, $1500 → +$1000, $2000 → +$2000 (linear interpolation between anchors, no bonus below $100). Call topup_bonus first to see the full tier table. Returns a payment_id, deposit address and amount_crypto — send it from your wallet, then poll payment_status(order_id=payment_id) until status=confirmed.

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "minimum": 30,
      "maximum": 2000,
      "description": "USD amount to top up (min 30, max 2000)"
    },
    "crypto": {
      "type": "string",
      "enum": [
        "BTC",
        "XMR",
        "ETH",
        "USDT",
        "USDTTRC",
        "LTC",
        "TRX",
        "SOL"
      ]
    },
    "account_token": {
      "type": "string",
      "description": "optional Bearer token; if absent, a new account is created and the token is returned (STORE IT)"
    },
    "dry_run": {
      "type": "boolean",
      "default": false,
      "description": "set true to preview the response without creating a real invoice"
    }
  },
  "required": [
    "amount",
    "crypto"
  ]
}

Return the bonus credit tiers applied to top-ups. Use this BEFORE topup_create so you can pick an amount that maximises free credit. No auth required.

{
  "type": "object",
  "properties": {}
}

Return the current USD balance for an account. Use this to decide whether you can call create_order or need to topup_create first.

{
  "type": "object",
  "properties": {
    "account_token": {
      "type": "string"
    }
  },
  "required": [
    "account_token"
  ]
}

Poll the status of a top-up (or legacy crypto-direct order). pending → confirmed (balance credited + bonus applied) for topups; pending → confirmed → active for legacy orders. After a topup confirms, call create_order to deploy.

{
  "type": "object",
  "properties": {
    "order_id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "payment_id returned by topup_create (or legacy create_order)"
    },
    "account_token": {
      "type": "string"
    },
    "dry_run": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "order_id",
    "account_token"
  ]
}

Fetch IP, root password and console URL for a server, once status is active.

{
  "type": "object",
  "properties": {
    "server_id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ]
    },
    "account_token": {
      "type": "string"
    },
    "dry_run": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "server_id",
    "account_token"
  ]
}

Send a lifecycle command to a server: reboot, shutdown, start, reinstall, or console_link.

{
  "type": "object",
  "properties": {
    "server_id": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ]
    },
    "action": {
      "type": "string",
      "enum": [
        "reboot",
        "shutdown",
        "start",
        "reinstall",
        "console_link"
      ]
    },
    "account_token": {
      "type": "string"
    }
  },
  "required": [
    "server_id",
    "action",
    "account_token"
  ]
}

Return the canonical 4-call recipe for buying a server, with examples. Call this first if you are unsure how to use the tools.

{
  "type": "object",
  "properties": {}
}