formae MCP Release Notes

Releases of the formae-mcp plugin — the MCP server and skills that integrate formae with AI coding assistants like Claude Code, Codex, and OpenCode. Install via the platform-engineering-labs/formae-marketplace; see the setup guide for the full install + configuration walk-through.

One-time catch-up update (May 2026). The marketplace catalog previously pinned formae-mcp to version 0.2.0, which silently prevented /plugin marketplace update from delivering newer releases. The pin has been removed, so users on 0.2.0 will jump directly to 0.3.2 on their next update — receiving all the changes in 0.3.0, 0.3.1, and 0.3.2 at once. Subsequent updates will land normally.

To pull the catch-up, run these three commands in Claude Code (no uninstall/reinstall needed):

/plugin marketplace update formae-marketplace
/plugin update formae-mcp@formae-marketplace
/reload-plugins

The first refreshes the catalog, the second installs 0.3.2, and the third applies it to your current session. The MCP binary rebuilds automatically on the next session start (thanks to the 0.3.2 fix).

0.3.2

Released May 28, 2026

Fix: Updates pulled with /plugin marketplace update now take effect on the next session start. Previously the start-mcp.sh wrapper only built the Go binary on first install, so marketplace updates kept serving the stale cached binary until you deleted bin/formae-mcp by hand. The wrapper now detects when source has changed and rebuilds automatically.

0.3.1

Released May 21, 2026

New: Your AI assistant now understands PKL syntax, forma file structure, schema annotations, and common error messages out of the box. Practical effect: fewer wrong PKL snippets in suggested code, faster grounded answers to "why is this resource being replaced?" or "how do I reference one resource's output from another?", and clearer diagnoses when something goes wrong. The server exposes four new on-demand reference resources (formae://docs/pkl-primer, formae://docs/forma-anatomy, formae://docs/annotations, formae://docs/troubleshooting) that the assistant reads when it needs the depth.

New: When your assistant explains a concept (stacks, targets, drift, apply modes, the .res accessor), it now cites the canonical docs.formae.io page for follow-up reading.

Improved: When you ask your assistant to build a new resource plugin (e.g., "build a Cloudflare plugin for formae"), the generated scaffold and CRUD implementation are more likely to be correct on the first pass. The formae-plugin-new skill now guides assistants through advanced patterns (polymorphic resources, cross-plugin Target references, computed Resolvable outputs, synthetic identifiers, external-binary integrations like helm or atlas) that previously needed multiple correction rounds.

Docs: Install/update instructions now point you at /reload-plugins (Claude Code v2.1.116+) to apply changes without restarting your session.

0.3.0

Released May 19, 2026

New: Manage formae stack policies in natural language. Ask your assistant to "expire lifeline in 20 minutes" or "reject out-of-band changes on production" and it edits the right PKL file through the existing simulate/confirm/apply discipline — no hand-rolled policy syntax needed. Adds the create_inline_policy MCP tool and the formae-stack-policy skill.

New: Switch between formae config profiles (different agents, environments, auth setups) by asking your assistant. The new formae-config skill drives the fcfg companion command to list, switch, save, edit, and delete profiles without leaving the conversation.

Fix: Drift-detection workflows (/formae-fix-code-drift and the list_changes_since_last_reconcile MCP tool) now return results correctly. Earlier versions called the wrong agent endpoint and silently returned empty results.

Improved: /formae-apply now suggests clearer recovery options when a deploy fails mid-way (which resources to retry, which to roll back, which to inspect first).

0.2.0

Released February 12, 2026 — initial public release

The first marketplace release of the formae-mcp plugin. With it installed, your AI assistant can:

  • Inspect your infrastructure. Ask "what's running in production?", "any failed commands today?", "show me unmanaged resources in us-west-2", or "which plugins are loaded?" — the assistant answers from the live formae agent rather than guessing.

  • Deploy and update infrastructure safely. "Apply my VPC forma" runs through a strict simulate → confirm → apply loop so you always see the planned change before it touches cloud resources.

  • Hot-fix during incidents. "Patch the API gateway timeout to 60s without reconciling the rest of the stack" — applies targeted changes via patch mode without forcing a full reconcile of unrelated resources.

  • Absorb out-of-band changes into your IaC codebase. "Has anything changed in production since the last reconcile? Pull it into the PKL files." The assistant extracts current state, edits your PKL to match, and verifies with a dry-run.

  • Discover and import resources you didn't manage with formae yet. "What's in this AWS account that formae doesn't know about? Bring the RDS clusters under management." The assistant runs discovery, then imports the resources into your forma files.

  • Build new resource plugins. "Build a Cloudflare plugin for formae." The assistant researches the provider API, proposes resource types in implementation waves, scaffolds the plugin, and TDDs through each CRUD operation against the plugin SDK tutorial.

Ships with 15 MCP tools and 13 skills covering these workflows. Install via the platform-engineering-labs/formae-marketplace. Multi-platform install documentation covers Claude Code (marketplace + manual), Codex, and OpenCode.

License: FSL-1.1-ALv2.