formbuilder-mcp

MCP server for FormBuilder — lets Claude, Cursor, Gemini CLI, Claude Code and any other MCP client create and publish online forms, list responses and register webhooks on your behalf.

This package is a small stdio proxy to FormBuilder's hosted MCP server (https://api.formbuilder.com/mcp). It fetches the remote tool list on startup and forwards every call, so you always get the current tools without updating the package.

Free plan: 5 forms, 100 responses / month, no credit card. Responses over the cap are held, never lost.

Tools

| Tool | What it does | | --- | --- | | formbuilder_signup | Create a free account + API key from an email (no browser). Key is remembered for the session. | | formbuilder_create_form | Create a form from a title and fields; optionally publish. Returns edit_url and public_url. | | formbuilder_list_forms | List forms with status and response counts. | | formbuilder_get_form_fields | Field schema (ids, labels, types) of a form. | | formbuilder_list_responses | Responses for a form, newest first. | | formbuilder_create_webhook | POST every new response to an HTTPS URL. |

Configuration

| Env var | Default | Notes | | --- | --- | --- | | FORMBUILDER_API_KEY | – | Optional fbpat_… personal access token from formbuilder.com/developers. Without it the server connects to the open endpoint and you start with formbuilder_signup. | | FORMBUILDER_MCP_URL | https://api.formbuilder.com/mcp (or …/mcp/open when no key) | Override the remote server. |

Requires Node.js 18+.

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "formbuilder": {
      "command": "npx",
      "args": ["-y", "formbuilder-mcp"],
      "env": { "FORMBUILDER_API_KEY": "fbpat_…" }
    }
  }
}

(Claude Desktop and claude.ai can also add https://api.formbuilder.com/mcp directly as a remote connector — Settings → Connectors → Add custom connector — and sign in with OAuth, no npm needed.)

Cursor

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "formbuilder": {
      "command": "npx",
      "args": ["-y", "formbuilder-mcp"],
      "env": { "FORMBUILDER_API_KEY": "fbpat_…" }
    }
  }
}

Claude Code

Remote (recommended, OAuth sign-in):

claude mcp add --transport http formbuilder https://api.formbuilder.com/mcp

Or via this package:

claude mcp add formbuilder -e FORMBUILDER_API_KEY=fbpat_… -- npx -y formbuilder-mcp

Or install the plugin (skill + MCP server): claude plugin marketplace add bluetickventures/fb then /plugin install formbuilder@formbuilder.

Gemini CLI

gemini mcp add formbuilder https://api.formbuilder.com/mcp
# or, stdio:
gemini mcp add formbuilder npx -y formbuilder-mcp -e FORMBUILDER_API_KEY=fbpat_…

Other clients

Any MCP client that supports stdio: command npx, args -y formbuilder-mcp. Any client that supports Streamable HTTP: https://api.formbuilder.com/mcp with Authorization: Bearer fbpat_….

Links

• Developer docs: https://formbuilder.com/developers
• OpenAPI spec: https://formbuilder.com/openapi.json
• LLM-friendly overview: https://formbuilder.com/llms.txt

MIT © FormBuilder