# Formhaus

> Formhaus is a freemium MCP server for developer tools. Validate, fix and simulate Formhaus form definitions from your coding agent. 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/formhaus-dev/formhaus/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.formhaus-dev/formhaus
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## 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`: 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.

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

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