Formasty README

Formasty MCP

Build and operate production-ready forms, quizzes, surveys, workflows, and response pipelines from AI agents.

This is the public documentation repository for Formasty's official remote Model Context Protocol (MCP) server. The Formasty application and backend remain private. This repository intentionally contains no server implementation, infrastructure configuration, customer data, or credentials.

Connect

Setting	Value
Server name	`formasty`
Remote MCP URL	`https://app.formasty.com/api/mcp`
Transport	Streamable HTTP
Legacy SSE URL	`https://app.formasty.com/api/mcp/sse`
Authentication	OAuth, with API-key fallback for developer-controlled clients
Official registry name	`com.formasty/form-builder`

For clients that support remote MCP servers, add https://app.formasty.com/api/mcp and complete the Formasty OAuth flow. The repository is documentation only: do not clone or run it as a server.

Claude

In Claude, open Customize > Connectors, add a custom connector, enter the remote MCP URL, and authenticate with Formasty. The same connector works across the Claude surfaces that support remote MCP.

Cursor

After the Formasty plugin is approved for the Cursor Marketplace, install it from Cursor Settings > Plugins or run:

text

/add-plugin formasty

To connect manually before marketplace approval, add the following to your user or project MCP configuration:

config.json

{
  "mcpServers": {
    "formasty": {
      "url": "https://app.formasty.com/api/mcp"
    }
  }
}

Cursor supports Streamable HTTP and OAuth for remote MCP servers.

VS Code and GitHub Copilot

Add the following to your user profile or workspace mcp.json:

config.json

{
  "servers": {
    "formasty": {
      "type": "http",
      "url": "https://app.formasty.com/api/mcp"
    }
  }
}

Cline

Use Cline's remote-server UI, or install from the CLI:

bash

cline mcp install formasty --transport http https://app.formasty.com/api/mcp

ChatGPT

In a workspace with MCP app developer access, create a custom app using https://app.formasty.com/api/mcp as the MCP server URL, complete OAuth, and review the requested tool permissions before publishing it to the workspace.

Gemini CLI

Install the official Formasty Gemini CLI extension from GitHub:

bash

gemini extensions install https://github.com/QuantumCoderSys/formasty-mcp

Restart Gemini CLI, run /mcp list, and complete OAuth with /mcp auth formasty if authentication is requested. The root gemini-extension.json configures the hosted Streamable HTTP endpoint; no backend package or local server process is installed.

Compatibility bridge

For stdio-only clients such as older Claude Desktop versions, use the remote bridge:

config.json

{
  "mcpServers": {
    "formasty": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.formasty.com/api/mcp"
      ]
    }
  }
}

Never place a Formasty API key in a public repository, shared configuration, issue, or screenshot. Prefer OAuth for user-facing clients.

Agents and marketplace reviewers can use llms-install.md for the concise installation and verification path. Gemini CLI also receives focused operating guidance from GEMINI.md.

What agents can do

Create forms from scratch or from Formasty starter templates.
Build lead-capture forms, surveys, intake forms, applications, booking forms, waitlists, polls, and quizzes.
Add, update, move, reorder, and remove steps and fields.
Configure themes, covers, scheduling, settings, thank-you screens, and endings.
Build conditional workflows, variables, routing rules, matching quizzes, and score quizzes.
Validate and audit drafts before publishing.
Publish forms and retrieve share, embed, and connection assets.
Read and manage submissions and create response exports, subject to user permissions.
Configure supported webhooks, analytics pixels, tag managers, and custom domains.
Import supported Google Forms and Typeform forms.

The current public contract exposes 75 operations. See TOOLS.md or use MCP tools/list for the live, authoritative schemas and safety annotations.

Authentication and permissions

OAuth connections act as the signed-in Formasty user. Tool access is still constrained by:

OAuth scopes or API-key scopes
workspace membership and role permissions
selected workspace access
Free, Pro, and Business feature gates
optimistic draft revisions and server-side validation
explicit host and user approval for consequential operations

Public discovery reveals tool definitions only. Invoking tools or accessing workspace data requires authentication.

Useful links

Security and privacy

Read SECURITY.md before reporting a vulnerability and PRIVACY.md for the MCP-specific data flow. Do not include access tokens, API keys, form responses, customer data, private form URLs, or reproduction data from a real workspace in a public issue.

Support

See SUPPORT.md or email support@formasty.com for account, billing, privacy, or security-sensitive support.

License

The documentation and metadata in this repository are available under the MIT License. Use of the hosted Formasty service is governed by the Formasty Terms of Service.