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.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be McpDeploymentConfig. |
| metadata | map | Reserved keys such as project and environment resolve the manifest identity, its parent Project and the McpConfig it deploys. |
| spec | Spec | User-authored specification of the MCP server deployment. See Spec. |
PortsEntry
| Property | Type | Description |
|---|---|---|
| key | int64 | |
| value | string |
Spec
Per-environment deployment overrides.
The engine matches the linked McpConfig by name within the parent Project.
| Property | Type | Description |
|---|---|---|
| description | string | Optional free-text description. The engine copies it to the Cloud Run service and the Agent Registry entry. |
| version | string | Container 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. |
| scaling | ScalingConfig | Autoscaling bounds. When omitted, the defaults are 0 (min) and 3 (max). See ScalingConfig. |
| container | ContainerSpec | Overrides 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. |
| ports | list of PortsEntry | Map of port number to protocol (for example http, grpc). Each entry creates a named container port on the Cloud Run service. |
| health | Health | NOT YET IMPLEMENTED. The engine ignores this field. See Health. |
| volumes | list of VolumesEntry | NOT YET IMPLEMENTED. The engine ignores this field and mounts only a fixed in-memory /tmp volume. See ContainerVolumeMount. |
| requestTimeout | int64 | Per-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). |
| terminationGracePeriodSeconds | int64 | Time, 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.
| Property | Type | Description |
|---|---|---|
| startup | HostHealthConfig | NOT YET IMPLEMENTED. The engine ignores this field and sets no startup probe. See HostHealthConfig. |
| liveness | HostHealthConfig | NOT YET IMPLEMENTED. The engine ignores this field and sets no liveness probe. See HostHealthConfig. |
PortsEntry
| Property | Type | Description |
|---|---|---|
| key | int64 | |
| value | string |
ScalingConfig
Instance autoscaling bounds.
The engine sets them as the min and max instances of the Cloud Run service.
| Property | Type | Description |
|---|---|---|
| min | int64 | Minimum number of instances that always run. When scaling is unset, the default is 0 (scale to zero). |
| max | int64 | Maximum number of instances to scale out to. When scaling is unset, the default is 3. |
| hasBackgroundOperations | bool | True 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
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | ContainerVolumeMount |
HostHealthConfig
Health check for host endpoints.
Sets the probes and backend health checks for GCP load balancers.
| Property | Type | Description |
|---|---|---|
| protocol | string | Health check protocol: http, http2, https, grpc, or tcp. It applies to container probes (Cloud Run, GKE) and the VM backend health check. |
| port | int64 | TCP port that the health check targets. |
| checkIntervalSec | int64 | Interval between checks, in seconds. The default is 30 for generated probes. Default 30 |
| timeoutSec | int64 | Seconds to wait for a probe response before it fails. The engine sets 10 for generated probes. Default 5 |
| healthyThreshold | int64 | Consecutive successful probes that mark the endpoint healthy. The default is 1. Default 1 |
| unhealthyThreshold | int64 | Consecutive failed probes that mark the endpoint unhealthy. The default is 2. Default 2 |
| enableLogs | bool | NOT YET IMPLEMENTED. The engine ignores this field. Intended to enable health-check logs. |
| path | string | HTTP 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.
| Property | Type | Description |
|---|---|---|
| enabled | bool | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: turn the container off but keep its definition. |
| command | list of string | Container entrypoint. Overrides the image entrypoint (the container command). |
| args | list of string | Arguments for the entrypoint (the container args). |
| env | list of EnvVariableDefinition | Static environment variables. The engine merges them with variables from secrets and access control. |
| uid | string | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: the user ID of the container process. |
| gid | string | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: the group ID of the container process. |
| resources | ContainerResources | CPU 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.
| Property | Type | Description |
|---|---|---|
| files | list of FilesEntry | Map of relative file path to file content. Each entry becomes a file in the volume. |
FilesEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | VolumeMountFile |
EnvVariableDefinition
Static environment variable.
The engine adds it to the environment of the container.
| Property | Type | Description |
|---|---|---|
| name | string | Variable name. |
| value | string | Literal value. |
ContainerResources
Compute requirements and limits of a container.
They map to the resource requests and limits of Kubernetes pods or Cloud Run services.
| Property | Type | Description |
|---|---|---|
| requests | ContainerResource | Minimum CPU and memory guaranteed to the container. |
| limits | ContainerResource | Maximum CPU and memory that the container can use. |
VolumeMountFile
Generated file in a volume mount.
Startup scripts write the file to disk.
| Property | Type | Description |
|---|---|---|
| mimeType | string | MIME type of the file. If empty, the engine sets a default. |
| content | string | File content: plain text, or base64 if base64_encoded is true. |
| base64Encoded | bool | If 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.
| Property | Type | Description |
|---|---|---|
| cpu | string | CPU quantity in Kubernetes/Cloud Run notation, for example "500m" or "2". |
| memory | string | Memory quantity in the same notation, for example "256Mi" or "1Gi". |