# Formhaus

> Formhaus is a freemium MCP server for developer tools. Validate Formhaus form definitions and simulate multi-step paths against the real engine. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://formhaus.dev/guide/mcp.html
- **Repository:** https://github.com/ignsm/formhaus/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.ignsm/formhaus
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/formhaus-2
