formslist-mcp

MCP (Model Context Protocol) server for FormsList — a form-backend SaaS. Point any HTML form at a FormsList endpoint and it handles submissions, email notifications, spam filtering, auto-responses, and analytics with no server code.

This server lets any MCP client (Claude Code, Claude Desktop, Cursor, ...) create form endpoints, read submissions, configure auto-responses, and generate embed snippets.

Tools

Tool	API key?	What it does
instant_provision	No	Create a working form endpoint instantly for any email — no account needed. The owner claims it later via the returned claim_url. Also returns a ready-to-paste html_snippet and curl_example.
create_form	Yes	Create a new form (name, optional description).
list_forms	Yes	List all forms in the account.
get_form	Yes	Get one form's details by form_id.
get_submissions	Yes	Get a form's submissions (page, per_page pagination).
configure_autoresponse	Yes	Enable/configure the auto-response email (enabled, subject, body_html, from_name). If the plan doesn't include auto-responses, the tool returns the upgrade message and upgrade_url instead of erroring.
get_embed_snippet	No	Pure local generator: builds an HTML <form> snippet + AJAX example that posts to https://formslist.com/f/<hash>.

instant_provision and get_embed_snippet work with zero config — no API key needed.

The API key (ff_sk_...) is created at https://formslist.com/account/api-keys and passed via the FORMSLIST_API_KEY environment variable. FORMSLIST_BASE_URL overrides the API base (default https://formslist.com).

Install (until npm publish)

git clone <this-repo>
cd formflow/mcp
npm install
npm run build

The built server is at dist/index.js.

Configure your MCP client

Claude Code

claude mcp add formslist -e FORMSLIST_API_KEY=ff_sk_xxx -- npx -y formslist-mcp

(Omit -e FORMSLIST_API_KEY=... if you only need instant_provision / get_embed_snippet.)

Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "formslist": {
      "command": "npx",
      "args": ["-y", "formslist-mcp"],
      "env": {
        "FORMSLIST_API_KEY": "ff_sk_xxx"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "formslist": {
      "command": "npx",
      "args": ["-y", "formslist-mcp"],
      "env": {
        "FORMSLIST_API_KEY": "ff_sk_xxx"
      }
    }
  }
}

Notes

• Transport is stdio; all HTTP uses the global fetch (Node 18+).
• Non-2xx API responses are returned to the agent as {status, error} text — never unhandled exceptions.
• LLM-oriented product docs: https://formslist.com/llms.txt