| name | formae-apply |
| description | Use when the user wants to deploy infrastructure, apply a forma file, reconcile a stack, update a stack, or make planned infrastructure changes |
Apply Infrastructure (Reconcile Mode)
Use the apply_forma MCP tool in reconcile mode to deploy or update infrastructure.
Targeting an environment (profile)
apply_forma (and get_command_status) hit the formae agent's API directly and take an optional profile argument. If the user is working against a specific environment (e.g. prod, staging), pass that profile name as profile on the apply_forma call and any get_command_status follow-up so it targets that environment — for this session only, without changing global state. If which environment they mean is unclear and list_profiles shows more than one, ask first. Never use use_profile to "set up" this session — the active profile is global and shared with the user's CLI and any other open sessions. When no profile is named, the active profile is used. Requires formae >= 0.87.0.
How Reconcile Works
Reconcile guarantees the target infrastructure matches the forma file exactly:
- Resources in the file but not deployed are created
- Deployed resources not in the file are destroyed
- Differences between file and deployed state are updated
This is the standard mode for planned deployments.
Workflow
- Confirm the forma file path with the user
- Always simulate first: call
apply_forma with mode: reconcile,