Formhaus — Claude Code MCP server: what it does, how to install
Checks Formhaus form definitions against the real engine and runs multi-step paths with test data. Works offline, no account needed.
MIT ★ 8 updated 2026-10-24
claude mcp add formhaus -- npx -y @formhaus/mcpWhat Formhaus does
The server brings ten tools: validate_definition finds errors in form JSON and returns patches for automatic fixes; fix_definition applies safe fixes right away; simulate_path runs a form fill with given answers, shows visible fields at each step, validation errors and final submit values. capabilities describes field types, rules and condition operators. Three tools — translation_template, example_definitions and capabilities — provide reference.
The other five tools (publish_form, list_forms, get_submissions, update_form_settings, get_webhook, reveal_webhook_secret) talk to Formhaus Cloud at https://api.formhaus.dev. They need FORMHAUS_API_KEY in the server environment: add it to the env field in .mcp.json or claude_desktop_config.json, then restart the server. An account key (fh_live_...) grants access to all forms and all six tools; an agent key (fh_agent_...) reaches only the forms it created, and the last three tools still require an account key. Without a key, publish_form will create a form and return an agent key once.
Requires Node 22.12 or later. The simulator does not run custom validators, onStepValidate or lifecycle hooks.
What it helps with
- check a form JSON schema and get a list of fixes
- run a multi-step form fill with test data
- publish a form to Formhaus Cloud and get an endpoint
- fetch submitted form data via API
- generate a translation template for a form in another language
Example prompts for the agent
- Check the form schema in
contact.jsonand apply all safe fixes - Run the form from
survey.jsonwith answers{"kind": "business"}to the end - Publish the form from
feedback.jsonto Formhaus Cloud
How to install Formhaus
Platform CLI
claude mcp add formhaus -- npx -y @formhaus/mcpPlatform CLI
codex mcp add mcp -- npx -y @formhaus/mcpConfig file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@formhaus/mcp"
]
}
}
}Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@formhaus/mcp"
]
}
}
}Platform CLI
gemini mcp add mcp npx -y @formhaus/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Formhaus
How to install Formhaus in Claude Code?
Run claude mcp add formhaus -- npx -y @formhaus/mcp in your terminal.
What does Formhaus do?
It checks Formhaus form schemas for errors, runs multi-step fill scenarios and publishes forms to Formhaus Cloud via API.
Do I need an API key for local form checks?
No, validate_definition, fix_definition, simulate_path, translation_template, capabilities and example_definitions work offline without a key. You only need a key for tools that call Formhaus Cloud.