Skip to content
MCP server

Formhaus

Validate, fix and simulate Formhaus form definitions from your coding agent

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.15.3
Listing updated
3 days ago

About Formhaus

Formhaus is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Most of this server works offline against the real @formhaus/core engine, so an agent can check a form definition the same way the library will at runtime. Validation issues carry a code, severity, JSON pointer path, a hint and, when a repair is known, an RFC 6902 JSON Patch. A separate tool applies every safe fix at once.

simulate_path walks a multi-step form with sample answers and actions such as next, back and skip, then reports the visible fields, validation result, field errors and whether it would submit. Further offline tools list the engine's capabilities, bundled example definitions and a translation overlay skeleton for a target language.

Six other tools call Formhaus Cloud: publishing a form, listing forms, reading submissions, updating settings and reading the webhook and its secret. They need a FORMHAUS_API_KEY, except that the first publish can run without one. The site tells agents to prefer the open-source library and to move data or definitions to Cloud only with the user's explicit consent. It needs Node 22.12 or later.

Install

Run in a terminal

claude mcp add formhaus -- npx -y @formhaus/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "formhaus": {
      "command": "npx",
      "args": [
        "-y",
        "@formhaus/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "formhaus": {
      "command": "npx",
      "args": [
        "-y",
        "@formhaus/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "formhaus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@formhaus/mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "formhaus": {
      "command": "npx",
      "args": [
        "-y",
        "@formhaus/mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "formhaus": {
      "command": "npx",
      "args": [
        "-y",
        "@formhaus/mcp"
      ]
    }
  }
}

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

validate_definition
Checks a form definition and returns issues with codes, paths, hints and fixes.
fix_definition
Applies every safe fix and returns the updated definition and remaining issues.
simulate_path
Simulates answers and actions through a form and reports visible fields, errors and submit values.
capabilities
Lists field types, validation rules, condition operators and other engine features.
translation_template
Creates a translation overlay skeleton for a definition and language.
example_definitions
Lists bundled examples or returns one definition.
publish_form
Publishes a form to Formhaus Cloud and returns endpoint and embed snippets.
list_forms
Lists forms reachable by the API key with status and submission count.
get_submissions
Returns a page of submissions for a form.
update_form_settings
Changes webhook, notification, success message, redirect or status for a form.
get_webhook
Returns a form's webhook URL and masked secret.
reveal_webhook_secret
Returns the full webhook secret; marked sensitive.

What it does

Offline definition checks
Validate a form definition against the real engine with no account or key.
Safe auto-fix
Apply every safe repair and see the issues left over.
Path simulation
Run answers and next, back or skip actions through a multi-step form and inspect the result.
Translation templates
Generate an overlay skeleton with source texts and slots for a target language.
Cloud publishing
Publish a form and get an endpoint, hosted URL and embed snippets.
Submissions and webhooks
List forms, page through submissions and manage webhook settings.
One-command setup
npx formhaus adds the server to Claude Code, Codex, Cursor and Claude Desktop.

Good for

  • Check a generated form definition before wiring it into a React or Vue app
  • Auto-repair schema errors an agent introduced
  • Test conditional steps and routes without opening a browser
  • Prepare a translation overlay for a form
  • Publish a form and fetch its submissions from the agent

Pricing

Freemium

Offline checks need no account; Formhaus Cloud first form is free

Prices change. Check formhaus.dev before you buy.

Formhaus FAQ

Do I need an account to use it?

Not for validation, fixing, simulation, capabilities, examples or translation templates. Those run offline.

Which tools need an API key?

list_forms, get_submissions, update_form_settings, get_webhook and reveal_webhook_secret need FORMHAUS_API_KEY; publish_form uses it when set.

What runtime does it need?

Node 22.12 or later, running over stdio.

Which agents does the setup command support?

npx formhaus configures Claude Code, Codex, Cursor and Claude Desktop, and links manual steps for Windsurf, Gemini CLI, OpenCode and VS Code.

Is Formhaus free?

Formhaus has a free plan, with paid plans for more usage or features.

How do I add Formhaus to Claude Code?

Run this command in your terminal: claude mcp add formhaus -- npx -y @formhaus/mcp

What are the best alternatives to Formhaus?

The closest alternatives to Formhaus are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Formhaus

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools