Skip to main content
Glama

Create a GVC

create_gvc

Create a new GVC (Global Virtual Cloud) — the deployment scope workloads live in. Configure placement in this call through locations or locationQuery: a GVC without placement cannot run workloads (locationOptions is DNS geo-routing tuning for placed locations, not placement). If the user did not specify placement, ask first (list_resources kind="location" shows the options); when they leave it to you, pick one location that fits their users and say which. Never create an empty GVC. Custom domains are configured with the Domain resource (create_domain), not on the GVC.

Input Schema

NameRequiredDescriptionDefault
envNoEnvironment variables defined on the GVC. Workloads with inheritEnv=true redeploy when these values change.
orgNoOrganization slug.
kedaNoKEDA autoscaling configuration for the GVC. Shape: {enabled, identityLink: //identity/NAME (gives KEDA cloud and network access), secrets: [//secret/NAME] (each a TriggerAuthentication of the same name)}.
nameYesResource name. Immutable: renaming is delete and recreate.
tagsNoOptional tags (key-value pairs such as env=prod). Use them like Kubernetes labels for governance and search.
tracingNoDistributed 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}}}}.
locationsNoLocations the GVC deploys to — any location the org has: a built-in cloud region ("aws-eu-central-1"), a BYOK location registered from your own cluster, or a friendly name like "frankfurt" (resolved server-side against the org's own list). REQUIRED unless locationQuery provides placement instead. If the user has not named one, ASK which location(s) to use (list_resources kind="location" shows the options); when they leave it to you, pick one that fits their users and say which.
descriptionNoDescription (surfaced in tooling similar to a Kubernetes annotation).
loadBalancerNoGVC load balancer configuration. Shape: {dedicated, multiZone: {enabled}, trustedProxies: 0 to 2, redirect: {class: {status5xx: URL, status401: URL}}, ipSet: //ipset/NAME}.
sidecarEnvoyNoAdvanced Envoy sidecar filters (maps to spec.sidecar.envoy), raw Envoy config passed through verbatim. Shape: {accessLog, clusters, excludedExternalAuth, excludedRateLimit, http, network, volumes}, each an array of Envoy objects.
locationQueryNoDynamic placement: a query that selects locations. Shape: {kind: "location", spec: {match: all|any|none, terms: [{op: =|!=|<|<=|>|>=|~|=~|exists|!exists|contains, property|tag|rel (exactly one), value}]}}.
locationOptionsNoDNS geo-routing for locations placed by `locations` or `locationQuery`; it does not place the GVC. Shape: [{location, routingTier (lower wins), latencyOffsetMs (positive repels traffic), latencyToleranceMs (above it the location is skipped)}].
pullSecretLinksNoSecret links for docker/ecr/gcp secrets so workloads can pull from private registries (e.g., /org/{org}/secret/{secret} or //secret/{secret}).
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.
endpointNamingFormatNoSubdomain format for the canonical workload endpoint. "default": {workload}-{gvc}.cpln.app; "org": {workload}-{gvc}.{org}.cpln.app; "legacy": legacy scheme. When omitted on create, the platform defaults to "org".

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. Changed15 schema fields changed
    • changedInput schema / properties / keda / description
      Previous value: -"KEDA autoscaling configuration for the GVC."New value: +"KEDA autoscaling configuration for the GVC. 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: -"GVC load balancer configuration."New value: +"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: -"Per-location DNS geo-routing options (routingTier priority, latency bias/cutoff) for locations already placed via `locations` or `locationQuery`. Routing only — it does NOT place the GVC anywhere."New value: +"DNS geo-routing for locations placed by `locations` or `locationQuery`; it does not place the GVC. 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: -"Dynamic placement: a query that selects locations."New value: +"Dynamic placement: a query that selects locations. 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: -"Advanced Envoy sidecar filters (maps to spec.sidecar.envoy)."New value: +"Advanced Envoy sidecar filters (maps to 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: -"Distributed tracing configuration."New value: +"Distributed 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. Changed67 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • removedInput schema / additionalProperties
      Removed value: -false
    • 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
    • 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 / locations / description
      Previous value: -"Locations the GVC deploys to — any location the org has: a built-in cloud region (\"aws-eu-central-1\"), a BYOK location registered from your own cluster, or a friendly name like \"frankfurt\" (resolved server-side against the org's own list). REQUIRED unless locationQuery provides placement instead. If the user has not named one, ASK which location(s) to use (list_resources kind=\"location\" shows the options); never pick one silently."New value: +"Locations the GVC deploys to — any location the org has: a built-in cloud region (\"aws-eu-central-1\"), a BYOK location registered from your own cluster, or a friendly name like \"frankfurt\" (resolved server-side against the org's own list). REQUIRED unless locationQuery provides placement instead. If the user has not named one, ASK which location(s) to use (list_resources kind=\"location\" shows the options); when they leave it to you, pick one that fits their users and say which."
    • removedInput schema / properties / locations / items / minLength
      Removed value: -1
    • removedInput schema / properties / locations / minItems
      Removed value: -1
    • changedInput schema / properties / name / description
      Previous value: -"Resource name (lowercase kebab-case, starts with a letter, 2-64 chars). Names are IMMUTABLE — renaming = delete + recreate (loses URL, DNS, policy links)."New value: +"Resource name. Immutable: renaming is delete and recreate."
    • removedInput schema / properties / name / maxLength
      Removed value: -64
    • removedInput schema / properties / name / minLength
      Removed value: -2
    • removedInput schema / properties / name / pattern
      Removed value: -"^[a-z]([-a-z0-9])*[a-z0-9]$"
    • 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 / 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",
      -  "name"
      -]New value: +[
      +  "name"
      +]
    • 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. Changed2 schema fields changed
    • changedInput schema / properties / locationOptions / description
      Previous value: -"Per-location DNS geo-routing options (priority/latency). An alternative to `locations` for advanced routing."New value: +"Per-location DNS geo-routing options (routingTier priority, latency bias/cutoff) for locations already placed via `locations` or `locationQuery`. Routing only — it does NOT place the GVC anywhere."
    • changedInput schema / properties / locations / description
      Previous value: -"Locations the GVC deploys to — any location the org has: a built-in cloud region (\"aws-eu-central-1\"), a BYOK location registered from your own cluster, or a friendly name like \"frankfurt\" (resolved server-side against the org's own list). REQUIRED unless locationOptions or locationQuery is used instead. If the user has not named one, ASK which location(s) to use (list_resources kind=\"location\" shows the options); never pick one silently."New value: +"Locations the GVC deploys to — any location the org has: a built-in cloud region (\"aws-eu-central-1\"), a BYOK location registered from your own cluster, or a friendly name like \"frankfurt\" (resolved server-side against the org's own list). REQUIRED unless locationQuery provides placement instead. If the user has not named one, ASK which location(s) to use (list_resources kind=\"location\" shows the options); never pick one silently."
  4. Changed1 schema field changed
    • changedInput schema / properties / locations / description
      Previous value: -"Locations the GVC deploys to (friendly names like \"frankfurt\" or IDs like \"aws-eu-central-1\" — resolved server-side). REQUIRED unless locationOptions or locationQuery is used instead. If the user has not named one, ASK which location(s) to use (list_resources kind=\"location\" shows the options); never pick one silently."New value: +"Locations the GVC deploys to — any location the org has: a built-in cloud region (\"aws-eu-central-1\"), a BYOK location registered from your own cluster, or a friendly name like \"frankfurt\" (resolved server-side against the org's own list). REQUIRED unless locationOptions or locationQuery is used instead. If the user has not named one, ASK which location(s) to use (list_resources kind=\"location\" shows the options); never pick one silently."
  5. First observed

TDQS

A4.7/5.0
Behavior5/5

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

Beyond the annotations (readOnly=false, destructive=false, openWorld=true), the description discloses a consequential behavior: a GVC without placement cannot run workloads. It also preempts the most likely misuse by clarifying that locationOptions is DNS geo-routing tuning, not placement.

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-loaded with identity and purpose, then the placement decision rule, then the domain exclusion — a sensible priority order. Slightly redundant, since the ask-first instruction is restated both in the description body and the locations schema field.

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 15-parameter create tool with nested objects and an output schema, the description correctly focuses on the one decision an agent can get wrong (placement) and defers field-level detail to the schema. It omits any mention of org scoping or auth prerequisites, which is a minor gap given the tool is open-world.

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?

Schema coverage is 100%, so the baseline is 3; the description earns extra by disambiguating the three placement-related parameters (locations, locationQuery, locationOptions) and stating they are alternatives rather than complements. It stops short of adding anything the schema does not already imply about the remaining twelve optional fields, but those do not need help.

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

Purpose5/5

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

Opens with a specific verb+resource plus a one-clause explanation of what a GVC is ('the deployment scope workloads live in'), which is far more than a restatement of the title. It also distinguishes this create call from the domain and location resources an agent might otherwise conflate with it.

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

Usage Guidelines5/5

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

Gives explicit procedural guidance: ask the user for placement if unspecified, use list_resources kind="location" to show options, pick one fitting location and state it when delegated. It also names the alternative path for custom domains (create_domain) and states a hard exclusion ('Never create an empty GVC').

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.