Forminal MCP server

Forminal is a hosted form builder. Your AI agent can build a form from a description, publish it, put it on any website as an inline embed or a popup, and read what people answered. This repository holds the install files for the Forminal MCP server, so you can add Forminal to Claude Code, Gemini CLI, Kiro, Cline and other agents.

The server is hosted, so there's nothing to install or run. Your agent connects to this address:

https://app.forminal.ai/mcp

The first time your agent calls it, a browser tab opens. You sign in to Forminal or create an account, then allow access. You don't need to create or paste a key.

Add it to your agent

An agent that runs with nobody there to sign in can send an API key instead. Create one in Forminal under Account menu, Profile, API keys, and send it as Authorization: Bearer <key>.

Step-by-step guides for each client: Connect your AI and MCP server.

Then ask for what you want

• "Make a contact form with name, email and message, and add it to the contact page."
• "Build a workshop sign-up form and open it in a popup from the Register button."
• "Turn this list of questions into a customer survey and publish it."
• "How many people answered the feedback form this week, and what did they say about pricing?"
• "Export last month's order form submissions to CSV."

The agent builds the form, publishes it, gives you the link or the embed snippet (or places it, if it can edit your site) and reads the answers when you ask.

Embed forms on any website

A published form has its own page with a link you can share, and it works on any site that takes HTML: WordPress, Webflow, Shopify, Squarespace, Wix, a static site or an app. get_embed_snippet returns the snippets for a form. Inline:

<script src="https://app.forminal.ai/embed.js" async></script>
<iframe data-src="https://app.forminal.ai/embed/<form id>" loading="lazy" width="100%" height="300" frameborder="0" title="Contact us"></iframe>

Or as a popup that opens from a button:

<script src="https://app.forminal.ai/embed.js" async></script>
<button data-open="<form id>" data-layout="modal">Open form</button>

The page never holds a key or calls the API. Full page, floating button and slider layouts are covered in Embed forms.

What the agent can do

• Forms: list, find, read, create, update, duplicate, publish or unpublish, delete, and check a form document with validate_form_document before saving it.
• Versions: every edit keeps the form as it was, so the agent can list earlier versions and put one back.
• Sharing: get_embed_snippet and get_form_links return the link, the inline embed and the popup snippet.
• Submissions: search, read, summarize, tag, mark as read or spam, delete, and export to CSV.
• Analytics: views, conversion, abandonments and drop-off per field, on plans that include Form analytics.
• Account: your plan and its features, and where each form sends its entries, with the last error, so the agent can tell you why entries aren't arriving.

The full list, with every argument, is served as JSON at https://app.forminal.ai/api/mcp/tools.

Access and deletes

• The agent works as you, on your plan and your forms. You can disconnect it at any time under Connected assistants on the API keys tab, and its next call is refused.
• Every tool that creates, changes, publishes or deletes something takes an ack code from the agent instructions, so an agent reads how Forminal works before it changes anything.
• Deleting forms or submissions takes two steps. The agent first gets a summary of what would go, and only deletes after you agree.
• Submissions are written by the people who filled in your form. Agents are told to treat them as data, never as instructions.

Plans

The free Lite plan includes unlimited forms and responses, with no card needed. Some features, such as form analytics, need a paid plan, and the agent can check yours with get_account before it promises one. See Pricing.

What's in this repo

The server is hosted, so this repo has no server code. These are the files each client needs to find and install it:

Help, privacy and terms

• Docs: https://forminal.ai/docs/
• Agent instructions: https://app.forminal.ai/llms.txt
• Privacy policy: https://forminal.ai/privacy/
• Terms: https://forminal.ai/terms/

License

The files in this repository are MIT licensed. See LICENSE. The Forminal service itself is covered by its terms.