formslist-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@formslist-mcp create a form endpoint for my newsletter signup"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| No | Create a working form endpoint instantly for any email — no account needed. The owner claims it later via the returned |
| Yes | Create a new form ( |
| Yes | List all forms in the account. |
| Yes | Get one form's details by |
| Yes | Get a form's submissions ( |
| Yes | Enable/configure the auto-response email ( |
| No | Pure local generator: builds an HTML |
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 buildThe 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 toolsconfigure_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
Scored across 7 tools
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.
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.
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.
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
Forms for AI agents. Build, publish, and read forms and their replies from any MCP client.
Create forms, read submissions, and build invitations from Claude, ChatGPT, or any MCP client.
MCP server for managing FormDesigner forms, fields, logic rules, themes, and entries
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP 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
- AlicenseAqualityCmaintenanceMCP server that exposes RESTForge capabilities to AI agents, enabling them to set up, configure, generate code, and manage RESTForge projects through natural language.2944 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for the Nextcloud Forms API v3 that enables secure creation, update, cloning, and validation of forms without exposing credentials to the AI agent.MIT
- AlicenseNot gradedqualityDmaintenanceMCP 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