MCP setup generator
Pick your AI assistant and copy the exact setup that connects it to FormDoc’s MCP server. Once connected, your assistant can create a form, fetch the code for your framework, test it and check the forms in your project. It works with Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI and Codex.
Get your setup
You need Node.js 18 or newer. FormDoc’s server runs with npx, so there’s nothing else to install.
Setup
How to use the MCP setup generator
- Choose your AI assistant and your computer’s operating system.
- Copy the command or the settings shown.
- Paste it where the generator says: your terminal, or the assistant’s MCP settings file.
- Restart or refresh the assistant and check that FormDoc is connected.
- Ask the assistant to add a contact form to your site with FormDoc.
What is MCP?
The Model Context Protocol (MCP) is an open standard that lets AI assistants use tools outside the chat. FormDoc’s MCP server runs on your computer with npx -y @formdocdev/cli mcp and gives your assistant a few form tools. There’s nothing to install beyond Node.js 18 or newer.
What your assistant can do with FormDoc
| Tool | What it does |
|---|---|
create_form |
Creates a form for your email address. You confirm it from your inbox and get the access key |
get_verification_status |
Checks whether the form is confirmed and active |
get_snippet |
Returns ready form code for HTML, Astro or vagejs, with your key filled in |
send_test_submission |
Sends one real test to your inbox |
check_forms_in_project |
Finds forms in your project that post to FormDoc and lists problems |
The assistant is told to ask for your real email address and never to make one up. It can’t read your submissions: those stay in your inbox and your FormDoc dashboard.
Tips
- Use it inside your project. Assistants that edit code (Claude Code, Cursor, VS Code, Windsurf) can paste the form into the right file for you.
- Confirm the email. FormDoc sends a confirmation link the first time; the form starts working when you click it.
- Check afterwards. Ask the assistant to run
check_forms_in_project, or paste the form into the AI form checker.
Prefer the terminal or a different assistant? The AI assistants guide covers the command line tool too, and the AI form prompt generator writes prompts for tools without MCP.
Common questions
Is FormDoc’s MCP server free?
Yes. The server is free, and forms on FormDoc’s Free plan receive 250 submissions a month.
Why does Windows need cmd /c?
Some apps on Windows can’t start npx directly, because npx is a script rather than a program. Running it through cmd /c works everywhere, so the generator adds it when you choose Windows.
Does the assistant need my password or an API key?
No. Creating a form only needs your email address, and you confirm it yourself by clicking the link FormDoc sends.
The assistant says FormDoc isn’t connected. What should I check?
Make sure Node.js 18 or newer is installed (run node --version), that the settings file is valid JSON with the formdoc entry inside the servers list, and that you restarted the assistant after saving.