NodeRings is an MCP server published by com.noderings, hosted at mcp.noderings.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 53 tools, including add_reserved_ip, create_dns_zone, create_network, create_plan, create_prefix.
Search hosting plans and manage VMs, one-click apps and GeoDNS on the NodeRings marketplace
1 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Reserve one address inside an existing prefix.
| Parameter | Type | Description |
|---|---|---|
| prefix_id * | string | Prefix UUID from list_prefixes |
| ip_address * | string | Address inside the prefix CIDR |
{
"name": "add_reserved_ip",
"description": "Reserve one address inside an existing prefix.",
"inputSchema": {
"type": "object",
"required": [
"prefix_id",
"ip_address"
],
"properties": {
"prefix_id": {
"type": "string",
"description": "Prefix UUID from list_prefixes"
},
"ip_address": {
"type": "string",
"description": "Address inside the prefix CIDR"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"success": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Create a blank DNS zone for an apex domain. Use the returned id with upsert_dns_record. Does not import existing records. The zone stays pending until the registrar delegates the domain to the returned nameservers. Fails with already_exists if the domain is already hosted (use list_dns_zones) and when the zone quota is reached.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Apex domain to host |
{
"name": "create_dns_zone",
"description": "Create a blank DNS zone for an apex domain. Use the returned id with upsert_dns_record. Does not import existing records. The zone stays pending until the registrar delegates the domain to the returned nameservers. Fails with already_exists if the domain is already hosted (use list_dns_zones) and when the zone quota is reached.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Apex domain to host"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
},
"nameservers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Create an IPAM network. This does not allocate addresses.
| Parameter | Type | Description |
|---|---|---|
| name | string | Network name |
| description | string | Network description |
| dns_servers | array | DNS server IP addresses |
| mac_address_prefix | string | First three MAC octets |
{
"name": "create_network",
"description": "Create an IPAM network. This does not allocate addresses.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"name": {
"type": "string",
"description": "Network name"
},
"description": {
"type": "string",
"description": "Network description"
},
"dns_servers": {
"type": "array",
"items": {
"type": "string"
},
"description": "DNS server IP addresses"
},
"mac_address_prefix": {
"type": "string",
"description": "First three MAC octets"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"success": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Clone a template plan into one region on the given nodes. Prices, CPU limits, and credit policy stay on the template. Returns success only; call list_preflight_checks to find the new plan.
| Parameter | Type | Description |
|---|---|---|
| plan_id * | string | Template plan UUID from list_template_plans |
| currency * | string | ISO 4217 currency code. Must match the template currency from list_template_plans |
| node_ids * | array | Node UUIDs from list_nodes. At least one |
| region_id * | string | Region UUID from list_regions |
{
"name": "create_plan",
"description": "Clone a template plan into one region on the given nodes. Prices, CPU limits, and credit policy stay on the template. Returns success only; call list_preflight_checks to find the new plan.",
"inputSchema": {
"type": "object",
"required": [
"plan_id",
"region_id",
"node_ids",
"currency"
],
"properties": {
"plan_id": {
"type": "string",
"description": "Template plan UUID from list_template_plans"
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code. Must match the template currency from list_template_plans"
},
"node_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Node UUIDs from list_nodes. At least one"
},
"region_id": {
"type": "string",
"description": "Region UUID from list_regions"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"success": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Create an IPAM prefix on an existing network. Gateway and reserved addresses must sit inside the CIDR.
| Parameter | Type | Description |
|---|---|---|
| cidr * | string | Prefix in CIDR notation |
| gateway | string | Gateway address inside the CIDR |
| network_id * | string | Network UUID from list_networks |
| description | string | Prefix description |
| reserved_ips | array | Addresses inside the CIDR to reserve |
| allocation_strategy | string | ALLOCATION_STRATEGY_SEQUENTIAL |
| vm_assignment_prefix_length | integer | Required for IPv6. Assignment prefix length |
{
"name": "create_prefix",
"description": "Create an IPAM prefix on an existing network. Gateway and reserved addresses must sit inside the CIDR.",
"inputSchema": {
"type": "object",
"required": [
"network_id",
"cidr"
],
"properties": {
"cidr": {
"type": "string",
"description": "Prefix in CIDR notation"
},
"gateway": {
"type": "string",
"description": "Gateway address inside the CIDR"
},
"network_id": {
"type": "string",
"description": "Network UUID from list_networks"
},
"description": {
"type": "string",
"description": "Prefix description"
},
"reserved_ips": {
"type": "array",
"items": {
"type": "string"
},
"description": "Addresses inside the CIDR to reserve"
},
"allocation_strategy": {
"type": "string",
"description": "ALLOCATION_STRATEGY_SEQUENTIAL"
},
"vm_assignment_prefix_length": {
"type": "integer",
"description": "Required for IPv6. Assignment prefix length"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"success": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Create a snapshot of a virtual machine.
| Parameter | Type | Description |
|---|---|---|
| vm_id * | string | Virtual machine UUID |
| description | string | Optional snapshot description |
{
"name": "create_snapshot",
"description": "Create a snapshot of a virtual machine.",
"inputSchema": {
"type": "object",
"required": [
"vm_id"
],
"properties": {
"vm_id": {
"type": "string",
"description": "Virtual machine UUID"
},
"description": {
"type": "string",
"description": "Optional snapshot description"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"success": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Create a support ticket.
| Parameter | Type | Description |
|---|---|---|
| title * | string | Ticket title (10-255 characters) |
| message * | string | Ticket message (10-16384 characters) |
{
"name": "create_ticket",
"description": "Create a support ticket.",
"inputSchema": {
"type": "object",
"required": [
"title",
"message"
],
"properties": {
"title": {
"type": "string",
"description": "Ticket title (10-255 characters)"
},
"message": {
"type": "string",
"description": "Ticket message (10-16384 characters)"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
},
"subject": {
"type": "string"
},
"priority": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Create a virtual machine using SSH keys (no passwords).
| Parameter | Type | Description |
|---|---|---|
| distro * | string | Distro enum name from list_distros |
| plan_id * | string | Marketplace plan UUID from list_marketplace_offerings |
| hostname * | string | Virtual machine hostname |
| region_id * | string | Region UUID from list_marketplace_offerings or get_marketplace_plan |
| ssh_key_ids * | array | SSH key UUIDs from list_ssh_keys; passwords are not accepted |
{
"name": "create_virtual_machine",
"description": "Create a virtual machine using SSH keys (no passwords).",
"inputSchema": {
"type": "object",
"required": [
"hostname",
"plan_id",
"region_id",
"distro",
"ssh_key_ids"
],
"properties": {
"distro": {
"type": "string",
"description": "Distro enum name from list_distros"
},
"plan_id": {
"type": "string",
"description": "Marketplace plan UUID from list_marketplace_offerings"
},
"hostname": {
"type": "string",
"description": "Virtual machine hostname"
},
"region_id": {
"type": "string",
"description": "Region UUID from list_marketplace_offerings or get_marketplace_plan"
},
"ssh_key_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "SSH key UUIDs from list_ssh_keys; passwords are not accepted"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"success": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Record a VM template that already exists on a node. template_id is the hypervisor template id, not a value to invent. cloud_init_template_id must already exist.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Template name |
| distro * | string | Distro enum name from list_distros |
| node_id * | string | Node UUID from list_nodes |
| template_id * | integer | Hypervisor template id already present on the node. Proxmox ids start at 100 |
| cloud_init_template_id * | string | UUID of a Cloud-Init template that already exists. This tool does not create Cloud-Init scripts |
{
"name": "create_vm_template",
"description": "Record a VM template that already exists on a node. template_id is the hypervisor template id, not a value to invent. cloud_init_template_id must already exist.",
"inputSchema": {
"type": "object",
"required": [
"name",
"distro",
"template_id",
"node_id",
"cloud_init_template_id"
],
"properties": {
"name": {
"type": "string",
"description": "Template name"
},
"distro": {
"type": "string",
"description": "Distro enum name from list_distros"
},
"node_id": {
"type": "string",
"description": "Node UUID from list_nodes"
},
"template_id": {
"type": "integer",
"description": "Hypervisor template id already present on the node. Proxmox ids start at 100"
},
"cloud_init_template_id": {
"type": "string",
"description": "UUID of a Cloud-Init template that already exists. This tool does not create Cloud-Init scripts"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"success": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Permanently delete a virtual machine. Removes the VM, its snapshots, and its backups, and releases its addresses. If this was the last VM on its subscription, that subscription is cancelled immediately and a final hourly usage charge is recorded. Call only when the user explicitly asked to delete this VM.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Virtual machine UUID from list_virtual_machines or get_virtual_machine |
{
"name": "delete_virtual_machine",
"description": "Permanently delete a virtual machine. Removes the VM, its snapshots, and its backups, and releases its addresses. If this was the last VM on its subscription, that subscription is cancelled immediately and a final hourly usage charge is recorded. Call only when the user explicitly asked to delete this VM.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Virtual machine UUID from list_virtual_machines or get_virtual_machine"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"success": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Get a provider agent by UUID. Does not return peering configuration or error text.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Resource UUID |
{
"name": "get_agent",
"description": "Get a provider agent by UUID. Does not return peering configuration or error text.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Resource UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
},
"public_ip": {
"type": "string"
},
"provisioned": {
"type": "boolean"
},
"gateway_region": {
"type": "string"
},
"hypervisor_driver": {
"type": "string"
},
"inbound_peering_state": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Summarize the provider fleet: active VMs, customers, nodes, tickets, and region and plan breakdowns.
No parameters.
{
"name": "get_dashboard_summary",
"description": "Summarize the provider fleet: active VMs, customers, nodes, tickets, and region and plan breakdowns.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"tickets": {
"type": "object",
"properties": {
"open_last_7d": {
"type": "integer"
},
"total_in_window": {
"type": "integer"
},
"escalated_last_7d": {
"type": "integer"
},
"sla_first_response_breaches": {
"type": "integer"
},
"open_needing_provider_first_response_last_7d": {
"type": "integer"
}
},
"additionalProperties": false
},
"by_region": {
"type": "array",
"items": {
"type": "object",
"properties": {
"region_id": {
"type": "string"
},
"node_count": {
"type": "integer"
},
"region_label": {
"type": "string"
},
"active_vm_count": {
"type": "integer"
},
"active_customer_count": {
"type": "integer"
}
},
"additionalProperties": false
}
},
"node_total": {
"type": "integer"
},
"plan_breakdown": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"plan_id": {
"type": "string"
},
"active_subscription_count": {
"type": "integer"
}
},
"additionalProperties": false
}
},
"active_vm_total": {
"type": "integer"
},
"active_customer_total": {
"type": "integer"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get a DNS zone by UUID.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Resource UUID |
{
"name": "get_dns_zone",
"description": "Get a DNS zone by UUID.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Resource UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
},
"nameservers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get a firewall rule set by UUID.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Resource UUID |
{
"name": "get_firewall_ruleset",
"description": "Get a firewall rule set by UUID.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Resource UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get the authenticated Noderings identity (service account).
No parameters.
{
"name": "get_identity",
"description": "Get the authenticated Noderings identity (service account).",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"user_id": {
"type": "string"
},
"organization_id": {
"type": "string"
},
"organization_type": {
"type": "string"
},
"is_service_account": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get a marketplace plan by UUID with the regions it can be deployed in (region_id values for create_virtual_machine).
| Parameter | Type | Description |
|---|---|---|
| plan_id * | string | Marketplace plan UUID (the id from list_marketplace_offerings) |
{
"name": "get_marketplace_plan",
"description": "Get a marketplace plan by UUID with the regions it can be deployed in (region_id values for create_virtual_machine).",
"inputSchema": {
"type": "object",
"required": [
"plan_id"
],
"properties": {
"plan_id": {
"type": "string",
"description": "Marketplace plan UUID (the id from list_marketplace_offerings)"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"code": {
"type": "string"
},
"vcpus": {
"type": "integer"
},
"ram_gb": {
"type": "integer"
},
"disk_gb": {
"type": "integer"
},
"regions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"country": {
"type": "string"
},
"region_id": {
"type": "string"
}
},
"additionalProperties": false
}
},
"provider": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get a provider node by UUID.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Resource UUID |
{
"name": "get_node",
"description": "Get a provider node by UUID.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Resource UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get the node placement policy. Read this before update_node_placement_policy; that call replaces the whole policy.
No parameters.
{
"name": "get_node_placement_policy",
"description": "Get the node placement policy. Read this before update_node_placement_policy; that call replaces the whole policy.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"default_strategy": {
"type": "string"
},
"region_overrides": {
"type": "array",
"items": {
"type": "object",
"properties": {
"strategy": {
"type": "string"
},
"region_id": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get an organization by UUID.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Resource UUID |
{
"name": "get_organization",
"description": "Get an organization by UUID.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Resource UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"type": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get a platform by UUID. Includes driver, service status, and endpoint URL.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Resource UUID |
{
"name": "get_platform",
"description": "Get a platform by UUID. Includes driver, service status, and endpoint URL.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Resource UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"driver": {
"type": "string"
},
"endpoint_url": {
"type": "string"
},
"service_status": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get address utilization for one prefix.
| Parameter | Type | Description |
|---|---|---|
| prefix_id * | string | Prefix UUID from list_prefixes |
{
"name": "get_prefix_utilization",
"description": "Get address utilization for one prefix.",
"inputSchema": {
"type": "object",
"required": [
"prefix_id"
],
"properties": {
"prefix_id": {
"type": "string",
"description": "Prefix UUID from list_prefixes"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"total_ips": {
"type": "integer"
},
"reserved_count": {
"type": "integer"
},
"allocated_count": {
"type": "integer"
},
"available_count": {
"type": "integer"
},
"capacity_unit_label": {
"type": "string"
},
"utilization_percent": {
"type": "number"
},
"capacity_is_open_ended": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get one customer organization by UUID. Does not include payment details or billing amounts.
| Parameter | Type | Description |
|---|---|---|
| client_organization_id * | string | Customer organization UUID from list_provider_customers |
{
"name": "get_provider_customer",
"description": "Get one customer organization by UUID. Does not include payment details or billing amounts.",
"inputSchema": {
"type": "object",
"required": [
"client_organization_id"
],
"properties": {
"client_organization_id": {
"type": "string",
"description": "Customer organization UUID from list_provider_customers"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"email": {
"type": "string"
},
"last_name": {
"type": "string"
},
"first_name": {
"type": "string"
},
"organization_id": {
"type": "string"
},
"organization_name": {
"type": "string"
},
"purchases_blocked": {
"type": "boolean"
},
"vm_activity_status": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get the provider onboarding checklist.
No parameters.
{
"name": "get_provider_onboarding_checklist",
"description": "Get the provider onboarding checklist.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"hint": {
"type": "string"
},
"title": {
"type": "string"
},
"completed": {
"type": "boolean"
},
"action_path": {
"type": "string"
}
},
"additionalProperties": false
}
},
"next_step": {
"type": "string"
},
"onboarded": {
"type": "boolean"
},
"total_count": {
"type": "integer"
},
"completed_count": {
"type": "integer"
},
"progress_message": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get a region by UUID.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Resource UUID |
{
"name": "get_region",
"description": "Get a region by UUID.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Resource UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get a support ticket by UUID.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Resource UUID |
{
"name": "get_ticket",
"description": "Get a support ticket by UUID.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Resource UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
},
"subject": {
"type": "string"
},
"priority": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get a virtual machine by UUID, including ipv4 and ipv6 when allocated. Does not return a guest login user or SSH key material.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Resource UUID |
{
"name": "get_virtual_machine",
"description": "Get a virtual machine by UUID, including ipv4 and ipv6 when allocated. Does not return a guest login user or SSH key material.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Resource UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"ipv4": {
"type": "string"
},
"ipv6": {
"type": "string"
},
"name": {
"type": "string"
},
"region": {
"type": "string"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List provider agents. Does not return peering configuration or install commands.
No parameters.
{
"name": "list_agents",
"description": "List provider agents. Does not return peering configuration or install commands.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
},
"public_ip": {
"type": "string"
},
"provisioned": {
"type": "boolean"
},
"gateway_region": {
"type": "string"
},
"hypervisor_driver": {
"type": "string"
},
"inbound_peering_state": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List backups for a virtual machine.
| Parameter | Type | Description |
|---|---|---|
| vm_id * | string | Virtual machine UUID |
{
"name": "list_backups",
"description": "List backups for a virtual machine.",
"inputSchema": {
"type": "object",
"required": [
"vm_id"
],
"properties": {
"vm_id": {
"type": "string",
"description": "Virtual machine UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"state": {
"type": "string"
},
"vm_id": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List guest operating systems. Use the distro value as create_virtual_machine.distro.
No parameters.
{
"name": "list_distros",
"description": "List guest operating systems. Use the distro value as create_virtual_machine.distro.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string"
},
"label": {
"type": "string"
},
"distro": {
"type": "string"
},
"family": {
"type": "string"
},
"version": {
"type": "string"
},
"is_default": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List DNS records in a zone.
| Parameter | Type | Description |
|---|---|---|
| zone_id * | string | DNS zone UUID |
{
"name": "list_dns_records",
"description": "List DNS records in a zone.",
"inputSchema": {
"type": "object",
"required": [
"zone_id"
],
"properties": {
"zone_id": {
"type": "string",
"description": "DNS zone UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"ttl": {
"type": "integer"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"content": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List DNS zones.
No parameters.
{
"name": "list_dns_zones",
"description": "List DNS zones.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
},
"nameservers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List firewall rule sets.
No parameters.
{
"name": "list_firewall_rulesets",
"description": "List firewall rule sets.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Search marketplace offerings with a natural-language query. Each result carries the plan_id (id) and region_id for create_virtual_machine.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Natural-language search query (1-500 chars) e.g. vps in germany with 2 vcpu |
{
"name": "list_marketplace_offerings",
"description": "Search marketplace offerings with a natural-language query. Each result carries the plan_id (id) and region_id for create_virtual_machine.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Natural-language search query (1-500 chars) e.g. vps in germany with 2 vcpu"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"vcpus": {
"type": "integer"
},
"ram_gb": {
"type": "integer"
},
"region": {
"type": "string"
},
"disk_gb": {
"type": "integer"
},
"provider": {
"type": "string"
},
"region_id": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List IPAM networks.
No parameters.
{
"name": "list_networks",
"description": "List IPAM networks.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"dns_servers": {
"type": "array",
"items": {
"type": "string"
}
},
"mac_address_prefix": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List provider nodes.
No parameters.
{
"name": "list_nodes",
"description": "List provider nodes.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List organizations visible to the service account.
No parameters.
{
"name": "list_organizations",
"description": "List organizations visible to the service account.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"type": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List Noderings subscription plans (billing tiers). Not the plan_id for create_virtual_machine; use list_marketplace_offerings for that. Not the plan_id for create_plan; use list_template_plans for that.
No parameters.
{
"name": "list_plans",
"description": "List Noderings subscription plans (billing tiers). Not the plan_id for create_virtual_machine; use list_marketplace_offerings for that. Not the plan_id for create_plan; use list_template_plans for that.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List platforms.
No parameters.
{
"name": "list_platforms",
"description": "List platforms.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"driver": {
"type": "string"
},
"endpoint_url": {
"type": "string"
},
"service_status": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List IPAM prefixes for one network. Pass network_id from list_networks. An empty network_id returns a note to call list_networks first.
| Parameter | Type | Description |
|---|---|---|
| network_id | string | Network UUID from list_networks. Omit this and the tool tells you to call list_networks first. |
{
"name": "list_prefixes",
"description": "List IPAM prefixes for one network. Pass network_id from list_networks. An empty network_id returns a note to call list_networks first.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"network_id": {
"type": "string",
"description": "Network UUID from list_networks. Omit this and the tool tells you to call list_networks first."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"cidr": {
"type": "string"
},
"gateway": {
"type": "string"
},
"network_id": {
"type": "string"
},
"description": {
"type": "string"
},
"reserved_ips": {
"type": "array",
"items": {
"type": "string"
}
},
"reserved_count": {
"type": "integer"
},
"reserved_prefixes": {
"type": "array",
"items": {
"type": "string"
}
},
"allocation_strategy": {
"type": "string"
},
"vm_assignment_prefix_length": {
"type": "integer"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List marketplace preflight status for provider plans.
No parameters.
{
"name": "list_preflight_checks",
"description": "List marketplace preflight status for provider plans.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"plan_id": {
"type": "string"
},
"plan_code": {
"type": "string"
},
"plan_name": {
"type": "string"
},
"summary_note": {
"type": "string"
},
"marketplace_ready": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List customer organizations that have purchased from this provider. Does not include payment details.
No parameters.
{
"name": "list_provider_customers",
"description": "List customer organizations that have purchased from this provider. Does not include payment details.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string"
},
"last_name": {
"type": "string"
},
"first_name": {
"type": "string"
},
"organization_id": {
"type": "string"
},
"organization_name": {
"type": "string"
},
"purchases_blocked": {
"type": "boolean"
},
"vm_activity_status": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List guest virtual machines running on this provider. This is the provider view; it does not include MAC addresses.
| Parameter | Type | Description |
|---|---|---|
| node_id | string | Optional node UUID filter |
| region_id | string | Optional region UUID filter |
| platform_id | string | Optional platform UUID filter |
| customer_email | string | Optional case-insensitive substring of the customer contact email |
{
"name": "list_provider_virtual_machines",
"description": "List guest virtual machines running on this provider. This is the provider view; it does not include MAC addresses.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"node_id": {
"type": "string",
"description": "Optional node UUID filter"
},
"region_id": {
"type": "string",
"description": "Optional region UUID filter"
},
"platform_id": {
"type": "string",
"description": "Optional platform UUID filter"
},
"customer_email": {
"type": "string",
"description": "Optional case-insensitive substring of the customer contact email"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"cpu": {
"type": "integer"
},
"ipv4": {
"type": "string"
},
"ipv6": {
"type": "string"
},
"distro": {
"type": "string"
},
"hostname": {
"type": "string"
},
"memory_mb": {
"type": "integer"
},
"storage_mb": {
"type": "integer"
},
"compliance_held": {
"type": "boolean"
},
"client_contact_email": {
"type": "string"
},
"client_organization_id": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List regions.
No parameters.
{
"name": "list_regions",
"description": "List regions.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List snapshots for a virtual machine.
| Parameter | Type | Description |
|---|---|---|
| vm_id * | string | Virtual machine UUID |
{
"name": "list_snapshots",
"description": "List snapshots for a virtual machine.",
"inputSchema": {
"type": "object",
"required": [
"vm_id"
],
"properties": {
"vm_id": {
"type": "string",
"description": "Virtual machine UUID"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"state": {
"type": "string"
},
"vm_id": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List SSH keys of the organization (UUID, name, fingerprint). Use the id values as create_virtual_machine.ssh_key_ids.
No parameters.
{
"name": "list_ssh_keys",
"description": "List SSH keys of the organization (UUID, name, fingerprint). Use the id values as create_virtual_machine.ssh_key_ids.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"key_type": {
"type": "string"
},
"fingerprint": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List template plans a provider can clone. These are not subscription tiers. Pass code to narrow the list. Use an id from here as create_plan.plan_id. Prices are not returned.
| Parameter | Type | Description |
|---|---|---|
| code | string | Optional template code |
{
"name": "list_template_plans",
"description": "List template plans a provider can clone. These are not subscription tiers. Pass code to narrow the list. Use an id from here as create_plan.plan_id. Prices are not returned.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"code": {
"type": "string",
"description": "Optional template code"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List support tickets.
No parameters.
{
"name": "list_tickets",
"description": "List support tickets.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
},
"subject": {
"type": "string"
},
"priority": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List virtual machines. Each summary includes id, name, status, region, and ipv4/ipv6 when allocated.
No parameters.
{
"name": "list_virtual_machines",
"description": "List virtual machines. Each summary includes id, name, status, region, and ipv4/ipv6 when allocated.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"ipv4": {
"type": "string"
},
"ipv6": {
"type": "string"
},
"name": {
"type": "string"
},
"region": {
"type": "string"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List VM templates. template_id is the hypervisor template id already present on the node.
No parameters.
{
"name": "list_vm_templates",
"description": "List VM templates. template_id is the hypervisor template id already present on the node.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"distro": {
"type": "string"
},
"node_id": {
"type": "string"
},
"template_id": {
"type": "integer"
}
},
"additionalProperties": false
},
"description": "Matching resources; empty if none"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Remove one reserved address from a prefix.
| Parameter | Type | Description |
|---|---|---|
| prefix_id * | string | Prefix UUID from list_prefixes |
| ip_address * | string | Address inside the prefix CIDR |
{
"name": "remove_reserved_ip",
"description": "Remove one reserved address from a prefix.",
"inputSchema": {
"type": "object",
"required": [
"prefix_id",
"ip_address"
],
"properties": {
"prefix_id": {
"type": "string",
"description": "Prefix UUID from list_prefixes"
},
"ip_address": {
"type": "string",
"description": "Address inside the prefix CIDR"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"success": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Replace the node placement policy. Omitted region overrides are cleared. Read get_node_placement_policy first.
| Parameter | Type | Description |
|---|---|---|
| default_strategy * | string | NODE_PLACEMENT_STRATEGY_FIRST_STABLE |
| region_overrides | array | Full replacement list. Omitting overrides clears them. Read get_node_placement_policy first. |
{
"name": "update_node_placement_policy",
"description": "Replace the node placement policy. Omitted region overrides are cleared. Read get_node_placement_policy first.",
"inputSchema": {
"type": "object",
"required": [
"default_strategy"
],
"properties": {
"default_strategy": {
"type": "string",
"description": "NODE_PLACEMENT_STRATEGY_FIRST_STABLE"
},
"region_overrides": {
"type": "array",
"items": {
"type": "object",
"required": [
"region_id",
"strategy"
],
"properties": {
"strategy": {
"type": "string",
"description": "NODE_PLACEMENT_STRATEGY_FIRST_STABLE"
},
"region_id": {
"type": "string",
"description": "Region UUID from list_regions"
}
},
"additionalProperties": false
},
"description": "Full replacement list. Omitting overrides clears them. Read get_node_placement_policy first."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"default_strategy": {
"type": "string"
},
"region_overrides": {
"type": "array",
"items": {
"type": "object",
"properties": {
"strategy": {
"type": "string"
},
"region_id": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Start, stop, or reboot a virtual machine.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Virtual machine UUID |
| action * | string | Power action: start |
{
"name": "update_virtual_machine_power",
"description": "Start, stop, or reboot a virtual machine.",
"inputSchema": {
"type": "object",
"required": [
"id",
"action"
],
"properties": {
"id": {
"type": "string",
"description": "Virtual machine UUID"
},
"action": {
"type": "string",
"description": "Power action: start"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"ipv4": {
"type": "string"
},
"ipv6": {
"type": "string"
},
"name": {
"type": "string"
},
"region": {
"type": "string"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Create a DNS record. Overwrites an existing name+type only when allow_overwrite is true. Types: A, AAAA, CNAME, MX, TXT.
| Parameter | Type | Description |
|---|---|---|
| ttl | integer | TTL in seconds |
| name * | string | Record name (@ |
| type * | string | Record type: A |
| content * | string | Record data matching the type |
| zone_id * | string | DNS zone UUID |
| allow_overwrite | boolean | If true |
{
"name": "upsert_dns_record",
"description": "Create a DNS record. Overwrites an existing name+type only when allow_overwrite is true. Types: A, AAAA, CNAME, MX, TXT.",
"inputSchema": {
"type": "object",
"required": [
"zone_id",
"name",
"type",
"content"
],
"properties": {
"ttl": {
"type": "integer",
"description": "TTL in seconds"
},
"name": {
"type": "string",
"description": "Record name (@"
},
"type": {
"type": "string",
"description": "Record type: A"
},
"content": {
"type": "string",
"description": "Record data matching the type"
},
"zone_id": {
"type": "string",
"description": "DNS zone UUID"
},
"allow_overwrite": {
"type": "boolean",
"description": "If true"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
},
"ttl": {
"type": "integer"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"content": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.