@clipform/mcp-server 1.1.0 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +123 -87
  2. package/package.json +2 -6
package/README.md CHANGED
@@ -1,87 +1,123 @@
1
- # @clipform/mcp-server
2
-
3
- MCP server for [Clipform](https://clipform.io) - build and manage video-style forms from Claude Code, Claude Desktop, or any MCP client.
4
-
5
- ## Quick Start
6
-
7
- Add to your Claude Desktop config (`claude_desktop_config.json`):
8
-
9
- ```json
10
- {
11
- "mcpServers": {
12
- "clipform": {
13
- "command": "npx",
14
- "args": ["-y", "@clipform/mcp-server"]
15
- }
16
- }
17
- }
18
- ```
19
-
20
- Or for Claude Code, add to `.mcp.json`:
21
-
22
- ```json
23
- {
24
- "mcpServers": {
25
- "clipform": {
26
- "type": "stdio",
27
- "command": "npx",
28
- "args": ["-y", "@clipform/mcp-server"]
29
- }
30
- }
31
- }
32
- ```
33
-
34
- ## What you can do
35
-
36
- | Tool | Description |
37
- |------|-------------|
38
- | `clipform_create_form` | Create a new form with questions in one call |
39
- | `clipform_get_form` | View a form and all its questions |
40
- | `clipform_update_form` | Change the title or publish status |
41
- | `clipform_delete_form` | Delete an unclaimed form |
42
- | `clipform_add_question` | Add a question to an existing form |
43
- | `clipform_update_question` | Update question text, type, config, or options |
44
- | `clipform_delete_question` | Remove a question (logic chain auto-relinks) |
45
-
46
- ## Question types
47
-
48
- - **choice** - Multiple choice with single or multiple selection
49
- - **open** - Free-form text, audio, or video responses
50
- - **contact** - Collect name, email, phone, company, and more
51
- - **button** - Simple button for acknowledgment or navigation
52
- - **external_link** - Redirect to an external URL
53
- - **end_screen** - Customizable completion screen
54
-
55
- ## Example prompt
56
-
57
- > 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!"
58
-
59
- ## Configuration
60
-
61
- By default the server connects to `https://api.clipform.io`. To point at a local dev server:
62
-
63
- ```json
64
- {
65
- "mcpServers": {
66
- "clipform": {
67
- "command": "npx",
68
- "args": ["-y", "@clipform/mcp-server"],
69
- "env": {
70
- "SERVER_URL": "http://localhost:3003"
71
- }
72
- }
73
- }
74
- }
75
- ```
76
-
77
- ## How it works
78
-
79
- When you create a form, you get back an `edit_token` that authorizes all subsequent changes. The token works until the form is claimed by a user via the claim URL.
80
-
81
- Forms are created with a start node and end screen automatically - you just add the questions in between.
82
-
83
- ## Links
84
-
85
- - [Clipform](https://clipform.io) - Create interactive video forms
86
- - [Documentation](https://clipform.io/docs)
87
- - [GitHub](https://github.com/andy-cb-smith/vid-master)
1
+ # @clipform/mcp-server
2
+
3
+ MCP server for [Clipform](https://clipform.io) - build and manage video-style forms from Claude Code, Claude Desktop, or any MCP client.
4
+
5
+ ## Quick Start
6
+
7
+ Add to your Claude Desktop config (`claude_desktop_config.json`):
8
+
9
+ ```json
10
+ {
11
+ "mcpServers": {
12
+ "clipform": {
13
+ "command": "npx",
14
+ "args": ["-y", "@clipform/mcp-server"]
15
+ }
16
+ }
17
+ }
18
+ ```
19
+
20
+ Or for Claude Code, add to `.mcp.json`:
21
+
22
+ ```json
23
+ {
24
+ "mcpServers": {
25
+ "clipform": {
26
+ "type": "stdio",
27
+ "command": "npx",
28
+ "args": ["-y", "@clipform/mcp-server"]
29
+ }
30
+ }
31
+ }
32
+ ```
33
+
34
+ ## What you can do
35
+
36
+ ### Form & question management
37
+
38
+ | Tool | Description |
39
+ |------|-------------|
40
+ | `clipform_create_form` | Create a new form with questions in one call |
41
+ | `clipform_get_form` | View a form and all its questions |
42
+ | `clipform_update_form` | Change title, publish status, or settings (step counter, back nav) |
43
+ | `clipform_delete_form` | Delete an unclaimed form |
44
+ | `clipform_add_question` | Add a question to an existing form |
45
+ | `clipform_update_question` | Update question text, type, config, or options |
46
+ | `clipform_delete_question` | Remove a question (logic chain auto-relinks) |
47
+
48
+ ### Media & logic
49
+
50
+ | Tool | Description |
51
+ |------|-------------|
52
+ | `clipform_upload_question_media` | Attach video or image to a question |
53
+ | `clipform_get_question_media` | View a question's media details |
54
+ | `clipform_delete_question_media` | Remove media from a question |
55
+ | `clipform_attach_question_audio` | Attach audio to a still-image question |
56
+ | `clipform_set_question_logic` | Set branching logic on a question |
57
+ | `clipform_generate_tts` | Generate narration audio from text (Edge TTS) |
58
+ | `clipform_generate_slideshow` | Create a Ken Burns slideshow video from images + audio |
59
+ | `clipform_log_generation` | Save an audit trail for generated forms |
60
+
61
+ ### Content research
62
+
63
+ | Tool | Description |
64
+ |------|-------------|
65
+ | `formgen_search_images` | Search royalty-free images (Pexels, Unsplash, Pixabay, Wikimedia, NASA, iNaturalist) |
66
+ | `formgen_search_videos` | Search stock video clips (Pexels, Pixabay) |
67
+ | `formgen_search_knowledge` | Search Wikipedia for topic research |
68
+ | `formgen_search_news` | Search current news (NewsAPI, The Guardian) |
69
+ | `formgen_get_trivia` | Get ready-made trivia questions (Open Trivia DB, 24 categories) |
70
+ | `formgen_lookup_country` | Look up country data (capital, population, flags, etc.) |
71
+ | `formgen_get_daily_content` | Get today's NASA APOD and Wikipedia featured content |
72
+
73
+ ### Guided prompts
74
+
75
+ | Prompt | Description |
76
+ |--------|-------------|
77
+ | `create-quiz` | Best practices for building scored quizzes with media |
78
+ | `create-form` | Best practices for standard forms and surveys |
79
+ | `create-journo-request` | Turn a journalist's callout into a Clipform |
80
+
81
+ ## Question types
82
+
83
+ - **choice** - Multiple choice with single or multiple selection
84
+ - **open** - Free-form text, audio, or video responses
85
+ - **contact** - Collect name, email, phone, company, and more
86
+ - **button** - Simple button for acknowledgment or navigation
87
+ - **binary** - Two-option choice (yes/no, true/false, this vs that)
88
+ - **scale** - Rating scale
89
+ - **external_link** - Redirect to an external URL
90
+ - **end_screen** - Customizable completion screen with score-based content
91
+
92
+ ## Example prompt
93
+
94
+ > 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!"
95
+
96
+ ## Configuration
97
+
98
+ By default the server connects to `https://api.clipform.io`. To point at a local dev server:
99
+
100
+ ```json
101
+ {
102
+ "mcpServers": {
103
+ "clipform": {
104
+ "command": "npx",
105
+ "args": ["-y", "@clipform/mcp-server"],
106
+ "env": {
107
+ "SERVER_URL": "http://localhost:3003"
108
+ }
109
+ }
110
+ }
111
+ }
112
+ ```
113
+
114
+ ## How it works
115
+
116
+ When you create a form, you get back an `edit_token` that authorizes all subsequent changes. The token works until the form is claimed by a user via the claim URL.
117
+
118
+ Forms are created with a start node and end screen automatically - you just add the questions in between.
119
+
120
+ ## Links
121
+
122
+ - [Clipform](https://clipform.io) - Create interactive video forms
123
+ - [Documentation](https://clipform.io/docs)
package/package.json CHANGED
@@ -1,13 +1,9 @@
1
1
  {
2
2
  "name": "@clipform/mcp-server",
3
- "version": "1.1.0",
3
+ "version": "1.1.3",
4
4
  "description": "MCP server for building and managing Clipform video forms",
5
5
  "license": "MIT",
6
- "repository": {
7
- "type": "git",
8
- "url": "https://github.com/andy-cb-smith/vid-master",
9
- "directory": "packages/mcp-server"
10
- },
6
+ "homepage": "https://clipform.io",
11
7
  "type": "module",
12
8
  "main": "dist/index.js",
13
9
  "exports": {