Skip to content
MCP server

Formhaus

Validate Formhaus form definitions and simulate multi-step paths against the real engine

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.6.3
Listing updated
2 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.

This server lets an agent check a form definition against the actual @formhaus/core engine instead of guessing. validate_definition returns issues with JSON-pointer paths, hints and, where known, RFC 6902 patches, and fix_definition applies every safe fix. simulate_path walks a multi-step form with sample answers and reports visible fields, errors, whether it would submit and the submitted values.

Six tools run offline and need no account: validation, fixing, path simulation, translation templates, capabilities and bundled examples. The other six call Formhaus Cloud (publish_form, list_forms, get_submissions, update_form_settings, get_webhook, reveal_webhook_secret) and need an API key, except that publish_form can run without one.

The docs tell agents to default to the open library and not move user data or definitions to Cloud without explicit consent. Running npx formhaus registers the server in Claude Code, Codex, Cursor and Claude Desktop. It needs Node 22.12 or newer.

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
Check a definition and return issues with suggested fixes
fix_definition
Apply every safe fix and return the remaining issues
simulate_path
Simulate a multi-step path with answers and actions
capabilities
List field types, validation rules and condition operators
translation_template
Create an overlay skeleton for a language
example_definitions
List or fetch bundled example definitions
publish_form
Publish a form to Formhaus Cloud
list_forms
List forms the API key reaches
get_submissions
Fetch form submissions
update_form_settings
Change webhook, notification and redirect settings
get_webhook
Show a form's webhook URL and masked secret
reveal_webhook_secret
Reveal the full webhook secret

What it does

Engine-backed validation
Checks definitions with issue codes, paths and suggested JSON Patch fixes.
Safe auto-fix
Applies every safe repair and lists the issues left.
Path simulation
Steps through a form with answers and actions like next, back and skip.
Translation skeletons
Generates an overlay template for a target language.
Cloud publishing
Publishes a form and returns its endpoint, hosted URL and embed snippet.
One-command setup
`npx formhaus` adds the server to supported agents.

Good for

  • Check an AI-written form definition before shipping it
  • Test conditional steps without running the app
  • Create a translation file for an existing form
  • Publish a form and read its submissions from an agent

Pricing

Freemium

Offline checks need no account; Cloud has a free first form

Prices change. Check formhaus.dev before you buy.

Formhaus FAQ

Do the checks need an account?

No. The offline tools need no account or key.

Which tools call the cloud?

The publishing, listing, submissions, settings and webhook tools.

Which editors are supported?

Claude Code, Codex, Cursor and Claude Desktop via one command; others by manual config.

What Node version?

22.12 or later.

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