Skip to main content
Glama
formslist-mcp

formslist-mcp

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).

Related MCP server: @restforge-dev/mcp-server

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

Available Tools

7 tools
configure_autoresponseA

Enable, disable, or configure the auto-response email sent to people who submit a form. Requires FORMSLIST_API_KEY. Auto-responses are a paid-plan feature: if the account's plan does not include them, the result contains the upgrade message and upgrade_url to relay to the user.

Inputs: enabled (required), form_id (required), subject, body_html, +1 more.

create_formA

Create a new form in the authenticated FormsList account. Requires FORMSLIST_API_KEY.

Inputs: name (required), description.

get_embed_snippetA

Build a ready-to-paste HTML form snippet (plus an AJAX fetch example) that posts to a FormsList endpoint. Pure local generation — no API key, no network. Pass either the full endpoint URL (https://formslist.com/f/) or just the form hash.

Inputs: endpoint_or_hash (required), fields.

get_formA

Get details of a single form (settings, endpoint, submission counts). Requires FORMSLIST_API_KEY.

Inputs: form_id (required).

get_submissionsA

Get submissions for a form, paginated. Requires FORMSLIST_API_KEY.

Inputs: form_id (required), page, per_page.

instant_provisionA

Create a working form endpoint instantly for any email — no account needed. The owner claims it later via the claim_url. Returns the endpoint URL, claim_url, a ready-to-paste html_snippet, and a curl_example.

Inputs: email (required), form_name.

list_formsA

List all forms in the authenticated FormsList account. Requires FORMSLIST_API_KEY.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a distinct purpose: instant_provision handles anonymous form creation, create_form handles authenticated creation, get_form and list_forms distinguish single vs. list retrieval, and get_submissions, configure_autoresponse, and get_embed_snippet each target a separate concern. The only potential overlap between instant_provision and create_form is clearly resolved by the auth requirement.

    Naming Consistency5/5

    All tool names follow a consistent lowercase snake_case verb_noun pattern (e.g., create_form, get_submissions, list_forms). There are no mixed conventions, camelCase, or vague standalone verbs, making the set predictable and readable.

    Tool Count5/5

    Seven tools is well-scoped for a forms management server. The count is sufficient to cover core operations (create, read, list, submissions, configuration, snippet generation) without being heavy or redundant.

    Completeness4/5

    The surface covers creation, retrieval, listing, submissions, configuration, and snippet generation. However, there are no update or delete operations for forms, which are common CRUD actions. This is a minor gap that agents can work around but might cause friction in full lifecycle management.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for Dashform (getaiform.com) - create and manage AI-powered forms, quizzes, and surveys. Supports form creation, response collection, analytics, and AI-driven form building with 15 tools across form management, response handling, and AI operations.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server that exposes RESTForge capabilities to AI agents, enabling them to set up, configure, generate code, and manage RESTForge projects through natural language.
      29
      44 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for reading, editing, and publishing Google Forms with the official Google Forms API. Enables AI agents to programmatically create, modify, and manage forms and responses.
      MIT