MCP Server
Use Clipform from AI assistants like Claude, ChatGPT, Cursor, and more.
Clipform has an MCP server that lets AI assistants create and manage forms through conversation. Describe what you want and the assistant builds it - nodes, media, theming, and more.
Connect your AI assistant
Claude (claude.ai, Desktop, mobile)
Clipform is listed in the Claude Connectors Directory. In Claude, open Customize > Connectors, find Clipform, and click Connect - then sign in to Clipform and pick the workspace to use. That listing connects to https://mcp.clipform.io/forms: the form-building tools (create, edit, publish, results) with no media generation.
To add it by hand, or to get the media tools as well:
- Go to Customize > Connectors and click Add custom connector
- Enter
https://mcp.clipform.io/forms(forms and results) orhttps://mcp.clipform.io(everything, including narration and video) - Authorize access to your Clipform workspace when prompted
Both URLs work anonymously; you're asked to sign in when you publish (see Anonymous).
ChatGPT
Clipform is published as an app in ChatGPT. It's available on Free, Go, Plus, and Pro, and on Business, Enterprise, and Edu workspaces (an admin may need to enable apps first). It isn't available in the EEA, Switzerland, or the UK yet.
- Go to Settings then Apps (labelled Apps, Plugins, or Connectors depending on your version)
- Search for Clipform and select it
- Click Connect and authorize access to your Clipform workspace
Bring it into any chat with the + menu or by typing @Clipform.
To add it by hand instead - where the app directory isn't available, or to point at a specific URL - go to Settings > Security and login > Developer mode, enable it, then create a connector for https://mcp.clipform.io (everything, including media) or https://mcp.clipform.io/forms (forms and results only). Developer mode is web-only, on Plus, Pro, Business, Enterprise, and Edu.
Claude Code
Run this in your terminal:
claude mcp add --transport http clipform https://mcp.clipform.ioThis works without signing in (see Anonymous); run /mcp in Claude Code to sign in to your Clipform account.
To run the local stdio server instead, pass your API key (the local server always needs one):
claude mcp add clipform -e CLIPFORM_API_KEY=cf_xxx -- npx -y @clipform/mcp-serverGenerate an API key in your dashboard under Developers > API keys.
Claude Desktop
Connect through Customize > Connectors, the same as Claude above.
To run the local stdio server instead, add it to your claude_desktop_config.json with your API key (the local server always needs one):
{
"mcpServers": {
"clipform": {
"command": "npx",
"args": ["-y", "@clipform/mcp-server"],
"env": {
"CLIPFORM_API_KEY": "cf_xxx"
}
}
}
}With an API key, forms land directly in your workspace with your plan tier limits.
Other MCP clients (Cursor, Windsurf, OpenClaw, etc.)
For clients that support OAuth, point them at https://mcp.clipform.io. Discovery, registration, and authentication are handled automatically via RFC 9728, RFC 8414, and RFC 7591.
For clients that only support stdio transport, run the npx command with your API key (the local server always needs one):
{
"mcpServers": {
"clipform": {
"command": "npx",
"args": ["-y", "@clipform/mcp-server"],
"env": {
"CLIPFORM_API_KEY": "cf_xxx"
}
}
}
}If you're managing existing forms or pulling results (not building new ones with media), connect to https://mcp.clipform.io/forms instead of the bare URL - it cuts per-turn token cost by only loading the relevant tools, and it is what the Claude Connectors Directory listing uses. The bare URL loads everything, which is best when you're also building forms with media.
Load only the tools you need
Two ways to load a subset of tools instead of all of them, cutting per-turn token cost:
https://mcp.clipform.io/forms- a fixed surface: theaccountandformsgroups only. Use this for managing forms and reading results without media.?features=on the bare URL - pick any combination of groups, e.g.https://mcp.clipform.io?features=forms,media.
| Group | Covers |
|---|---|
account | Listing/viewing forms, results, and identity (clipform_whoami) |
forms | Building and editing forms, nodes, and logic, plus craft guides and build workflows |
research | Current-news lookup for quiz research, plus the generation audit log |
media | Generating, rendering, uploading, and searching media |
Combine any subset with commas. Omit the param to load every tool (the default), and an unrecognized value is ignored and falls back to loading everything. The guidance the assistant receives (build workflows, craft guides) adapts to the groups loaded, so a forms-only connection is never told to narrate or render.
What you can do
Form and node management
| Tool | Description |
|---|---|
clipform_whoami | Show the current identity, workspace, and plan |
clipform_create_form | Create a new form with nodes, theming, and tags in one call |
clipform_import_form | Convert a public Google Form, Typeform, or Tally form into a new draft Clipform |
clipform_get_form | View a form, all its nodes, and their routing |
clipform_get_results | View response counts, choice breakdowns, and recent open-text answers for a form |
clipform_get_responses | List individual responses with time filtering (since/until), search, and sort - text answers only |
clipform_update_form | Change title, live/draft status, or settings |
clipform_delete_form | Move a form to the trash (asks you to confirm first; restorable from the dashboard) |
clipform_add_node | Add a node to an existing form (inserting into a linear flow auto-relinks the chain) |
clipform_update_node | Update node text, type, config, or options |
clipform_delete_node | Remove a node (logic chain auto-relinks, asks you to confirm first) |
clipform_set_logic | Set a node's next node (linear routing) |
clipform_get_workflow | Step-by-step build recipe for a form type (quiz, survey, interview, testimonial, application, booking, intake, lead capture) |
clipform_get_guide | Craft guide for a form type - question design, pacing, scoring |
Research
| Tool | Description |
|---|---|
clipform_search_news | Look up recent news articles (NewsAPI and The Guardian) for topical quiz questions |
clipform_log_generation | Record the sources and image attributions a generated form used |
Media
| Tool | Description |
|---|---|
clipform_upload_media_asset | Create a video or image asset in the workspace media library, or store a consent-agreement PDF (batch, max 10) |
clipform_complete_media_upload | Finalize a direct upload started by clipform_upload_media_asset |
clipform_attach_node_media | Attach an existing media asset to one or more nodes (batch, max 10) |
clipform_get_node_media | View a node's media details |
clipform_delete_node_media | Remove media from a node |
Creative tools
| Tool | Description |
|---|---|
clipform_generate_tts | Generate narration audio with word-level captions |
clipform_search_media | Search royalty-free images and videos |
clipform_search_music | Search royalty-free music and ambient sounds |
clipform_render_composition | Render a composition to MP4, PNG, or GIF |
clipform_check_render | Check the status of a render job |
clipform_list_compositions | List available compositions and their prop schemas |
clipform_list_video_templates | List curated video recipes (guess-the-city, mystery reveal, and more) |
clipform_render_video_template | Render a curated video recipe with its controls - including the slideshow recipe for a narrated photo/clip montage |
clipform_fetch_boundary | Fetch a country, city, or region outline for the Map composition |
clipform_list_assets | List available sound effects, animations, and fonts |
How authentication works
Remote (claude.ai, ChatGPT, etc.)
When you connect via https://mcp.clipform.io or https://mcp.clipform.io/forms, OAuth 2.1 handles everything:
- Your AI client discovers our authorization server automatically
- You sign in to Clipform and approve access to a workspace
- Tokens are audience-bound to the exact URL you connected to and scoped to
mcponly - Forms are created directly in your workspace with your plan tier limits
The workspace you approve is the connection's default. One connection also reaches every other workspace you belong to in the same company: ask the assistant to work in a named workspace, and it targets that workspace for that request (use clipform_whoami to list them). Membership is checked on every request, and results name the workspace they landed in.
To disconnect, remove the connector in your AI client, or revoke it under Settings > Authorized apps in the Clipform dashboard.
API key (Claude Code, Claude Desktop, Cursor, etc.)
Set CLIPFORM_API_KEY as an environment variable. Generate keys in your dashboard under Developers > API keys.
With an API key:
- Forms are created directly in the workspace the key belongs to
- Your plan tier limits apply (no 3-node cap on Pro)
- No dashboard links needed
Anonymous (no auth)
When you connect to https://mcp.clipform.io (or /forms) without signing in:
- Each session gets its own temporary, claimable Clipform account behind the scenes, and every form you build in that conversation lands in it
- Forms are created as drafts with a preview link only you can open - nothing is public until you claim the account
- The free plan's limits apply (currently up to 5 forms) - hit the limit and the tool result includes a claim link
- While a form is unclaimed, its ID is itself the credential to edit it - anyone who has it can add or change content until you claim the account
- Use the claim link (returned with your first form, periodically after, and at the form limit) to sign into that account, then publish when ready
On clients that support signing in mid-conversation, asking to publish an anonymous form prompts you to link your account right there - the claim link still works everywhere.
When you sign in this way, any unclaimed form you reference moves into your account with the same links, so anything you already shared keeps working. It counts toward your plan's form limit.
What works anonymously, and what needs sign-in
Anonymous sessions can build: create or import a form, edit it by its form ID, attach media, render video, and read the craft guides, build workflows and creative asset catalog (clipform_get_guide, clipform_get_workflow, clipform_list_assets, which don't create an account at all).
Anything about your account needs you to sign in first: clipform_list_forms, clipform_whoami, clipform_get_results, clipform_get_responses, and clipform_delete_form. Called anonymously, these don't create a throwaway account. Claude prompts you to sign in; other clients get a tool error that says so, and you can keep building with the form ID from clipform_create_form in the meantime.
Example prompts
Try any of these with a connected assistant:
Create a Clipform called "Customer Feedback" with a choice question asking "How would you rate our service?" with options Excellent, Good, Fair, Poor, then an open-ended question asking "Any additional comments?", and finish with an end screen saying "Thanks for your feedback!"
Build a five-question trivia quiz called "Geography Challenge". Each question should be multiple choice with four options and one correct answer, and the end screen should thank the player for taking part.
Show me the results for my "Customer Feedback" form - the response counts for each choice and any recent open-text comments.
npm package
The MCP server is published as @clipform/mcp-server on npm.