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

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