Skip to main content
Glama

Update a GVC

update_gvc
DestructiveIdempotent

Update a GVC (Global Virtual Cloud), the deployment scope that sets which locations its workloads run in. Scalars, description, tags, env, pullSecretLinks, and placement addLocations MERGE with existing values; remove* counterparts (removeLocations, removeTagKeys, removeEnvNames, removePullSecretLinks) take entries away, and remove* flags (removeLocationQuery, removeTracing, removeLoadBalancer, removeKeda, removeSidecarEnvoy, removeAliasWorkloadLink) delete an optional block entirely. The nested objects (loadBalancer, keda, tracing, sidecarEnvoy, locationOptions, locationQuery) are REPLACED wholesale: always submit the complete object, never a partial patch, or the omitted sub-fields are dropped. Custom domains are configured with the Domain resource (create_domain), not on the GVC. Placement and endpoint changes can redeploy workloads or affect public workload availability.

Input Schema

NameRequiredDescriptionDefault
envNoAdd or update GVC environment variables (merged with existing). Submit an empty list to clear every env variable.
orgNoOrganization slug.
kedaNoReplace the KEDA configuration. Shape: {enabled, identityLink: //identity/NAME (gives KEDA cloud and network access), secrets: [//secret/NAME] (each a TriggerAuthentication of the same name)}.
tagsNoAdd or update GVC tags (merged with existing tags) without replacing the entire set. Submit an empty list to clear all tags.
gvcNameYesGVC name.
tracingNoReplace the tracing configuration. Shape: {sampling (required, percent 0 to 100), provider (required, exactly one of otel {endpoint}, lightstep {endpoint, credentials: //secret/NAME}, controlplane {}), customTags: {NAME: {literal: {value}}}}.
removeKedaNotrue deletes spec.keda.
descriptionNoNew description. Treat it like a concise annotation for future operators.
addLocationsNoPlacement locations to ADD (merged with existing; duplicates skipped). Accepts location names, friendly names, or links, validated against the org's own location list.
loadBalancerNoReplace the GVC load balancer configuration. Shape: {dedicated, multiZone: {enabled}, trustedProxies: 0 to 2, redirect: {class: {status5xx: URL, status401: URL}}, ipSet: //ipset/NAME}.
sidecarEnvoyNoReplace the Envoy sidecar filters (spec.sidecar.envoy), raw Envoy config passed through verbatim. Shape: {accessLog, clusters, excludedExternalAuth, excludedRateLimit, http, network, volumes}, each an array of Envoy objects.
locationQueryNoReplace the dynamic placement query. Shape: {kind: "location", spec: {match: all|any|none, terms: [{op: =|!=|<|<=|>|>=|~|=~|exists|!exists|contains, property|tag|rel (exactly one), value}]}}.
removeTagKeysNoTag keys to remove from the GVC.
removeTracingNotrue deletes spec.tracing (stops trace export).
removeEnvNamesNoEnvironment variable names to remove.
locationOptionsNoReplace per-location geo-routing options. Submit an empty list to remove them all. Shape: [{location, routingTier (lower wins), latencyOffsetMs (positive repels traffic), latencyToleranceMs (above it the location is skipped)}].
pullSecretLinksNoAdd pullSecretLinks (merged with existing). Submit an empty list to clear them all.
removeLocationsNoPlacement locations to REMOVE. Workloads redeploy out of removed locations and may lose capacity there.
aliasWorkloadLinkNoLink to a workload in this GVC whose canonical endpoint backs the GVC alias DNS record (e.g. //gvc/{gvc}/workload/{name}). NOTE: the alias is INERT while the target workload is suspended (suspend=true or maxScale=0) — it takes effect only while the workload runs.
removeLoadBalancerNotrue deletes spec.loadBalancer (reverts to platform default load balancing).
removeSidecarEnvoyNotrue deletes spec.sidecar (drops the custom Envoy filters).
removeLocationQueryNotrue deletes spec.staticPlacement.locationQuery, so placement follows the plain location list again.
endpointNamingFormatNoSet the canonical endpoint subdomain format (default/legacy/org).
removePullSecretLinksNopullSecretLinks to remove (exact string match).
removeAliasWorkloadLinkNotrue deletes spec.aliasWorkloadLink (detaches the GVC alias DNS record).

Output Schema

NameRequiredDescriptionDefault
okYes
dataNoThe full result. Read this, not only the summary.
detailsNo
summaryYes
nextStepsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed16 schema fields changed
    • changedInput schema / properties / gvcName / description
      Previous value: -"GVC slug. If the user named none, list_resources (kind \"gvc\") and let them choose."New value: +"GVC name."
    • changedInput schema / properties / keda / description
      Previous value: -"Replace the KEDA configuration."New value: +"Replace the KEDA configuration. Shape: {enabled, identityLink: //identity/NAME (gives KEDA cloud and network access), secrets: [//secret/NAME] (each a TriggerAuthentication of the same name)}."
    • removedInput schema / properties / keda / properties
      Removed value: -{
      -  "enabled": {
      -    "description": "Enable KEDA event-driven autoscaling for workloads in this GVC.",
      -    "type": "boolean"
      -  },
      -  "identityLink": {
      -    "description": "Identity link granting the KEDA operator access to cloud/network resources (e.g. //gvc/{gvc}/identity/{name}).",
      -    "type": "string"
      -  },
      -  "secrets": {
      -    "description": "Secret links (//secret/<name>) exposed as KEDA TriggerAuthentication objects (named after each secret).",
      -    "items": {
      -      "description": "Secret link (//secret/<name>) exposed as a KEDA TriggerAuthentication object.",
      -      "type": "string"
      -    },
      -    "type": "array"
      -  }
      -}
    • changedInput schema / properties / loadBalancer / description
      Previous value: -"Replace the GVC load balancer configuration."New value: +"Replace the GVC load balancer configuration. Shape: {dedicated, multiZone: {enabled}, trustedProxies: 0 to 2, redirect: {class: {status5xx: URL, status401: URL}}, ipSet: //ipset/NAME}."
    • removedInput schema / properties / loadBalancer / properties
      Removed value: -{
      -  "dedicated": {
      -    "description": "Create a dedicated load balancer per location (enables custom ports, protocols, wildcard hostnames). Charges apply per location.",
      -    "type": "boolean"
      -  },
      -  "ipSet": {
      -    "description": "Link to an IPSet resource for this load balancer (//ipset/<name> or /org/<org>/ipset/<name>).",
      -    "type": "string"
      -  },
      -  "multiZone": {
      -    "description": "Multi-zone load balancer options.",
      -    "properties": {
      -      "enabled": {
      -        "type": "boolean"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "redirect": {
      -    "description": "Per-status-class redirect URLs.",
      -    "properties": {
      -      "class": {
      -        "properties": {
      -          "status401": {
      -            "description": "Redirect URL for 401 responses (supports Envoy format strings, e.g. %REQ(:path)%).",
      -            "type": "string"
      -          },
      -          "status5xx": {
      -            "description": "Redirect URL for any 5xx status code.",
      -            "format": "uri",
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "trustedProxies": {
      -    "description": "Trusted proxy hops for X-Forwarded-For handling (0–2). Affects the client IP used for logging and X-Envoy-External-Address.",
      -    "maximum": 2,
      -    "minimum": 0,
      -    "type": "integer"
      -  }
      -}
    • changedInput schema / properties / locationOptions / description
      Previous value: -"Replace per-location geo-routing options. Submit an empty list to remove them all."New value: +"Replace per-location geo-routing options. Submit an empty list to remove them all. Shape: [{location, routingTier (lower wins), latencyOffsetMs (positive repels traffic), latencyToleranceMs (above it the location is skipped)}]."
    • removedInput schema / properties / locationOptions / items / properties
      Removed value: -{
      -  "latencyOffsetMs": {
      -    "description": "Artificial latency offset (ms). Positive pushes traffic away; negative attracts it.",
      -    "type": "integer"
      -  },
      -  "latencyToleranceMs": {
      -    "description": "Max acceptable latency (ms). Above this, the location is treated as unavailable for geo routing.",
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  "location": {
      -    "description": "Location name or link (e.g. \"aws-us-east-1\" or //location/aws-us-east-1).",
      -    "type": "string"
      -  },
      -  "routingTier": {
      -    "description": "DNS geo-routing priority. Lower = higher priority; same tier = latency-based within the group.",
      -    "minimum": 0,
      -    "type": "integer"
      -  }
      -}
    • removedInput schema / properties / locationOptions / items / required
      Removed value: -[
      -  "location"
      -]
    • changedInput schema / properties / locationQuery / description
      Previous value: -"Replace the dynamic placement query."New value: +"Replace the dynamic placement query. Shape: {kind: \"location\", spec: {match: all|any|none, terms: [{op: =|!=|<|<=|>|>=|~|=~|exists|!exists|contains, property|tag|rel (exactly one), value}]}}."
    • removedInput schema / properties / locationQuery / properties
      Removed value: -{
      -  "kind": {
      -    "description": "Resource kind the query selects (e.g. \"user\" or \"serviceaccount\" for group members).",
      -    "type": "string"
      -  },
      -  "spec": {
      -    "properties": {
      -      "match": {
      -        "description": "How terms combine: all (AND), any (OR), or none (default \"all\").",
      -        "enum": [
      -          "all",
      -          "any",
      -          "none"
      -        ],
      -        "type": "string"
      -      },
      -      "sort": {
      -        "properties": {
      -          "by": {
      -            "description": "Property to sort by.",
      -            "type": "string"
      -          },
      -          "order": {
      -            "description": "Sort order (default \"asc\").",
      -            "enum": [
      -              "asc",
      -              "desc"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "by"
      -        ],
      -        "type": "object"
      -      },
      -      "terms": {
      -        "description": "Match terms.",
      -        "items": {
      -          "properties": {
      -            "op": {
      -              "description": "Comparison operator (default \"=\").",
      -              "enum": [
      -                "=",
      -                ">",
      -                ">=",
      -                "<",
      -                "<=",
      -                "!=",
      -                "~",
      -                "=~",
      -                "exists",
      -                "!exists",
      -                "contains"
      -              ],
      -              "type": "string"
      -            },
      -            "property": {
      -              "description": "Resource property to match (e.g. \"name\"). Set exactly one of property, tag, or rel.",
      -              "type": "string"
      -            },
      -            "rel": {
      -              "description": "Relationship to match. Set exactly one of property, tag, or rel.",
      -              "type": "string"
      -            },
      -            "tag": {
      -              "description": "Tag key to match. Set exactly one of property, tag, or rel.",
      -              "type": "string"
      -            },
      -            "value": {
      -              "description": "Value to compare against. Required for most ops; omit for \"exists\"/\"!exists\".",
      -              "type": [
      -                "string",
      -                "number",
      -                "boolean"
      -              ]
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "type": "object"
      -  }
      -}
    • removedInput schema / properties / locationQuery / required
      Removed value: -[
      -  "kind"
      -]
    • changedInput schema / properties / sidecarEnvoy / description
      Previous value: -"Replace the Envoy sidecar filters (spec.sidecar.envoy)."New value: +"Replace the Envoy sidecar filters (spec.sidecar.envoy), raw Envoy config passed through verbatim. Shape: {accessLog, clusters, excludedExternalAuth, excludedRateLimit, http, network, volumes}, each an array of Envoy objects."
    • removedInput schema / properties / sidecarEnvoy / properties
      Removed value: -{
      -  "accessLog": {
      -    "description": "Access log configuration (advanced raw Envoy config, passed through verbatim).",
      -    "items": {
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "clusters": {
      -    "description": "Envoy clusters (advanced raw Envoy config, passed through verbatim).",
      -    "items": {
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "excludedExternalAuth": {
      -    "description": "Routes excluded from external auth (advanced raw Envoy config, passed through verbatim).",
      -    "items": {
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "excludedRateLimit": {
      -    "description": "Routes excluded from rate limiting (advanced raw Envoy config, passed through verbatim).",
      -    "items": {
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "http": {
      -    "description": "HTTP filters (advanced raw Envoy config, passed through verbatim).",
      -    "items": {
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "network": {
      -    "description": "Network filters (advanced raw Envoy config, passed through verbatim).",
      -    "items": {
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "volumes": {
      -    "description": "Sidecar volumes (advanced raw Envoy config, passed through verbatim).",
      -    "items": {
      -      "type": "object"
      -    },
      -    "type": "array"
      -  }
      -}
    • changedInput schema / properties / tracing / description
      Previous value: -"Replace the tracing configuration."New value: +"Replace the tracing configuration. Shape: {sampling (required, percent 0 to 100), provider (required, exactly one of otel {endpoint}, lightstep {endpoint, credentials: //secret/NAME}, controlplane {}), customTags: {NAME: {literal: {value}}}}."
    • removedInput schema / properties / tracing / properties
      Removed value: -{
      -  "customTags": {
      -    "additionalProperties": {
      -      "properties": {
      -        "literal": {
      -          "properties": {
      -            "value": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "value"
      -          ],
      -          "type": "object"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "description": "Custom trace tags keyed by tag name.",
      -    "type": "object"
      -  },
      -  "provider": {
      -    "description": "Tracing provider — set exactly one of otel, lightstep, or controlplane.",
      -    "properties": {
      -      "controlplane": {
      -        "description": "Use the built-in Control Plane tracing provider.",
      -        "properties": {},
      -        "type": "object"
      -      },
      -      "lightstep": {
      -        "properties": {
      -          "credentials": {
      -            "description": "Link to an opaque secret holding Lightstep credentials.",
      -            "type": "string"
      -          },
      -          "endpoint": {
      -            "description": "Lightstep collector endpoint.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "endpoint"
      -        ],
      -        "type": "object"
      -      },
      -      "otel": {
      -        "properties": {
      -          "endpoint": {
      -            "description": "OpenTelemetry collector endpoint.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "endpoint"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "sampling": {
      -    "description": "Trace sampling percentage (0–100).",
      -    "maximum": 100,
      -    "minimum": 0,
      -    "type": "number"
      -  }
      -}
    • removedInput schema / properties / tracing / required
      Removed value: -[
      -  "sampling",
      -  "provider"
      -]
  2. Changed70 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • removedInput schema / additionalProperties
      Removed value: -false
    • removedInput schema / properties / addLocations / items / minLength
      Removed value: -1
    • removedInput schema / properties / addLocations / minItems
      Removed value: -1
    • removedInput schema / properties / aliasWorkloadLink / pattern
      Removed value: -"^(\\/\\/workload\\/|\\/\\/gvc\\/[a-z0-9-]+\\/workload\\/|\\/org\\/[a-z0-9-]+\\/gvc\\/[a-z0-9-]+\\/workload\\/)[a-z]([-a-z0-9])*[a-z0-9]$"
    • removedInput schema / properties / description / maxLength
      Removed value: -250
    • removedInput schema / properties / env / items / additionalProperties
      Removed value: -false
    • removedInput schema / properties / env / items / properties / name / maxLength
      Removed value: -120
    • removedInput schema / properties / env / items / properties / name / minLength
      Removed value: -1
    • removedInput schema / properties / env / items / properties / name / pattern
      Removed value: -"^[-._a-zA-Z][-._a-zA-Z0-9]*$"
    • removedInput schema / properties / env / items / properties / value / maxLength
      Removed value: -4096
    • changedInput schema / properties / gvcName / description
      Previous value: -"GVC slug (lowercase kebab-case). Use the GVC the user named; otherwise discover with list_resources (kind=\"gvc\") and let them choose — never guess (a wrong GVC targets the wrong environment)."New value: +"GVC slug. If the user named none, list_resources (kind \"gvc\") and let them choose."
    • removedInput schema / properties / gvcName / maxLength
      Removed value: -63
    • removedInput schema / properties / gvcName / minLength
      Removed value: -1
    • removedInput schema / properties / gvcName / pattern
      Removed value: -"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$"
    • removedInput schema / properties / keda / additionalProperties
      Removed value: -false
    • removedInput schema / properties / keda / properties / identityLink / pattern
      Removed value: -"^(\\/\\/identity\\/|\\/\\/gvc\\/[a-z0-9-]+\\/identity\\/|\\/org\\/[a-z0-9-]+\\/gvc\\/[a-z0-9-]+\\/identity\\/)[a-z]([-a-z0-9])*[a-z0-9]$"
    • removedInput schema / properties / keda / properties / secrets / items / pattern
      Removed value: -"^(\\/\\/secret\\/|\\/org\\/[a-z0-9-]+\\/secret\\/)[a-z]([-a-z0-9])*[a-z0-9]$"
    • removedInput schema / properties / loadBalancer / additionalProperties
      Removed value: -false
    • removedInput schema / properties / loadBalancer / properties / ipSet / pattern
      Removed value: -"^(\\/\\/ipset\\/|\\/org\\/[a-z0-9-]+\\/ipset\\/)[a-z]([-a-z0-9])*[a-z0-9]$"
    • removedInput schema / properties / loadBalancer / properties / multiZone / additionalProperties
      Removed value: -false
    • removedInput schema / properties / loadBalancer / properties / redirect / additionalProperties
      Removed value: -false
    • removedInput schema / properties / loadBalancer / properties / redirect / properties / class / additionalProperties
      Removed value: -false
    • removedInput schema / properties / locationOptions / items / additionalProperties
      Removed value: -false
    • removedInput schema / properties / locationOptions / items / properties / location / minLength
      Removed value: -1
    • removedInput schema / properties / locationQuery / additionalProperties
      Removed value: -false
    • removedInput schema / properties / locationQuery / properties / kind / minLength
      Removed value: -1
    • removedInput schema / properties / locationQuery / properties / spec / additionalProperties
      Removed value: -false
    • removedInput schema / properties / locationQuery / properties / spec / properties / sort / additionalProperties
      Removed value: -false
    • removedInput schema / properties / locationQuery / properties / spec / properties / sort / properties / by / minLength
      Removed value: -1
    • removedInput schema / properties / locationQuery / properties / spec / properties / terms / items / additionalProperties
      Removed value: -false
    • changedInput schema / properties / org / description
      Previous value: -"Organization slug (lowercase kebab-case). NEVER guess — if the user has not named one, ask. On org-not-found, stop and ask; do not retry variants."New value: +"Organization slug."
    • removedInput schema / properties / org / maxLength
      Removed value: -63
    • removedInput schema / properties / org / minLength
      Removed value: -1
    • removedInput schema / properties / org / pattern
      Removed value: -"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$"
    • removedInput schema / properties / pullSecretLinks / items / pattern
      Removed value: -"^(\\/\\/secret\\/|\\/org\\/[a-z0-9-]+\\/secret\\/)[a-z]([-a-z0-9])*[a-z0-9]$"
    • removedInput schema / properties / removeEnvNames / items / minLength
      Removed value: -1
    • removedInput schema / properties / removeLocations / items / minLength
      Removed value: -1
    • removedInput schema / properties / removePullSecretLinks / items / minLength
      Removed value: -1
    • removedInput schema / properties / removeTagKeys / items / minLength
      Removed value: -1
    • removedInput schema / properties / sidecarEnvoy / additionalProperties
      Removed value: -false
    • removedInput schema / properties / sidecarEnvoy / properties / accessLog / items / additionalProperties
      Removed value: -{}
    • removedInput schema / properties / sidecarEnvoy / properties / clusters / items / additionalProperties
      Removed value: -{}
    • removedInput schema / properties / sidecarEnvoy / properties / excludedExternalAuth / items / additionalProperties
      Removed value: -{}
    • removedInput schema / properties / sidecarEnvoy / properties / excludedRateLimit / items / additionalProperties
      Removed value: -{}
    • removedInput schema / properties / sidecarEnvoy / properties / http / items / additionalProperties
      Removed value: -{}
    • removedInput schema / properties / sidecarEnvoy / properties / network / items / additionalProperties
      Removed value: -{}
    • removedInput schema / properties / sidecarEnvoy / properties / volumes / items / additionalProperties
      Removed value: -{}
    • removedInput schema / properties / tags / items / additionalProperties
      Removed value: -false
    • removedInput schema / properties / tags / items / properties / key / minLength
      Removed value: -1
    • removedInput schema / properties / tags / maxItems
      Removed value: -50
    • removedInput schema / properties / tracing / additionalProperties
      Removed value: -false
    • removedInput schema / properties / tracing / properties / customTags / additionalProperties / additionalProperties
      Removed value: -false
    • removedInput schema / properties / tracing / properties / customTags / additionalProperties / properties / literal / additionalProperties
      Removed value: -false
    • removedInput schema / properties / tracing / properties / customTags / additionalProperties / properties / literal / properties / value / maxLength
      Removed value: -50
    • removedInput schema / properties / tracing / properties / provider / additionalProperties
      Removed value: -false
    • removedInput schema / properties / tracing / properties / provider / properties / controlplane / additionalProperties
      Removed value: -false
    • removedInput schema / properties / tracing / properties / provider / properties / lightstep / additionalProperties
      Removed value: -false
    • removedInput schema / properties / tracing / properties / provider / properties / lightstep / properties / credentials / minLength
      Removed value: -1
    • removedInput schema / properties / tracing / properties / provider / properties / lightstep / properties / endpoint / minLength
      Removed value: -1
    • removedInput schema / properties / tracing / properties / provider / properties / otel / additionalProperties
      Removed value: -false
    • removedInput schema / properties / tracing / properties / provider / properties / otel / properties / endpoint / minLength
      Removed value: -1
    • changedInput schema / required
      Previous value: -[
      -  "org",
      -  "gvcName"
      -]New value: +[
      +  "gvcName"
      +]
    • removedOutput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • removedOutput schema / additionalProperties
      Removed value: -false
    • changedOutput schema / properties / data / description
      Previous value: -"The full machine-readable result — list rows, the resource object, query results. Read THIS, not just the summary."New value: +"The full result. Read this, not only the summary."
    • addedOutput schema / properties / details
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / nextSteps / description
      Removed value: -"Recommended follow-up actions for this task, in order."
    • removedOutput schema / properties / ok / description
      Removed value: -"Whether the call succeeded."
    • removedOutput schema / properties / summary / description
      Removed value: -"One-line summary of the result."
  3. Changed9 schema fields changed
    • addedInput schema / properties / addLocations
      Added value: +{
      +  "description": "Placement locations to ADD (merged with existing; duplicates skipped). Accepts location names, friendly names, or links, validated against the org's own location list.",
      +  "items": {
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / properties / locationOptions / description
      Previous value: -"Replace per-location geo-routing options."New value: +"Replace per-location geo-routing options. Submit an empty list to remove them all."
    • addedInput schema / properties / removeAliasWorkloadLink
      Added value: +{
      +  "description": "true deletes spec.aliasWorkloadLink (detaches the GVC alias DNS record).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / removeKeda
      Added value: +{
      +  "description": "true deletes spec.keda.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / removeLoadBalancer
      Added value: +{
      +  "description": "true deletes spec.loadBalancer (reverts to platform default load balancing).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / removeLocationQuery
      Added value: +{
      +  "description": "true deletes spec.staticPlacement.locationQuery, so placement follows the plain location list again.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / removeLocations
      Added value: +{
      +  "description": "Placement locations to REMOVE. Workloads redeploy out of removed locations and may lose capacity there.",
      +  "items": {
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / removeSidecarEnvoy
      Added value: +{
      +  "description": "true deletes spec.sidecar (drops the custom Envoy filters).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / removeTracing
      Added value: +{
      +  "description": "true deletes spec.tracing (stops trace export).",
      +  "type": "boolean"
      +}
  4. First observed

TDQS

A4.2/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag destructiveHint=true, but the description goes well beyond them: it distinguishes MERGE families (scalars, tags, env, pullSecretLinks, addLocations) from REPLACE families (loadBalancer, keda, tracing, sidecarEnvoy, locationOptions, locationQuery), warns that partial nested objects silently drop sub-fields, and states that placement/endpoint changes can redeploy workloads or affect public availability. That is exactly the context an agent needs before a destructive mutation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads purpose, then the merge/replace contract, then the side-effect warning; for 25 parameters the length is justified and no sentence is filler. Sentences are long and clause-dense, which slightly hurts scannability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 25-parameter destructive mutation with nested objects, the description covers mutation semantics, deletion paths, side effects, and the domain-tool boundary; an output schema exists so return values need no explanation. Minor gaps remain around required gvcName/org scoping and whether a call with no partial fields is a no-op.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema coverage the baseline is 3, but the description synthesizes a rule the schema states only piecemeal: which parameter groups merge, which replace wholesale, and which remove* flags delete an optional block entirely. It also correctly notes aliasWorkloadLink is inert while the target workload is suspended - a detail beyond a typical schema blurb.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Declares a specific verb (update) and resource (GVC), then defines what a GVC is - 'the deployment scope that sets which locations its workloads run in' - so an agent unfamiliar with the domain can place it. It never explicitly contrasts itself with create_gvc or update_workload, so sibling discrimination is left partly to inference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes one class of change elsewhere: 'Custom domains are configured with the Domain resource (create_domain), not on the GVC.' That is a real exclusion with a named alternative. It gives no general when-to-use framing (mutate an existing GVC vs. create_gvc for a new one), so it falls shorted of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.