Validate Formhaus form definitions and simulate multi-step paths against the real engine.
Model Context Protocol (MCP) Server: io.github.formhaus-dev/formhaus
The io.github.formhaus-dev/formhaus MCP server validates Formhaus form definitions and simulates multi-step paths against the real engine. It is focused on checking that form definitions are correct and that multi-step navigation behaves as expected during simulation.
🛠️ Key Features
Validate Formhaus form definitions
Simulate multi-step paths against the real engine
🚀 Use Cases
Confirm that Formhaus form definitions are valid
Test or verify multi-step path behavior using the engine simulation
⚡ Developer Benefits
Faster feedback on form definition validity
Engine-aligned simulation of multi-step flows
⚠️ Limitations
Details such as supported tooling, limits, or additional capabilities are not provided in the available server data.
MCP server that lets AI agents check Formhaus form definitions against the real @formhaus/core engine. Runs over stdio. Requires Node 22.12 or later. The checks need no account or key.
validate_definition, fix_definition, simulate_path, translation_template, capabilities and example_definitions run offline. The other tools publish forms, read submissions and manage settings in Formhaus Cloud. If the app has its own backend, keep the data there and don't publish without the user's consent.
Setup
Claude Code plugin, with the Formhaus skills:
bash
claude plugin marketplace add formhaus-dev/formhaus
claude plugin install formhaus@formhaus
Inside a Claude Code session, /plugin marketplace add formhaus-dev/formhaus and /plugin install formhaus@formhaus do the same after a confirmation prompt.
Claude Code, server only:
bash
claude mcp add formhaus -- npx -y @formhaus/mcp
Claude Desktop (claude_desktop_config.json) and Cursor (.cursor/mcp.json):
{ valid, issues }. Each issue has code, severity, a JSON pointer path, message, hint and, when a repair is known, fixes ({ title, safe, patch } with an RFC 6902 JSON Patch)
fix_definition
definition (object or JSON string)
{ definition, applied, valid, issues }: the definition with every safe fix applied, the fixes applied and the issues left
simulate_path
definition, answers, optional actions (next, back, skip) and overlay
Active step path with visible fields, action trace, validation ({ valid, issues }), field errors, wouldSubmit, submitValues. Group item fields appear as paths such as participants.0.email
capabilities
none
Field types, sections, repeatable groups, field props, validation rules, condition operators, step and route semantics, translation catalogs, keys and overlay addresses, adapters
translation_template
definition, lang, optional prefix
overlay skeleton with the source texts, suggested file name and slots with address, key, placeholders and hash
form_id and the full webhook_secret. Marked as a non-read-only, sensitive tool. Whether the client asks first depends on its permission settings
publish_form, list_forms, get_submissions, update_form_settings, get_webhook and reveal_webhook_secret call Formhaus Cloud at https://api.formhaus.dev. All but publish_form need FORMHAUS_API_KEY in the server environment, and publish_form uses it when set. An account key (fh_live_...) reaches every form and all six tools. An agent key (fh_agent_..., returned once by the first keyless publish_form) reaches only the forms it created, and update_form_settings, get_webhook and reveal_webhook_secret need an account key. The server reads FORMHAUS_API_KEY from its own environment, not from the project .env. Add it to the env of the formhaus server in your MCP client config (for example .mcp.json with ${FORMHAUS_API_KEY} and the value in your shell or a gitignored .env your client loads), then restart the server. FORMHAUS_API_BASE overrides the API URL. The server also sends short usage instructions to the client on connect.
simulate_path applies answers as initial values, with group answers as arrays of item objects, then presses the actions in order, or Next until the last step or the first blocking error. errors covers visited steps only. Custom validators, onStepValidate and lifecycle hooks are not run. The capabilities are also available as the formhaus://capabilities resource.
The tool handlers are exported for use without MCP:
See the MCP guide for example output. A remote MCP server for Formhaus Cloud is also available. npx formhaus sets up the server in the coding agents on your machine; see formhaus.