@clipform/mcp-server
MCP server for Clipform - build and manage video-style forms from any MCP client (Claude, ChatGPT, Cursor, Windsurf, etc.).
Install
There are two ways to connect: remote (recommended, uses your Clipform account) and local (anonymous, free-tier limits).
Remote (recommended)
Use this if you have a Clipform account. Forms are created directly in your workspace and your plan tier applies (no 3-node cap on Pro).
Claude (claude.ai): Settings → Connectors → Add custom connector → enter https://mcp.clipform.io
ChatGPT: Settings → Connectors → Advanced → enable Developer Mode → Create connector → enter https://mcp.clipform.io (requires Pro/Team/Enterprise)
Any MCP client with OAuth: Point it at https://mcp.clipform.io - discovery, registration, and auth are handled automatically via OAuth 2.1 + Dynamic Client Registration (RFC 7591).
Local - Claude Code / Claude Desktop / Cursor / etc.
Use this for stdio-based MCP clients. Pass your API key to authenticate with your workspace and plan tier.
Claude Code:
claude mcp add clipform -e CLIPFORM_API_KEY=cf_xxx -- npx -y @clipform/mcp-server
Claude Desktop / Cursor / Windsurf / OpenClaw - add to your MCP config:
{
"mcpServers": {
"clipform": {
"command": "npx",
"args": ["-y", "@clipform/mcp-server"],
"env": {
"CLIPFORM_API_KEY": "cf_xxx",
"API_URL": "https://api.clipform.io"
}
}
}
}
Generate an API key in your Clipform dashboard under Developers > API keys. The local server always needs one - to try Clipform without an account, connect to https://mcp.clipform.io instead (see "How it works").
Environment variables
Tools
Your MCP client lists these automatically on connect (via tools/list). Full reference - arguments, schemas, and examples - is in the docs.
Example
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!"
How it works
Remote (OAuth): Bearer tokens are audience-bound to https://mcp.clipform.io (RFC 8707) and scoped to mcp only. Forms land directly in the workspace you approved during consent by default. One connection reaches every workspace you belong to in the same company: pass workspace_id (ids from clipform_whoami) on clipform_create_form, clipform_import_form, clipform_list_forms, clipform_upload_media_asset, or clipform_generate_tts, or a form_id from another workspace on any form tool - including clipform_upload_media_asset, clipform_generate_tts, and clipform_complete_media_upload, where it's a routing hint only (the result still lands in that workspace's media library, not on a node). Membership is re-checked on every call, and results name the workspace.
Local with API key: The CLIPFORM_API_KEY is sent as a standard Authorization: Bearer header. Forms are created directly in the key's workspace with your plan tier limits.
Remote anonymous (no sign-in): Connecting to https://mcp.clipform.io without signing in builds into a temporary account of the session's own. Forms stay drafts with a private preview link - nothing goes live - and while unclaimed, the form UUID is the credential to edit it. Build results include a one-time claim URL that signs you into that account (on the first form, periodically after, and at the form limit); free-plan limits apply. The local stdio server always needs CLIPFORM_API_KEY.
These tools need a signed-in Clipform account (OAuth, or an API key): clipform_list_forms, clipform_whoami, clipform_get_results, clipform_get_responses, clipform_delete_form. An anonymous remote session that calls one is asked to sign in instead. Everything else, including clipform_get_guide, clipform_get_workflow and clipform_list_assets, works without an account.
Forms are created with a start node and end screen automatically - you just add the nodes in between.
Links
- Clipform - Create interactive video forms
- Documentation - Full guide with node types and more
Craft guides (
clipform://guides/*,clipform_get_guide) are fetched from the Clipform API at runtime, so the server needs a reachableAPI_URLand validCLIPFORM_API_KEYto serve them.