MicroStax MCP Server Reference

MicroStax exposes a production-grade Model Context Protocol (MCP) server, allowing AI agents and automated workflows to control the entire environment lifecycle with task-level semantics.

The v10.2 server registers:

• 45+ Tools for orchestration, observability, and governance.
• 5 Resources for real-time context.
• 3 Prompts for standardized agent interactions.

Tool Catalog

Environment Orchestration

Tool	Inputs	Purpose
env_list	status?	List environments with optional status filtering.
env_get	id	Fetch full environment metadata.
env_create	blueprint, name?	Provision a new environment from Blueprint YAML.
env_delete	id	Terminate an environment and its resources.
env_stop	id	Pause environment execution (cost-saving).
env_resume	id	Resume a paused environment.
env_status	id	Fetch live health status of individual services.
env_scale	id, service, replicas	Scale a service and update the mesh topology.
environment_replay	id, snapshotId?	Restore an environment from a recorded state.
env_shadow	id, enable	Toggle behavioral mirroring (shadowing).
env_logs	id, service?, lines?	Fetch recent logs for an environment.

Intelligence & Economics

Tool	Inputs	Purpose
blueprint_validate	blueprint	Run the MicroStax Quality Gate (L001-L005).
blueprint_predict_cost	blueprint	Predict monthly cost before provisioning.
env_cost	id	Run live cost analysis for a specific env.
env_predict	id	Predict configuration drift or potential failures.
env_diagnose	id	Run failure diagnosis (AI-assisted).
env_diagnose_apply	id, suggestion	Apply a recommended infrastructure fix.

Identity & governance

Tool	Inputs	Purpose
identity_verify	none	Verify current identity and organization scope.
identity_federate	serviceId, targetCluster	Mint a short-lived federated token for service-to-service calls across clusters.
governance_get_logs	limit?	Audit organization-wide infrastructure changes.

Snapshot & Data seeding

Tool	Inputs	Purpose
snapshot_create	id, service?	Create a point-in-time service snapshot.
env_snapshot_closure	id	Capture an immutable closure of the environment for replay.
env_seed	id, service, script	Run an ad-hoc SQL or Shell seed script.
seed_run	name, envId	Execute a published seed from the registry.

Resources (Read-Only Context)

Resource	URI	Purpose
environment_list	microstax://environments	Current environment list as JSON.
environment_detail	microstax://environments/{id}	One environment record as JSON.
environment_logs	microstax://environments/{id}/logs	Stream logs as plain text.
blueprint_schema	microstax://schema/blueprint	JSON Schema for Blueprint authoring.

Built-In Agent Prompts

Prompt	Intended Flow
create-environment	Generate Blueprint -> Validate -> Cost Predict -> Create.
diagnose-failures	Inspect Logs -> Check Topology -> Run AI Diagnosis -> Apply Fix.

Guidance for AI Agents

1. Think Before Provisioning: Always call blueprint_predict_cost before env_create to ensure alignment with organization budgets.
2. Deterministic Debugging: When an environment fails, call env_snapshot_closure before attempting manual remediation to preserve the failure state for replay.
3. Verify Identity: Call identity_verify at the start of a session to confirm your organization scope and role permissions.