Skip to main content

Mcp Deployment Config

McpDeploymentConfig​

Per-environment runtime configuration for an MCP server.

Overrides the version, scaling, container, ports and timeouts of a shared McpConfig on Cloud Run. It is the MCP equivalent of DeploymentConfig.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be McpDeploymentConfig.
metadatamapReserved keys such as project and environment resolve the manifest identity, its parent Project and the McpConfig it deploys.
specSpecUser-authored specification of the MCP server deployment. See Spec.

PortsEntry​

PropertyTypeDescription
keyint64
valuestring

Spec​

Per-environment deployment overrides.

The engine matches the linked McpConfig by name within the parent Project.

PropertyTypeDescription
descriptionstringOptional free-text description. The engine copies it to the Cloud Run service and the Agent Registry entry.
versionstringContainer image version tag from CI (for example 0.1.0 or 1.2.3-rc1). The engine deploys the built image with this tag. Required.
scalingScalingConfigAutoscaling bounds. When omitted, the defaults are 0 (min) and 3 (max). See ScalingConfig.
containerContainerSpecOverrides for the MCP server container: command, args, environment variables, and resource limits and requests. Command, args and resource limits go to Cloud Run. Environment variables merge into the runtime environment. See ContainerSpec.
portslist of PortsEntryMap of port number to protocol (for example http, grpc). Each entry creates a named container port on the Cloud Run service.
healthHealthNOT YET IMPLEMENTED. The engine ignores this field. See Health.
volumeslist of VolumesEntryNOT YET IMPLEMENTED. The engine ignores this field and mounts only a fixed in-memory /tmp volume. See ContainerVolumeMount.
requestTimeoutint64Per-request timeout, in seconds. Range: 0 to 3600. Applied only when greater than 0. The platform terminates a request that runs longer. When unset, the Cloud Run default applies (for example 300).
terminationGracePeriodSecondsint64Time, in seconds, to wait after SIGTERM before Cloud Run kills the container. Range: 0 to 3600. Applied only when greater than 0. When unset, the platform default applies.

Health​

Container health probes.

Startup and liveness probes.

PropertyTypeDescription
startupHostHealthConfigNOT YET IMPLEMENTED. The engine ignores this field and sets no startup probe. See HostHealthConfig.
livenessHostHealthConfigNOT YET IMPLEMENTED. The engine ignores this field and sets no liveness probe. See HostHealthConfig.

PortsEntry​

PropertyTypeDescription
keyint64
valuestring

ScalingConfig​

Instance autoscaling bounds.

The engine sets them as the min and max instances of the Cloud Run service.

PropertyTypeDescription
minint64Minimum number of instances that always run. When scaling is unset, the default is 0 (scale to zero).
maxint64Maximum number of instances to scale out to. When scaling is unset, the default is 3.
hasBackgroundOperationsboolTrue if the server does work OUTSIDE a request (timers, async work, warm in-memory state) that must run when no request is active. Such a server CANNOT use request-based (CPU-idle) billing, so the platform keeps CPU always allocated. If false (default), billing is per request and the platform throttles CPU between requests.

VolumesEntry​

PropertyTypeDescription
keystring
valueContainerVolumeMount

HostHealthConfig​

Health check for host endpoints.

Sets the probes and backend health checks for GCP load balancers.

PropertyTypeDescription
protocolstringHealth check protocol: http, http2, https, grpc, or tcp. It applies to container probes (Cloud Run, GKE) and the VM backend health check.
portint64TCP port that the health check targets.
checkIntervalSecint64Interval between checks, in seconds. The default is 30 for generated probes. Default 30
timeoutSecint64Seconds to wait for a probe response before it fails. The engine sets 10 for generated probes. Default 5
healthyThresholdint64Consecutive successful probes that mark the endpoint healthy. The default is 1. Default 1
unhealthyThresholdint64Consecutive failed probes that mark the endpoint unhealthy. The default is 2. Default 2
enableLogsboolNOT YET IMPLEMENTED. The engine ignores this field. Intended to enable health-check logs.
pathstringHTTP request path for HTTP-family probes. The default is /. Default "/"

ContainerSpec​

Core configuration block for a runtime container.

It overrides the entrypoint, variables and compute constraints of the base image.

PropertyTypeDescription
enabledboolNOT YET IMPLEMENTED. The engine ignores this field. Intended use: turn the container off but keep its definition.
commandlist of stringContainer entrypoint. Overrides the image entrypoint (the container command).
argslist of stringArguments for the entrypoint (the container args).
envlist of EnvVariableDefinitionStatic environment variables. The engine merges them with variables from secrets and access control.
uidstringNOT YET IMPLEMENTED. The engine ignores this field. Intended use: the user ID of the container process.
gidstringNOT YET IMPLEMENTED. The engine ignores this field. Intended use: the group ID of the container process.
resourcesContainerResourcesCPU and memory requests and limits. See ContainerResources.

ContainerVolumeMount​

Generated files for a container volume.

The files typically become config maps or secrets on Kubernetes, or files on Cloud Run.

PropertyTypeDescription
fileslist of FilesEntryMap of relative file path to file content. Each entry becomes a file in the volume.

FilesEntry​

PropertyTypeDescription
keystring
valueVolumeMountFile

EnvVariableDefinition​

Static environment variable.

The engine adds it to the environment of the container.

PropertyTypeDescription
namestringVariable name.
valuestringLiteral value.

ContainerResources​

Compute requirements and limits of a container.

They map to the resource requests and limits of Kubernetes pods or Cloud Run services.

PropertyTypeDescription
requestsContainerResourceMinimum CPU and memory guaranteed to the container.
limitsContainerResourceMaximum CPU and memory that the container can use.

VolumeMountFile​

Generated file in a volume mount.

Startup scripts write the file to disk.

PropertyTypeDescription
mimeTypestringMIME type of the file. If empty, the engine sets a default.
contentstringFile content: plain text, or base64 if base64_encoded is true.
base64EncodedboolIf true, the engine decodes content from base64 before it writes the file.

ContainerResource​

Single resource boundary for a container.

It sets the requests or the limits for CPU and memory.

PropertyTypeDescription
cpustringCPU quantity in Kubernetes/Cloud Run notation, for example "500m" or "2".
memorystringMemory quantity in the same notation, for example "256Mi" or "1Gi".