Formhaus

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/formhaus-dev-formhaus

About

Use cases: frontend-development

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

9 read · 3 write · 0 delete

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (12)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• capabilitiesFormhaus capabilitiesread-only

  Call this first, before writing or editing a definition, for the full reference of what a definition supports; example_definitions gives whole working forms to copy instead. Lists what a Formhaus definition supports: field types (including scale, rating and picture options), sections (including matrix), repeatable groups, field props, validation rules, condition operators, step and route semantics, actions, translation (lang, messages, labels, i18n keys, overlay addresses) and adapters. To check a finished definition, call validate_definition instead.

• example_definitionsExample definitionsread-only

  Call this when you need a working form to start from or a pattern to copy, such as multi-step forms, branching routes, conditions or translations; capabilities lists every option but shows no complete form. Without id, lists the bundled example definitions. With id, returns that definition. Adapt it, then check it with validate_definition.

• fix_definitionApply safe fixes to a Formhaus definitionread-only

  Call this when validate_definition reports issues with safe fixes, such as a misspelled property name, a missing id or key, an empty label, a one-letter typo in a condition field, a duplicate key nothing refers to or a missing submit button. Applies every safe fix and returns { definition, applied, valid, issues }: the repaired definition, the fixes applied in order, and the issues left, the same as validate_definition returns for the repaired definition. Safe fixes never change what the form does beyond the repair. Unsafe fixes, such as pointing a condition at a field two edits away, stay in …

• get_submissionsGet form submissionsread-only

  Call this to read the answers people submitted to one form, page by page; list_forms gives only the total count per form. Returns submissions newest first. Requires FORMHAUS_API_KEY: an account key (fh_live_...) of the form's account or the agent key (fh_agent_...) that created the form. Returns notice, submissions and next_cursor. Each submission has id, form_version, created_at and values (field key to value, validated on the server). limit is 1 to 100, default 50. When next_cursor is present, call again with cursor set to it for older submissions; no next_cursor means no more. Values were t…

• get_webhookGet the webhook of a formread-only

  Call this to check where the webhook of a form posts; it shows only a masked secret, so call reveal_webhook_secret when the receiving server needs the full one, and update_form_settings to set or remove the URL. Returns the webhook URL and the masked signing secret. Requires an account key (fh_live_...); agent keys answer owner_key_required.

• list_formsList formsread-only

  Call this to find a form_id for get_submissions, publish_form, update_form_settings or get_webhook, or to see every form the key reaches with its status and submission count; to read the answers of one form, call get_submissions instead. Lists the forms newest first. Each form has form_id, title, status (active or paused), version, submissions (total count), endpoint, hosted_url, created_at and, for unclaimed forms, expires_at. An account key (fh_live_...) sees every form of the account; an agent key (fh_agent_...) sees only the forms it created. Requires FORMHAUS_API_KEY.

• publish_formPublish a form

  Call this after validate_definition passes, to put the form live on Formhaus Cloud: without form_id it creates a new form, with form_id it publishes a new version of that form. Returns form_id, version, endpoint (POST URL for submissions), hosted_url, embed_snippet, react_snippet, dashboard_url and warnings. Without an account key (fh_live_...) it also returns claim_url and expires_at, and on the first call without any key agent_key (fh_agent_...) and agent_key_notice. Call it when the user needs a working form (contact, waitlist, signup, survey, feedback) without writing a backend. A new vers…

• reveal_webhook_secretReveal the webhook signing secret

  Call this only while setting up the server that receives the webhook of a form and needs the full signing secret; get_webhook shows the URL and a masked secret and is enough for anything else. Returns the full webhook signing secret (whsec_...). Requires an account key (fh_live_...); agent keys answer owner_key_required. Store the secret on the receiving server as a server-side secret. Never print it in chat or commit it.

• simulate_pathSimulate a path through a formread-only

  Call this after validate_definition passes, to check branching, routes, skip and conditional fields by stepping through the form like a user; validate_definition checks only the structure. Runs a headless FormEngine. answers are applied as initial values; a group answer is an array of item objects, such as { "participants": [{ "name": "Ada" }] }. Then actions are pressed in order like a user would: next is refused while its disabled conditions match and on next: false steps until an autoAdvance radio, scale or rating is answered, skip only works on steps with a skip action and submits on the l…

• translation_templateTranslation templateread-only

  Call this when the form needs another language, once per language: it returns the overlay to translate, which simulate_path accepts as overlay to check the result. Returns the translation skeleton of a definition for one language: overlay is nested JSON with the source texts as values, file is the suggested name (signup.ru.json), slots lists every text with its address, translation key, {placeholders} and a source hash. Translate only the values, keep nesting, identifiers and {placeholders}, then save the overlay next to the definition. Store revision and review state separately; the template …

• update_form_settingsUpdate form settings

  Call this to change how a published form behaves without touching its fields: webhook, email notifications, success message, redirect, or pause and resume. To change fields, publish a new version with publish_form and form_id instead. Changes the settings of a form of the account. Requires FORMHAUS_API_KEY to be an account key (fh_live_...); agent keys (fh_agent_..., also after a claim) get owner_key_required, and unclaimed forms are not found. Send only the settings to change; omitted ones stay. Returns form_id, status, success_message, redirect_url, notify_mode, webhook_url and a masked webh…

• validate_definitionValidate a Formhaus definitionread-only

  Call this after writing or editing a definition and before simulate_path or publish_form; it checks the structure and engine rules, while simulate_path checks how a user moves through the form. Checks a Formhaus form definition against the JSON Schema and the engine. Returns { valid, issues }. Each issue has code, severity ("error" or "warning"), a JSON pointer path, message, hint and, when a repair is known, fixes: a list of { title, safe, patch } where patch is an RFC 6902 JSON Patch. Errors make the engine reject the definition, such as a condition with zero or two operators, a condition on…

Signals

Stars

6

Forks

0

Open issues

0

Weekly downloads

2,015

Last commit (this folder)

Oct 24, 2026 (5 days ago)

Last release

Oct 24, 2026 (5 days ago)

Last package publish

Oct 24, 2026 (5 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.formhaus-dev/formhaus

Version

0.12.4

Auth

No auth

Packages

npm @formhaus/mcp

License

MIT

Repository

github.com/formhaus-dev/formhaus

Website

formhaus.dev/guide/mcp.html

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql