Environment / Runtime MCP Server

Runtime control plane for ADK-Rust Enterprise. Manages runtime environments, worker pools, deployment bundles, configuration sync, provider routing, validation gates, promotion, rollback, and configuration drift detection.

Purpose

Policy-controlled management of ADK-Rust runtime environments, worker pools, deployment bundles, configuration sync, provider routes, memory backend bindings, protocol bindings, payment runtime modes, validation gates, promotion, rollback, and configuration drift detection.

This MCP is the runtime control plane — it knows where agents run, what version they're on, and how builds move between environments.

What This MCP Owns

✅ Environment registry          ✅ Worker pool scaling
✅ Runtime configuration          ✅ Deployment targets
✅ Release bundle promotion       ✅ Rollback coordination
✅ Provider routing config        ✅ Memory backend bindings
✅ Protocol bindings (A2A/MCP/ACP)✅ Payment mode bindings
✅ Validation status              ✅ Configuration drift detection
✅ Deploy history                 ✅ Config versioning (plan/apply)

What This MCP Does NOT Own

❌ Raw secrets → Credentials Vault MCP
❌ Artifact binaries → Artifact Store MCP
❌ Policy authoring → Governance Policy MCP
❌ Payment execution → ADK-Payments MCP
❌ Raw traces/metrics → Observability stack
❌ Source repositories → GitHub MCP
❌ Session state → Session Memory MCP

Tools (10)

Example Prompts & Outputs

List all environments

Prompt: "Show me all our environments"

[
  {
    "environment_id": "env_prod",
    "name": "Production",
    "type": "production",
    "region": "us-east-1",
    "status": "healthy",
    "runtime_version": "adk-rust-0.12.4",
    "active_release_id": "rel_2026_0518_1842",
    "workers": "Model:4/4, Graph:2/2, Browser:5/5, Payment:2/2"
  },
  {
    "environment_id": "env_staging",
    "name": "Staging",
    "type": "staging",
    "region": "us-east-1",
    "status": "healthy",
    "active_release_id": "rel_2026_0518_1842"
  }
]

Validate before promotion

Prompt: "Is production ready for a new deployment?"

Tool: validate_environment

{ "environment_id": "env_prod", "scope": "pre_promote" }

Output:

{
  "validation_id": "val_91af2b...",
  "environment_id": "env_prod",
  "scope": "pre_promote",
  "checks": [
    { "name": "provider_connectivity", "status": "passing", "message": "Model routes reachable" },
    { "name": "memory_backend", "status": "passing", "message": "Redis/Postgres connected" },
    { "name": "worker_health", "status": "passing", "message": "4 pools" },
    { "name": "protocol_bindings", "status": "passing", "message": "A2A/MCP/ACP enabled" },
    { "name": "credential_bindings", "status": "passing", "message": "2 refs valid" },
    { "name": "config_schema", "status": "passing", "message": "Configuration valid" },
    { "name": "rollback_readiness", "status": "passing", "message": "Previous release available" }
  ],
  "passing": 7,
  "failing": 0,
  "review": 0,
  "promotion_allowed": true
}

Promote a release

Prompt: "Promote the staging build to production"

Tool: promote_build

{
  "release_bundle_id": "rel_2026_0519_0921",
  "target_environment_id": "env_prod",
  "promoted_by": "ci_pipeline",
  "strategy": "canary"
}

Output:

{
  "deployment_id": "deploy_fffbd202...",
  "environment_id": "env_prod",
  "release_bundle_id": "rel_2026_0519_0921",
  "previous_release_id": "rel_2026_0518_1842",
  "strategy": "canary",
  "status": "succeeded",
  "promoted_by": "ci_pipeline"
}

Scale workers for traffic spike

Prompt: "Scale browser workers to 20 in production — checkout traffic is spiking"

Tool: scale_worker_pool

{
  "environment_id": "env_prod",
  "pool_type": "browser",
  "desired_capacity": 20,
  "reason": "checkout traffic spike"
}

Output:

{
  "environment_id": "env_prod",
  "pool_type": "browser",
  "previous_capacity": 5,
  "target_capacity": 20,
  "reason": "checkout traffic spike",
  "status": "scaled"
}

Rollback a failed deployment

Prompt: "Roll back production — payment validation is failing"

Tool: rollback_deploy

{
  "environment_id": "env_prod",
  "reason": "Payment validation failing in canary",
  "reason_code": "payment_error"
}

Output:

{
  "rollback_id": "rb_448a2b...",
  "environment_id": "env_prod",
  "from_release": "rel_2026_0519_0921",
  "to_release": "rel_2026_0518_1842",
  "reason": "Payment validation failing in canary",
  "reason_code": "payment_error",
  "status": "rolled_back"
}

Sync config with plan/apply

Prompt: "Plan a config sync for production"

Tool: sync_environment_config

{ "environment_id": "env_prod", "mode": "plan" }

Output:

{
  "environment_id": "env_prod",
  "mode": "plan",
  "current_config_version": 1,
  "changes_pending": false,
  "requires_approval": true
}

Detect configuration drift

Prompt: "Check if production has drifted from expected state"

Tool: detect_config_drift

{ "environment_id": "env_prod" }

Output:

{
  "drift_id": "drift_7c3a...",
  "environment_id": "env_prod",
  "total_drifted": 0,
  "drifted_items": []
}

Worker pool status

Prompt: "Show me worker utilization in production"

Tool: get_worker_pool_status

{ "environment_id": "env_prod" }

Output:

{
  "environment_id": "env_prod",
  "total_pools": 4,
  "pools": [
    { "pool_type": "model", "desired": 4, "current": 4, "utilization": "100%", "status": "healthy" },
    { "pool_type": "graph", "desired": 2, "current": 2, "utilization": "100%", "status": "healthy" },
    { "pool_type": "browser", "desired": 5, "current": 5, "utilization": "100%", "status": "healthy" },
    { "pool_type": "payment", "desired": 2, "current": 2, "utilization": "100%", "status": "healthy" }
  ]
}

Worker Pool Types

Environment Types

Integration with Other MCPs

Installation

git clone https://github.com/zavora-ai/mcp-environment
cd mcp-environment
cargo build --release

MCP Client Config

{
  "mcpServers": {
    "environment": {
      "command": "/path/to/mcp-environment"
    }
  }
}

Works with Claude Desktop, Kiro, Codex, Cursor, Windsurf, Antigravity, and Open Code.

Contributing

PRs welcome. Run cargo clippy and cargo fmt before submitting.

Contributors

License

Apache-2.0 — see LICENSE for details.

Part of the ADK-Rust Enterprise MCP server ecosystem.

Built with ❤️ by Zavora AI

Registry Compliance

This server implements the ADK MCP SDK contract:

• HealthCheck — async health probe for registry monitoring
• mcp-server.toml — manifest declaring tools, risk classes, and credentials
• Structured tracing — RUST_LOG env-filter for observability