Cloud World Model

Official9 tools

by cloudworldmodel

Simulate cloud infrastructure and estimate cost before deploying or changing infrastructure.

Model Context Protocol (MCP) Server: ai.cloudworldmodel/cloud-world-model

The MCP server ai.cloudworldmodel/cloud-world-model simulates cloud architectures prior to provisioning. It provides 9 free demo tools by default, and an API key is required to unlock access to all 62 tools.

🛠️ Key Features

Simulates cloud architectures before provisioning
9 free demo tools available without an API key
API key unlocks all 62 tools

🚀 Use Cases

Validate and explore cloud architecture designs prior to provisioning
Test available tool functionality in a demo mode
Enable full capability via API key for broader simulation tasks

⚡ Developer Benefits

Predictive workflow that supports architecture simulation before deployment
Clear access control between demo tooling (9) and full tooling (62)

⚠️ Limitations

Full tool set access requires an API key
Only 9 tools are available in the free demo mode

Captured live from the server via tools/list.

simulation.inject_failure

Fail one compute/Kubernetes node or database in a temporary anonymous demo simulation (marked critical, not removed). Targeted database quick failures are bounded and reversible; with no serving database at positive load, simulation.step reports 100% errors, zero goodput and errorBreakdown.dbFailure: 100. simulation.recover_resource can restore the database early. An AWS Aurora writer with characteristics.auroraStandbyResourceId pointing to a healthy related replicaOf database has an opt-in modeled failover: the first step is unavailable, the second shows the standby serving without a residual writer-outage penalty. MultiAz or an unrelated second database alone does not establish a standby. Read metrics.databases[].auroraFailover and the promotion event for the failed and standby IDs and success, plus errorRate and throughput. Each quick step is one modeled simulation second, so second-step promotion is one second after injection. Chaos database_crash samples every 10 seconds and defaults to a 30-second promotion and a 1800-second sole-writer restart after its injection duration; compare matching phases, not equal step indices or wall-clock times. These are deterministic assumptions, not observed AWS behavior. No API key required for this temporary anonymous demo operation. Exact targeting: pass resourceName (human-readable name, e.g. 'app-server-01'; exact match preferred, an unambiguous prefix is accepted) or resourceId to fail a specific resource — including an individual named instance, not only a group. If resourceName matches multiple resources the call fails with a 400 listing every matching candidate by name — retry with one exact name (or its resourceId) from that list. The database must be healthy; an already failed database returns a 400 describing its current status. When neither parameter is supplied, a RANDOM healthy compute/Kubernetes node is selected (not a database) — this path is non-deterministic and NOT suitable for controlled scenarios or replay; always target by name/id when reproducing a precise fault sequence. The response always echoes the applied outcome via resolvedResourceId, resolvedResourceName, and previousHealth (populated from the selected resource on the random path too). Network, storage, cache, queue, and security resource types are not supported by quick injection. For typed database_overload use authenticated failure.create (unavailable anonymously); instance_kill PERMANENTLY removes the instance — failure.delete does not restore it; use instance_down instead for a reversible single-node outage. Returns the updated resource list and the failure event that was logged. The likely next tool is simulation.step to observe how the architecture degrades under failure, then simulation.metrics to review the health impact. Do not use it to advance simulation time — that is simulation.step. Pass simulationId from simulation.create when this call is made from a fresh MCP session; otherwise you may omit it to target the current simulation in the preserved MCP session. Authenticate with an API key to unlock all 63 tools including typed durational failures and chaos engineering.

Parameters3

simulationId	string	optional	Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link.
resourceName	string	optional	Optional: name of the resource to fail (exact match preferred; unambiguous prefix accepted). Ambiguous names return a 400 with a candidate list.
resourceId	string	optional	Optional: ID of the resource to fail. Takes precedence over resourceName.

Raw schema

{
  "type": "object",
  "properties": {
    "simulationId": {
      "type": "string",
      "description": "Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link."
    },
    "resourceName": {
      "type": "string",
      "description": "Optional: name of the resource to fail (exact match preferred; unambiguous prefix accepted). Ambiguous names return a 400 with a candidate list."
    },
    "resourceId": {
      "type": "string",
      "description": "Optional: ID of the resource to fail. Takes precedence over resourceName."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

simulation.recover_resource

Recover one reversible failed resource in a temporary anonymous demo simulation. No API key required for this temporary anonymous demo operation. Lower traffic to a serviceable level first, then provide resourceId or resourceName from simulation.create, simulation.step, or simulation.metrics. This deactivates applicable instance_down/database_overload failures for only the selected resource and returns recoveryProgress with parked, cooling_down, or healthy state plus cooldown counters. It cannot restore an instance_kill because that failure permanently removes the resource. The likely next tool is simulation.step; keep stepping and inspect the targeted resource until recoveryProgress.state is healthy. Pass simulationId from simulation.create when using a fresh MCP session; a preserved session may omit it. Authenticate with an API key to unlock all 63 tools and unlimited simulations.

Parameters3

simulationId	string	optional	Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link.
resourceName	string	optional	Exact case-insensitive name of the failed resource to recover
resourceId	string	optional	ID of the failed resource to recover

Raw schema

{
  "type": "object",
  "properties": {
    "simulationId": {
      "type": "string",
      "description": "Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link."
    },
    "resourceName": {
      "type": "string",
      "description": "Exact case-insensitive name of the failed resource to recover"
    },
    "resourceId": {
      "type": "string",
      "description": "ID of the failed resource to recover"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

simulation.delete

Permanently delete an owned temporary anonymous demo simulation and its metrics, events, failures, and capability. This is the explicit way to free a simulation slot; deletion is irreversible, while the existing demo TTL remains the safety net for abandoned simulations. Prerequisite: a simulationId from simulation.create, or an active simulation in the preserved MCP session. The likely next tool is simulation.create to use the freed slot. A successful response is { deleted: true, id }; failed ownership checks do not delete or revoke anything. Authenticate with an API key to unlock all 63 tools and persistent simulation management.

Parameters1

simulationId

string

optional

Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link.

Raw schema

{
  "type": "object",
  "properties": {
    "simulationId": {
      "type": "string",
      "description": "Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

scenario.list

List the built-in demo scenarios as compact catalog cards — stable IDs, title/name, description, difficulty, tags, category, duration, provider summary, resource/connection counts, named active/optional traffic phases, and retry-workload disclosure. Use it as the first call when you want a ready-made architecture instead of designing one; the cards intentionally omit resource, connection, traffic-pattern, and failure-injection graphs. Anonymous discovery includes only scenarios with at most 10 resources so every listed card is demo-creatable. No prerequisites. Optionally narrow discovery with provider, category, and/or difficulty filters; omit them to receive the complete demo-creatable catalog. Pass a returned id as scenarioId to simulation.create for server-side expansion, or pass it to scenario.get when you need to inspect the full graph. Larger scenarios require an authenticated session. Returns named activeFailurePhases and optionalFailurePhases with type, resource/zone target, severity, and step range. No API key required. The likely next tool is scenario.get.

Parameters3

provider	string	optional	Only scenarios that include resources from this cloud provider
category	string	optional	Only scenarios in this category, such as scaling, failure, reliability, networking, or cost
difficulty	string	optional	Only scenarios at this difficulty level

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "aws",
        "gcp",
        "azure",
        "oci",
        "digitalocean"
      ],
      "description": "Only scenarios that include resources from this cloud provider"
    },
    "category": {
      "type": "string",
      "minLength": 1,
      "description": "Only scenarios in this category, such as scaling, failure, reliability, networking, or cost"
    },
    "difficulty": {
      "type": "string",
      "enum": [
        "beginner",
        "intermediate",
        "advanced"
      ],
      "description": "Only scenarios at this difficulty level"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

scenario.get

Hydrate one built-in scenario from the live Cloud World Model scenario library. Prerequisite: a scenario id returned by scenario.list. Returns the complete selected scenario graph, including resources and connections plus optional seed, resilienceConfig, protectedResilienceConfig, traffic/failure presets, named traffic-phase summaries, activeFailurePhases and optionalFailurePhases (type, resource/zone target, severity, step range), retry-workload disclosure, and real-world incident metadata. The response includes both title and name for compatibility; pass resources and connections, and optionally seed/resilienceConfig, to simulation.create when you need to edit or inspect the graph. For the shorter handoff, pass the id as scenarioId instead. The likely next tool is simulation.create.

Parameters1

scenarioId

string

required

Scenario identifier returned by scenario.list

Raw schema

{
  "type": "object",
  "properties": {
    "scenarioId": {
      "type": "string",
      "minLength": 1,
      "description": "Scenario identifier returned by scenario.list"
    }
  },
  "required": [
    "scenarioId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

simulation.create

Create a temporary anonymous demo cloud simulation from a list of resources and connections (max 2 active simulations per client, up to 10 resources; the returned simulationId is a short-lived unguessable capability that survives MCP transport teardown, but it is cleaned up when the demo lifetime expires or the simulation is deleted). No API key required for this temporary anonymous demo operation. Built-in scenario workflow: call `scenario.list` and pass a returned card's `id` as `scenarioId` to `simulation.create` for server-side graph expansion. For full control, call `scenario.get` and pass its hydrated `resources` and `connections` arrays instead. These are two alternatives — do not send `scenarioId` with `resources` or `connections`. When copying a scenario graph that returns `autoscalingConfig`, pass that config to `simulation.create` too so its thresholds and cooldown are preserved. For the catalog EKS Spot Interruption Migration scenario, you may set `scenarioOverrides: { eksSpotInterruption: { startupSeconds } }` with an integer startupSeconds from 0 through 3600 to test a different readiness deadline without copying the graph; this override requires scenarioId and is mutually exclusive with resources and connections. For the Web App Autoscaling scenario, create with `scenarioId: "web-autoscaling"` and `scenarioOverrides: { webAutoscaling: { includeTrafficRecovery: true } }` to activate the optional Traffic Recovery ramp and observe scale-in. `includeTrafficRecovery` is optional and defaults to false, leaving the phase inactive. Opt in before the first simulation.step because replay identity is finalized when stepping starts. This override also requires scenarioId and is mutually exclusive with resources and connections. For the Redis Cache Crash & Recovery scenario, create with `scenarioId: "redis-cache-crash-recovery"` and `scenarioOverrides: { redisCacheCrashRecovery: { cacheableRequestShare: 0.8, cacheHitRate: 0.8 } }` to set the request share sent to Redis and the configured hit rate among those requests (both fractions from 0 to 1; defaults are 0.8). The selected values are per-simulation and appear in normalizedConfig and per-step requestFlow metrics; they do not change the catalog scenario. `scenario.list` returns graph-free cards with bounded active/optional traffic-phase and retry-workload summaries; it is not a source of resource, connection, traffic-pattern, or failure-injection graphs. Scenario traffic and failure presets are not applied automatically. Use resilienceConfig.externalMetrics for deterministic sampled recommendations: no_ready_endpoints is successful zero only when its trigger sets noReadyEndpointsAsZero:true; discovery_error and fetch_error always remain errors. This is not a KEDA/provider actuator and does not change resource counts. Use it to start any simulation workflow — either with hydrated resources and connections from scenario.get or your own architecture. Do not use it to modify an existing simulation (use simulation.inject_traffic to change load). For the exact owned typical fit, set appWeight:'typical', location.regionKey:'us-east-2' on all four AWS nodes, one ALB with serviceFamily:'alb' and loadBalancerScheme:'internal', two m5.large compute apps with workload:'crud-typical', appRuntime:'node', appWorkerCount:2, appDbPoolSize:250, one db.r5.large MySQL with workloadDatabaseEngine:'mysql', workloadDatabaseVersion:'8.0', maxConnections:500, ALB→each app→DB connections, minInstances=maxInstances=2, autoscaling:false, traffic 20–300 RPS. Only typical-fit-20, typical-fit-100 and typical-fit-200 tuned the typical-v1-20260927c/6aa574d7ff9d3080b88b221bcd59f7d218ae37f0 fit; 300 is an independent holdout and 500 is diagnostic only. Other typical workloads are modeled, not owned. P99 has distinct per-percentile provenance: latencyP99Basis identifies the owned in-VPC internal-ALB fit, a scaled-from-fit estimate (not directly measured), or an uncalibrated generic model. On the exact healthy lean owned graph at 10–1,000 offered target RPS, P99=max(final P95, 7.021919127633514 + 0.0002

Parameters22

name	string	required	Human-readable name for the simulation
appWeight	string	optional	Immutable root-level workload weight; defaults to typical with appWeightDefaulted=true. Lean is measured only for the eligible owned graph; heavy is an unsupported assumption. predictionEvidence reports per-quantity provenance and assumption ranges, not confidence intervals.
description	string	optional	Optional description of the simulation's purpose
scenarioId	string	optional	Live scenario identifier from scenario.list; mutually exclusive with resources and connections
scenarioOverrides	any	optional	Scenario-only customization; requires scenarioId and exactly one supported override. Redis cache assumptions affect only this simulation.
resources	array	optional	List of cloud resources composing this simulation. For a built-in scenario, pass the hydrated resources from scenario.get; scenario.list cards are graph-free. (max 10 in demo mode; mutually exclusive with scenarioId)
connections	array	optional	Directed connections between resources. For a built-in scenario, pass the hydrated connections from scenario.get; scenario.list cards are graph-free. Directed edges should describe traffic flow between resources; omit when using scenarioId.
traffic	number	optional	Initial traffic in requests per second (RPS)
seed	integer	optional	Deterministic RNG seed for reproducible replays
autoscalingConfig	object	optional	Simulation autoscaling thresholds and cooldown. Pass the value from scenario.get when creating from a copied scenario graph.
maxInstances	integer	optional	Hard ceiling on the autoscaled compute fleet size, stored as autoscalingConfig.maxInstances. If omitted, the provider default applies (AWS 50, GCP 15, Azure/OCI/DigitalOcean 10) — which may be much larger than your intended fleet size.
minInstances	integer	optional	Floor on the autoscaled compute fleet size, stored as autoscalingConfig.minInstances.
autoscalingTargetCpu	number	optional	Canonical CPU HPA scale-out target percent. CWM synthesizes unrelated autoscaling defaults.
scaleOutCpuThreshold	number	optional	Equivalent alias for autoscalingTargetCpu; if both are sent they must match.
scaleOutCpuPercent	number	optional	Grok-compatible alias for the CPU HPA scale-out target; if multiple target names are sent they must match.
autoscaleTargetCpuPercent	number	optional	Grok-compatible alias for the CPU HPA scale-out target; if multiple target names are sent they must match.
ecsCpuTargetTracking	boolean	optional	Opt into CPU-only ECS Fargate target tracking.
scaleOutCooldownSeconds	integer	optional	ECS CPU target-tracking scale-out cooldown in simulated seconds.
scaleInCooldownSeconds	integer	optional	ECS CPU target-tracking scale-in cooldown in simulated seconds.
simulationSecondsPerStep	number	optional	Simulated seconds per step for ECS cooldowns (default 1).
resilienceConfig	object	optional	Optional retry/cascade resilience model returned by scenario.get. externalMetrics accepts deterministic sampled triggers; no_ready_endpoints is successful zero only when noReadyEndpointsAsZero:true, while discovery_error and fetch_error remain errors. This recommendation model does not actuate KEDA, providers, or simulated resource counts.
responseMode	string	optional	Response detail level. 'compact' (default) returns id, name, status, traffic, and a per-resource summary (id, name, status, cpuPercent) — keeps the response small for agent loops. 'full' returns the complete simulation object including all resource characteristics and connections.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 120,
      "description": "Human-readable name for the simulation"
    },
    "appWeight": {
      "type": "string",
      "enum": [
        "lean",
        "typical",
        "heavy"
      ],
      "description": "Immutable root-level workload weight; defaults to typical with appWeightDefaulted=true. Lean is measured only for the eligible owned graph; heavy is an unsupported assumption. predictionEvidence reports per-quantity provenance and assumption ranges, not confidence intervals."
    },
    "description": {
      "type": "string",
      "maxLength": 500,
      "description": "Optional description of the simulation's purpose"
    },
    "scenarioId": {
      "type": "string",
      "minLength": 1,
      "description": "Live scenario identifier from scenario.list; mutually exclusive with resources and connections"
    },
    "scenarioOverrides": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "eksSpotInterruption": {
              "type": "object",
              "properties": {
                "startupSeconds": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 3600
                }
              },
              "required": [
                "startupSeconds"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "eksSpotInterruption"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "webAutoscaling": {
              "type": "object",
              "properties": {
                "includeTrafficRecovery": {
                  "type": "boolean",
                  "default": false
                }
              },
              "additionalProperties": false
            }
          },
          "required": [
            "webAutoscaling"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "redisCacheCrashRecovery": {
              "type": "object",
              "properties": {
                "cacheableRequestShare": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1,
                  "description": "Fraction of offered requests sent to Redis (0–1; the scenario default is 0.8)."
                },
                "cacheHitRate": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1,
                  "description": "Configured hit rate among requests sent to Redis (0–1; the scenario default is 0.8)."
                }
              },
              "required": [
                "cacheableRequestShare",
                "cacheHitRate"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "redisCacheCrashRecovery"
          ],
          "additionalProperties": false
        }
      ],
      "description": "Scenario-only customization; requires scenarioId and exactly one supported override. Redis cache assumptions affect only this simulation."
    },
    "resources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for this resource within the simulation"
          },
          "type": {
            "type": "string",
            "enum": [
              "compute",
              "database",
              "storage",
              "network",
              "cache",
              "queue",
              "kubernetes"
            ],
            "description": "Resource category"
          },
          "name": {
            "type": "string",
            "description": "Display name for the resource"
          },
          "minAcu": {
            "description": "Not accepted at resource level; use characteristics.minAcu for the exact AWS Aurora Serverless v2 db.serverless shape."
          },
          "maxAcu": {
            "description": "Not accepted at resource level; use characteristics.maxAcu for the exact AWS Aurora Serverless v2 db.serverless shape."
          },
          "provider": {
            "type": "string",
            "enum": [
              "aws",
              "gcp",
              "azure",
              "oci",
              "digitalocean"
            ],
            "default": "aws",
            "description": "Cloud provider hosting this resource"
          },
          "location": {
            "type": "object",
            "properties": {
              "regionKey": {
                "type": "string"
              },
              "zoneKey": {
                "type": "string"
              },
              "localityType": {
                "type": "string",
                "enum": [
                  "az",
                  "zone",
                  "availability_domain",
                  "fault_domain"
                ]
              },
              "providerLabel": {
                "type": "string"
              },
              "faultDomainKey": {
                "type": "string"
              }
            },
            "required": [
              "regionKey"
            ],
            "additionalProperties": false,
            "description": "Resource region; set location.regionKey:'us-east-2' on each owned typical node (normalized to use2)."
          },
          "recoveryPolicy": {
            "type": "object",
            "properties": {
              "criticalCpuThreshold": {
                "type": "number",
                "minimum": 0,
                "maximum": 100
              },
              "criticalSteps": {
                "type": "integer",
                "minimum": 1
              },
              "warningCpuThreshold": {
                "type": "number",
                "minimum": 0,
                "maximum": 100
              },
              "warningSteps": {
                "type": "integer",
                "minimum": 1
              },
              "failureParkSteps": {
                "type": "integer",
                "minimum": 1
              }
            },
            "additionalProperties": false,
            "description": "Optional recovery thresholds and cooldown lengths for this resource"
          },
          "characteristics": {
            "type": "object",
            "properties": {
              "size": {
                "type": "string",
                "description": "Instance or SKU size (e.g. 't3.medium', 'db.r5.large')"
              },
              "workload": {
                "type": "string",
                "enum": [
                  "crud",
                  "crud-typical"
                ],
                "description": "Explicit 'crud-typical' on each owned typical app; 'crud' selects lean identity on the exact lean graph."
              },
              "appRuntime": {
                "type": "string",
                "description": "Owned typical app runtime: node."
              },
              "appWorkerCount": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "description": "Owned typical: 2 workers on each app."
              },
              "appDbPoolSize": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "description": "Owned typical: pool size 250 on each app."
              },
              "workloadDatabaseEngine": {
                "type": "string",
                "enum": [
                  "mysql"
                ],
                "description": "MySQL workload identity on the db.r5.large database."
              },
              "workloadDatabaseVersion": {
                "type": "string",
                "description": "Owned typical MySQL workload version: 8.0."
              },
              "loadBalancerScheme": {
                "type": "string",
                "enum": [
                  "internal",
                  "internet-facing"
                ],
                "description": "Owned typical ALB scheme: internal."
              },
              "ocpus": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 126,
                "description": "OCI flexible compute shape capacity. Family-specific limits are validated against the provider shape; VM.Standard.E4.Flex accepts 1–64 OCPUs and 1 OCPU = 2 vCPUs. Not a performance or price claim."
              },
              "capacityRps": {
                "type": "number",
                "exclusiveMinimum": 0,
                "description": "Compute only: literal per-node RPS ceiling at which CPU reaches ~95%. Kubernetes rejects capacityRps; use maxThroughput for its total cluster ceiling."
              },
              "maxThroughput": {
                "type": "number",
                "description": "Kubernetes: total cluster RPS ceiling; compute: legacy internal throughput scaling parameter (prefer capacityRps for compute)."
              },
              "maxConnections": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 1000000,
                "description": "Fixed concurrent DB connection budget; Aurora Serverless defaults from maximum configured ACU."
              },
              "cdnTraffic": {
                "type": "object",
                "properties": {
                  "cacheableFraction": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1
                  },
                  "cacheableMissDatabaseFraction": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1
                  },
                  "dynamicDatabaseFraction": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1
                  }
                },
                "required": [
                  "cacheableFraction",
                  "cacheableMissDatabaseFraction",
                  "dynamicDatabaseFraction"
                ],
                "additionalProperties": false,
                "description": "Assumed CDN cacheable/dynamic request mix and DB-query fractions. cacheHitRate applies only to the cacheable share. Read simulation.step metrics.cdnFlow for the modeled edge, origin and database flow."
              },
              "cacheHitRate": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              "sessionAffinity": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "const": "sticky"
                  },
                  "fleetId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "initialSessions": {
                    "type": "number",
                    "minimum": 0,
                    "default": 100
                  },
                  "arrivalsPerStep": {
                    "type": "number",
                    "minimum": 0,
                    "default": 0
                  },
                  "meanLifetimeSteps": {
                    "type": "number",
                    "minimum": 1,
                    "default": 300
                  },
                  "requestsPerSessionPerSecond": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "default": 1
                  },
                  "maxSessionsPerOwner": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "default": 1000
                  },
                  "reconnect": {
                    "type": "string",
                    "enum": [
                      "none",
                      "next-step"
                    ],
                    "default": "none"
                  },
                  "workload": {
                    "type": "object",
                    "properties": {
                      "replicas": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 10000
                      },
                      "minReplicas": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 10000
                      },
                      "maxReplicas": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 10000
                      },
                      "targetCpuPercent": {
                        "type": "number",
                        "minimum": 1,
                        "maximum": 100,
                        "default": 70
                      },
                      "capacityRpsPerReplica": {
                        "type": "number",
                        "exclusiveMinimum": 0
                      },
                      "autoscaling": {
                        "type": "boolean",
                        "default": true
                      }
                    },
                    "required": [
                      "replicas",
                      "minReplicas",
                      "maxReplicas",
                      "capacityRpsPerReplica"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "mode",
                  "fleetId"
                ],
                "additionalProperties": false,
                "description": "Opt-in modeled sticky owners for generic compute; Kubernetes requires explicit workload replicas independent of nodes. Use identical fleetId/config on compute peers. Existing sessions do not migrate on scale-out; owner loss disconnects them. reconnect:'next-step' explicitly enables rebinding; default none. Session arrivals/lifetime are assumptions, not measured OpenShell data. Read full step metrics.sessionAffinity for per-owner load, rejects and disconnects."
              },
              "connectionDemand": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "enum": [
                      "load-derived",
                      "declared",
                      "max"
                    ],
                    "description": "load-derived keeps the legacy traffic estimate; declared uses only the plan-time declaredConnections/idlePoolFloor; max uses the greatest of load-derived and declared/floor demand."
                  },
                  "declaredConnections": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000,
                    "description": "ASSUMPTION / plan-time peak pool budget (for example, replicas × per-pod pool size), not an observed live connection count."
                  },
                  "idlePoolFloor": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000,
                    "description": "ASSUMPTION / plan-time minimum idle pool footprint, not an observed live connection count."
                  }
                },
                "required": [
                  "mode"
                ],
                "additionalProperties": false,
                "description": "Database only. Omit to preserve legacy load-derived connection use. `declared` and `max` require declaredConnections and/or idlePoolFloor. Demand above usable maxConnections adds a bounded rule-based pool-saturation error signal, not a provider-calibrated rate."
              },
              "multiAz": {
                "type": "boolean",
                "description": "AWS Aurora Serverless v2: true with instanceCount:2 creates a billable reader in a second AZ."
              },
              "instanceCount": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100,
                "description": "Generic fixed compute: represented VM count (integer 1–100); capacity aggregates and CPU is per VM. Cannot combine with autoscaling:true, minInstances, or maxInstances. AWS Aurora Serverless v2 remains 1 with multiAz:false or 2 with multiAz:true."
              },
              "minCapacity": {
                "type": "number",
                "exclusiveMinimum": 0,
                "description": "Aurora Serverless minimum ACU (flat form; nested config wins)."
              },
              "maxCapacity": {
                "type": "number",
                "exclusiveMinimum": 0,
                "description": "Aurora Serverless maximum ACU (flat form; nested config wins)."
              },
              "minAcu": {
                "type": "number",
                "exclusiveMinimum": 0,
                "description": "Flat minimum ACU alias only for AWS Aurora Serverless v2 size db.serverless; conflicts with minCapacity are rejected."
              },
              "maxAcu": {
                "type": "number",
                "exclusiveMinimum": 0,
                "description": "Flat maximum ACU alias only for AWS Aurora Serverless v2 size db.serverless; conflicts with maxCapacity are rejected."
              },
              "config": {
                "type": "object",
                "properties": {
                  "minCapacity": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "maxCapacity": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  }
                },
                "additionalProperties": true,
                "description": "Aurora Serverless ACU bounds. Nested config uses minCapacity/maxCapacity; flat characteristics.minAcu/maxAcu aliases are accepted only on the exact AWS Aurora Serverless v2 db.serverless shape."
              },
              "autoscaling": {
                "type": "boolean",
                "description": "Mark this compute resource as the autoscaling primary target"
              },
              "billingState": {
                "type": "string",
                "enum": [
                  "active",
                  "idle",
                  "stopped",
                  "detached",
                  "deleted"
                ],
                "description": "Billing state: 'stopped' bills storage only, 'idle'/'detached' bill flat idle rates, 'deleted' bills nothing. Default 'active'."
              },
              "serviceFamily": {
                "type": "string",
                "description": "Idle-billed service family (e.g. 'nat-gateway', 'vpc-endpoint', 'eip-detached', 'ebs-snapshot') — determines the flat idle rate"
              },
              "capacityGB": {
                "type": "number",
                "description": "Storage capacity in GB — drives per-GB snapshot/backup idle cost and stopped-instance storage cost"
              },
              "scaleOutCpuThreshold": {
                "type": "number",
                "minimum": 0,
                "maximum": 100,
                "description": "Compute or Kubernetes only — overrides the simulation-wide CPU HPA scale-out target (see the top-level autoscalingTargetCpu) for THIS resource's scale decisions only; every other resource keeps the simulation-wide default."
              },
              "scaleInCpuThreshold": {
                "type": "number",
                "minimum": 0,
                "maximum": 100,
                "description": "Compute or Kubernetes only — overrides the simulation-wide CPU HPA scale-in target for THIS resource's scale decisions only; every other resource keeps the simulation-wide default."
              },
              "kubernetesCpuHpa": {
                "type": "object",
                "properties": {
                  "cpuRequestMilliCores": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 100000
                  },
                  "cpuRequestEvidence": {
                    "type": "object",
                    "properties": {
                      "source": {
                        "type": "string",
                        "enum": [
                          "calibrated",
                          "external"
                        ]
                      },
                      "reference": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 512
                      }
                    },
                    "required": [
                      "source",
                      "reference"
                    ],
                    "additionalProperties": false
                  },
                  "cpuDemandMilliCoresPerRps": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 1000000
                  },
                  "cpuDemandEvidence": {
                    "$ref": "#/properties/resources/items/properties/characteristics/properties/kubernetesCpuHpa/properties/cpuRequestEvidence"
                  },
                  "cpuDemandCalibration": {
                    "type": "object",
                    "properties": {
                      "method": {
                        "type": "string",
                        "const": "least-squares-through-origin"
                      },
                      "reviewed": {
                        "type": "boolean",
                        "const": true
                      },
                      "measurements": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "rps": {
                              "type": "number",
                              "exclusiveMinimum": 0,
                              "maximum": 1000000
                            },
                            "cpuMilliCores": {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1000000000
                            }
                          },
                          "required": [
                            "rps",
                            "cpuMilliCores"
                          ],
                          "additionalProperties": false
                        },
                        "minItems": 2,
                        "maxItems": 100
                      }
                    },
                    "required": [
                      "method",
                      "reviewed",
                      "measurements"
                    ],
                    "additionalProperties": false
                  },
                  "targets": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "Utilization"
                            },
                            "targetPercent": {
                              "type": "number",
                              "exclusiveMinimum": 0,
                              "maximum": 1000
                            }
                          },
                          "required": [
                            "type",
                            "targetPercent"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "AverageValue"
                            },
                            "targetMilliCores": {
                              "type": "number",
                              "exclusiveMinimum": 0,
                              "maximum": 100000
                            }
                          },
                          "required": [
                            "type",
                            "targetMilliCores"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 2
                  },
                  "replicas": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "minReplicas": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "maxReplicas": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "scaleDownStabilizationSteps": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  }
                },
                "required": [
                  "cpuDemandMilliCoresPerRps",
                  "targets",
                  "replicas",
                  "minReplicas",
                  "maxReplicas"
                ],
                "additionalProperties": false,
                "description": "Opt-in bounded workload-pod replica model, separate from node-pool scaling. Declare CPU demand in millicores/RPS and targets (Utilization requires an explicit CPU request). A reviewed cpuDemandCalibration may include 2–100 offered-RPS/aggregate-mCPU points and must match the explicit demand value; cite its source and reference in cpuDemandEvidence. Unannotated request/demand inputs are ASSUMED; no HPA controller parity is claimed."
              }
            },
            "additionalProperties": true,
            "description": "Capacity and sizing characteristics for the resource (extra keys such as costMultiplier pass through unchanged)"
          }
        },
        "required": [
          "id",
          "type",
          "name"
        ],
        "additionalProperties": false
      },
      "description": "List of cloud resources composing this simulation. For a built-in scenario, pass the hydrated resources from scenario.get; scenario.list cards are graph-free. (max 10 in demo mode; mutually exclusive with scenarioId)"
    },
    "connections": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sourceId": {
            "type": "string",
            "description": "ID of the source (upstream) resource"
          },
          "targetId": {
            "type": "string",
            "description": "ID of the target (downstream) resource"
          },
          "label": {
            "type": "string",
            "description": "Optional label describing the connection type"
          }
        },
        "required": [
          "sourceId",
          "targetId"
        ],
        "additionalProperties": false
      },
      "description": "Directed connections between resources. For a built-in scenario, pass the hydrated connections from scenario.get; scenario.list cards are graph-free. Directed edges should describe traffic flow between resources; omit when using scenarioId."
    },
    "traffic": {
      "type": "number",
      "default": 0,
      "description": "Initial traffic in requests per second (RPS)"
    },
    "seed": {
      "type": "integer",
      "minimum": 0,
      "description": "Deterministic RNG seed for reproducible replays"
    },
    "autoscalingConfig": {
      "type": "object",
      "properties": {
        "scaleOutCpuThreshold": {
          "type": "number"
        },
        "scaleInCpuThreshold": {
          "type": "number"
        },
        "scaleOutThroughputThreshold": {
          "type": "number"
        },
        "scaleInThroughputThreshold": {
          "type": "number"
        },
        "scaleOutLatencyThreshold": {
          "type": "number"
        },
        "cooldownSeconds": {
          "type": "number"
        },
        "ecsCpuTargetTracking": {
          "type": "boolean"
        },
        "scaleOutCooldownSeconds": {
          "type": "integer",
          "minimum": 0,
          "maximum": 86400
        },
        "scaleInCooldownSeconds": {
          "type": "integer",
          "minimum": 0,
          "maximum": 86400
        },
        "simulationSecondsPerStep": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 60
        },
        "minInstances": {
          "type": "number"
        },
        "maxInstances": {
          "type": "number"
        }
      },
      "required": [
        "scaleOutCpuThreshold",
        "scaleInCpuThreshold",
        "scaleOutThroughputThreshold",
        "scaleInThroughputThreshold",
        "scaleOutLatencyThreshold",
        "cooldownSeconds",
        "minInstances",
        "maxInstances"
      ],
      "additionalProperties": false,
      "description": "Simulation autoscaling thresholds and cooldown. Pass the value from scenario.get when creating from a copied scenario graph."
    },
    "maxInstances": {
      "type": "integer",
      "minimum": 1,
      "description": "Hard ceiling on the autoscaled compute fleet size, stored as autoscalingConfig.maxInstances. If omitted, the provider default applies (AWS 50, GCP 15, Azure/OCI/DigitalOcean 10) — which may be much larger than your intended fleet size."
    },
    "minInstances": {
      "type": "integer",
      "minimum": 1,
      "description": "Floor on the autoscaled compute fleet size, stored as autoscalingConfig.minInstances."
    },
    "autoscalingTargetCpu": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Canonical CPU HPA scale-out target percent. CWM synthesizes unrelated autoscaling defaults."
    },
    "scaleOutCpuThreshold": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Equivalent alias for autoscalingTargetCpu; if both are sent they must match."
    },
    "scaleOutCpuPercent": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Grok-compatible alias for the CPU HPA scale-out target; if multiple target names are sent they must match."
    },
    "autoscaleTargetCpuPercent": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Grok-compatible alias for the CPU HPA scale-out target; if multiple target names are sent they must match."
    },
    "ecsCpuTargetTracking": {
      "type": "boolean",
      "description": "Opt into CPU-only ECS Fargate target tracking."
    },
    "scaleOutCooldownSeconds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 86400,
      "description": "ECS CPU target-tracking scale-out cooldown in simulated seconds."
    },
    "scaleInCooldownSeconds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 86400,
      "description": "ECS CPU target-tracking scale-in cooldown in simulated seconds."
    },
    "simulationSecondsPerStep": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 60,
      "description": "Simulated seconds per step for ECS cooldowns (default 1)."
    },
    "resilienceConfig": {
      "type": "object",
      "properties": {
        "enabled": {
          "type": "boolean",
          "description": "Master switch for retry/cascade modeling"
        },
        "version": {
          "type": "number",
          "const": 1,
          "description": "Resilience model version"
        },
        "dependencies": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128,
                "description": "Unique dependency edge ID"
              },
              "sourceId": {
                "type": "string",
                "minLength": 1,
                "description": "Upstream resource ID"
              },
              "targetId": {
                "type": "string",
                "minLength": 1,
                "description": "Downstream resource ID"
              },
              "requestRatio": {
                "type": "number",
                "minimum": 0,
                "maximum": 20,
                "description": "Requests to target per original request"
              },
              "authRequestsPerAttempt": {
                "type": "number",
                "minimum": 0,
                "maximum": 10,
                "description": "Auth/token requests generated per dependency attempt"
              },
              "authDependencyId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128,
                "description": "Dependency receiving generated auth/token traffic"
              },
              "retryPolicy": {
                "type": "object",
                "properties": {
                  "maxRetries": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 8,
                    "description": "Maximum retries for this dependency edge (0 disables retries; default 2)."
                  },
                  "backoffMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 60000,
                    "description": "Initial retry backoff in milliseconds (default 100)."
                  },
                  "backoffMultiplier": {
                    "type": "number",
                    "minimum": 1,
                    "maximum": 10,
                    "description": "Exponential backoff multiplier (default 2)."
                  },
                  "jitterRatio": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "description": "Fractional backoff jitter from 0 to 1 (default 0.1)."
                  },
                  "timeoutMs": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 120000,
                    "description": "Per-attempt client deadline in milliseconds (default 2000); includes queue wait, service, and latency."
                  },
                  "retryBudgetRatio": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 10,
                    "description": "Retry RPS budget as a multiple of original edge RPS (default 2)."
                  },
                  "retryBudgetRps": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 500000,
                    "description": "Optional absolute retry RPS cap, also bounded by retryBudgetRatio."
                  },
                  "retryActorId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128,
                    "description": "Actor producing retries, such as a gateway or client"
                  }
                },
                "additionalProperties": false
              },
              "protection": {
                "type": "object",
                "properties": {
                  "circuitBreaker": {
                    "type": "object",
                    "properties": {
                      "enabled": {
                        "type": "boolean"
                      },
                      "failureRateThreshold": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "minimumRequests": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 100000
                      },
                      "openSteps": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 120
                      },
                      "halfOpenMaxRequests": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 10000
                      }
                    },
                    "additionalProperties": false
                  },
                  "rateLimitRps": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 500000
                  },
                  "loadShedding": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              },
              "capacity": {
                "type": "object",
                "properties": {
                  "maxRps": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 500000
                  },
                  "maxConcurrent": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 1000000
                  },
                  "meanServiceTimeMs": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 120000
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "id",
              "sourceId",
              "targetId"
            ],
            "additionalProperties": false
          },
          "maxItems": 64,
          "description": "Dependency edges with retry and protection policies"
        },
        "scheduledFaults": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128
              },
              "type": {
                "type": "string",
                "enum": [
                  "capacity_limit",
                  "concurrency_limit",
                  "latency",
                  "error_rate",
                  "traffic_surge"
                ],
                "description": "Fault type; traffic_surge increases root client demand"
              },
              "targetResourceId": {
                "type": "string"
              },
              "dependencyId": {
                "type": "string"
              },
              "startStep": {
                "type": "integer",
                "minimum": 0
              },
              "endStep": {
                "type": "integer",
                "minimum": 1
              },
              "capacityPercent": {
                "type": "number",
                "minimum": 0,
                "maximum": 100
              },
              "maxConcurrent": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 1000000
              },
              "addedLatencyMs": {
                "type": "number",
                "minimum": 0,
                "maximum": 120000
              },
              "errorRate": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              "trafficMultiplier": {
                "type": "number",
                "exclusiveMinimum": 1,
                "maximum": 20,
                "description": "traffic_surge demand multiplier"
              }
            },
            "required": [
              "id",
              "type",
              "startStep"
            ],
            "additionalProperties": false
          },
          "maxItems": 32,
          "description": "Scheduled capacity, error, latency, concurrency, or traffic-surge faults"
        },
        "scalingPolicies": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128
              },
              "dependencyId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128
              },
              "constrainedMetric": {
                "type": "string",
                "enum": [
                  "rps",
                  "concurrency"
                ]
              },
              "observationMetric": {
                "type": "string",
                "enum": [
                  "source_cpu",
                  "capacity_utilization"
                ]
              },
              "observedResourceId": {
                "type": "string",
                "minLength": 1
              },
              "scaleOutThresholdPercent": {
                "type": "number",
                "minimum": 1,
                "maximum": 100
              },
              "scaleOutCapacityMultiplier": {
                "type": "number",
                "minimum": 1,
                "maximum": 20
              }
            },
            "required": [
              "id",
              "dependencyId",
              "constrainedMetric",
              "observationMetric",
              "scaleOutThresholdPercent"
            ],
            "additionalProperties": false
          },
          "maxItems": 32,
          "description": "Capacity-observation policies, including intentional autoscaling blind spots"
        },
        "maxCascadeDepth": {
          "type": "integer",
          "minimum": 1,
          "maximum": 8
        },
        "maxGeneratedRps": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 500000
        },
        "maxStepWork": {
          "type": "integer",
          "minimum": 1,
          "maximum": 2048
        },
        "retryGeneratedTrafficAffectsCost": {
          "type": "boolean"
        },
        "externalMetrics": {
          "type": "object",
          "properties": {
            "errorMode": {
              "type": "string",
              "enum": [
                "drop_failed_trigger",
                "freeze_combined_decision"
              ]
            },
            "initialCapacity": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000
            },
            "minCapacity": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            },
            "maxCapacity": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10000,
              "default": 100
            },
            "triggers": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "targetValue": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "minimum": 0.000001,
                    "maximum": 1000000000
                  },
                  "noReadyEndpointsAsZero": {
                    "type": "boolean",
                    "default": false
                  },
                  "samples": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "step": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 100000
                            },
                            "status": {
                              "type": "string",
                              "const": "value"
                            },
                            "value": {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1000000000
                            }
                          },
                          "required": [
                            "step",
                            "status",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "step": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 100000
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "no_ready_endpoints",
                                "discovery_error",
                                "fetch_error"
                              ]
                            }
                          },
                          "required": [
                            "step",
                            "status"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 120
                  }
                },
                "required": [
                  "id",
                  "targetValue",
                  "samples"
                ],
                "additionalProperties": false
              },
              "minItems": 1,
              "maxItems": 16
            }
          },
          "required": [
            "errorMode",
            "initialCapacity",
            "triggers"
          ],
          "additionalProperties": false,
          "description": "Deterministic per-trigger recommendation inputs. A no_ready_endpoints sample is a successful zero only when that trigger sets noReadyEndpointsAsZero:true; discovery_error and fetch_error always remain errors. This is not a KEDA/provider actuator and does not change resource counts."
        }
      },
      "additionalProperties": false,
      "description": "Optional retry/cascade resilience model returned by scenario.get. externalMetrics accepts deterministic sampled triggers; no_ready_endpoints is successful zero only when noReadyEndpointsAsZero:true, while discovery_error and fetch_error remain errors. This recommendation model does not actuate KEDA, providers, or simulated resource counts."
    },
    "responseMode": {
      "type": "string",
      "enum": [
        "compact",
        "full"
      ],
      "default": "compact",
      "description": "Response detail level. 'compact' (default) returns id, name, status, traffic, and a per-resource summary (id, name, status, cpuPercent) — keeps the response small for agent loops. 'full' returns the complete simulation object including all resource characteristics and connections."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

simulation.step

Advance a temporary anonymous demo simulation by one time step and return updated metrics — CPU, latency, throughput, error rate, cost (max 20 persisted steps per demo). Concurrent simulation.step calls on one simulation either serialize as distinct consecutive steps (in the browser Workspace queue) or receive HTTP 409 simulation_step_in_progress without advancing or consuming a demo credit. Wait for the running call to finish, then retry only rejected calls; distinct simulations can run concurrently. After a timeout, inspect simulation.metrics before retrying an uncertain result. Use it to observe how the architecture behaves over time, typically right after simulation.create or simulation.inject_traffic. Do not use it to read current state without advancing time — that is simulation.metrics. Pass the simulationId returned by simulation.create when your connector opens a fresh MCP session; preserve Mcp-Session-Id to use the omitted-ID current-simulation default. The likely next tool is simulation.step again (to keep observing) or simulation.inject_traffic (to change load first). Responses are compact by default: principal metrics plus per-resource status (id, name, status, cpuPercent, routedRps, availabilityState, isRoutable, and recoveryBlockedReason when provided) and this step's events. Seeded characteristics.eksSpotInterruption telemetry retains its additive migrationEvaluation beside the interruption lifecycle: use its recorded/derived/unavailable field provenance, frozen deadline verdict/counts/reasons, and simulation-clock milestones rather than final service health. The distinct eksSpotMigration contract remains separately reported when configured. Compact responses also include errorBreakdown when the engine provides it. A critical resource with isRoutable: true is degraded but still serving; unavailable identifies a failed or parked node, while scaled_to_zero and cold_start identify Fargate no-task states. Pass responseMode: 'full' to get the complete simulation state instead. During recovery, each resource may include recoveryProgress with state parked, cooling_down, or healthy, plus parkWindow and cooldown counters. Poll simulation.step until the targeted resource's recoveryProgress.state is healthy, then use simulation.metrics to inspect the resulting state and metrics. GPU / inference workflow: when the simulation includes a kubernetes resource with characteristics.inferenceMode: true, each step response also includes gpuUtilization (%), tokensPerSecond, costPerMillionTokens (USD/M tokens), idleGpuCostPerHour (USD/hr of standby GPU spend), and idleGpuFraction (0-1 idle HA overhead share) so you can track inference economics step by step. Authenticate with an API key for unlimited steps and GPU right-sizing hints.

Parameters2

simulationId	string	optional	Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link.
responseMode	string	optional	Response detail level. 'compact' (default) returns only principal metrics, errorBreakdown when available, per-resource status (id, name, status, cpuPercent, routedRps, availabilityState, isRoutable, recoveryBlockedReason, and failureLifecycle/routingState when provided), and this step's events — keeps observations small for agent loops. 'full' returns the complete backend step response including the entire simulation object with all resource characteristics and connections.

Raw schema

{
  "type": "object",
  "properties": {
    "simulationId": {
      "type": "string",
      "description": "Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link."
    },
    "responseMode": {
      "type": "string",
      "enum": [
        "compact",
        "full"
      ],
      "default": "compact",
      "description": "Response detail level. 'compact' (default) returns only principal metrics, errorBreakdown when available, per-resource status (id, name, status, cpuPercent, routedRps, availabilityState, isRoutable, recoveryBlockedReason, and failureLifecycle/routingState when provided), and this step's events — keeps observations small for agent loops. 'full' returns the complete backend step response including the entire simulation object with all resource characteristics and connections."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

simulation.metrics

Read the latest metrics and resource states for a temporary anonymous demo simulation: latency, CPU, throughput, error rate, cost per hour, and per-resource health. Use it to inspect current state and metrics history without advancing time; do not use it to move the simulation forward — that is simulation.step. Responses are compact by default: principal current metrics plus explicit modeled goodputRps (a post-step point rate sourced from throughput, with provenance), goodputWindow (recorded only from persisted simulation-clock bounds, otherwise unavailable with provenance; never derive it from retrieval time or currentStep), errorBreakdown when available, per-resource status (id, name, status, cpuPercent, routedRps, availabilityState, isRoutable, and recoveryBlockedReason when provided), seeded EKS Spot checkpoint history and migrationEvaluationComplete/provenance when present, and the last 10 metrics-history entries. Pass responseMode: 'full' to get the complete simulation state, normalizedConfig, and full metrics history instead. During recovery, each resource may include recoveryProgress.state (parked, cooling_down, or healthy) with parkWindow and cooldown counters; poll simulation.step until healthy, then use simulation.metrics to inspect the resulting state and metrics. GPU / inference workflow: when the simulation includes a kubernetes resource with characteristics.inferenceMode: true, the response also includes top-level gpuUtilization (%), tokensPerSecond, costPerMillionTokens (USD/M tokens), idleGpuCostPerHour (USD/hr of standby GPU spend), and idleGpuFraction (0-1 idle HA overhead share) from the latest step, and each history entry carries the same inference fields. Pass the simulationId returned by simulation.create when your connector opens a fresh MCP session; preserve Mcp-Session-Id to use the omitted-ID current-simulation default. A fresh session has no current-simulation pointer. At least one simulation.step is needed for meaningful metrics. Read-only; repeated calls may be subject to demo usage limits. The likely next tool is simulation.step or simulation.inject_traffic.

Parameters2

simulationId	string	optional	Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link.
responseMode	string	optional	Response detail level. 'compact' (default) returns principal current metrics, errorBreakdown when available, per-resource status (id, name, status, cpuPercent, routedRps, availabilityState, isRoutable, recoveryBlockedReason, and failureLifecycle/routingState when provided), and only the last 10 metrics-history entries — keeps polling cheap for agent loops. 'full' returns the complete simulation object (all resource characteristics and connections) plus the entire metrics history.

Raw schema

{
  "type": "object",
  "properties": {
    "simulationId": {
      "type": "string",
      "description": "Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link."
    },
    "responseMode": {
      "type": "string",
      "enum": [
        "compact",
        "full"
      ],
      "default": "compact",
      "description": "Response detail level. 'compact' (default) returns principal current metrics, errorBreakdown when available, per-resource status (id, name, status, cpuPercent, routedRps, availabilityState, isRoutable, recoveryBlockedReason, and failureLifecycle/routingState when provided), and only the last 10 metrics-history entries — keeps polling cheap for agent loops. 'full' returns the complete simulation object (all resource characteristics and connections) plus the entire metrics history."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

simulation.inject_traffic

Change the traffic load on a demo simulation. Omit traffic to trigger a random 2×–5× spike (sends random: true internally); provide traffic to set an absolute RPS level (capped at 10000 RPS in demo mode). Use it to stress-test the architecture before stepping; the change only affects metrics after the next simulation.step. Do not use it to read metrics (simulation.metrics) or advance time (simulation.step). Pass the simulationId returned by simulation.create when your connector opens a fresh MCP session; preserve Mcp-Session-Id to use the omitted-ID current-simulation default. Returns the updated simulation with its new traffic level; the likely next tool is simulation.step.

Parameters2

simulationId	string	optional	Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link.
traffic	number	optional	Absolute traffic level in RPS to set. Omit to trigger a random spike instead. Server-capped at 10000 RPS in demo mode.

Raw schema

{
  "type": "object",
  "properties": {
    "simulationId": {
      "type": "string",
      "description": "Simulation ID returned by simulation.create. Preserve Mcp-Session-Id to omit this field and use the session's current simulation; if your connector starts a fresh MCP session for each call (for example Grok Bot or Cursor), pass this explicit ID after every fresh initialization. A fresh session has no current-simulation pointer and returns NO_ACTIVE_SIMULATION when the ID is omitted. Anonymous capabilities are short-lived (30 minutes by default), unguessable, and revoked when the demo expires or is deleted; proxy IP changes do not invalidate them. Do not treat the ID as a durable share link."
    },
    "traffic": {
      "type": "number",
      "description": "Absolute traffic level in RPS to set. Omit to trigger a random spike instead. Server-capped at 10000 RPS in demo mode."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (9)

simulation.inject_failuresimulation.recover_resourcesimulation.deletescenario.listscenario.getsimulation.createsimulation.stepsimulation.metrics

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.cloudworldmodel.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "cloud-world-model": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.cloudworldmodel.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Model Context Protocol (MCP) Server: ai.cloudworldmodel/cloud-world-model

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

simulation.inject_failure

simulation.recover_resource

simulation.delete

scenario.list

scenario.get

simulation.create

simulation.step

simulation.metrics

simulation.inject_traffic

Install

Remote endpoint

Related servers