Frameo.AI MCP server reference
Frameo is an AI video production platform that takes an idea or a script to a finished short film, micro-drama, ad or social video. Images, video clips, voiceovers, music and sound effects are generated with the latest models, such as Seedance, Kling and Veo, kept consistent from shot to shot, and edited and assembled on one canvas. This MCP server brings that to Claude, ChatGPT, Cursor and any other MCP client, working in the user's own Frameo account.
The reference below is generated from the server's live tool list.
Endpoint
| Server URL | https://mcp.frameo.ai/mcp |
| Transport | Streamable HTTP (MCP) |
| Authentication | OAuth 2.1 with PKCE (S256), scope frameo |
Connecting
| Client | How |
|---|---|
| Claude | Settings → Connectors → Add custom connector, and paste the server URL. |
| ChatGPT | Add a custom app in Settings → Apps, and paste the server URL. |
| Claude Code | claude mcp add --transport http frameo https://mcp.frameo.ai/mcp |
| Cursor | Add to mcp.json: {"mcpServers": {"frameo": {"url": "https://mcp.frameo.ai/mcp"}}} |
On the first call the client opens Frameo's sign-in page. The user signs in with their
Frameo account, picks the workspace the connection starts in, and approves.
switch_workspace later moves the connection to any other workspace the user
belongs to. Disconnecting the connector in the client, or revoking it, ends access.
Directories
This MCP server is listed in:
Authorization
Clients discover everything from the protected-resource metadata; no client secret is issued, and every client is public and uses PKCE.
| Protected resource metadata | https://mcp.frameo.ai/.well-known/oauth-protected-resource/mcp |
| Authorization server metadata | https://mcp.frameo.ai/.well-known/oauth-authorization-server |
| Authorize | https://mcp.frameo.ai/authorize |
| Token | https://mcp.frameo.ai/token |
| Dynamic client registration | https://mcp.frameo.ai/register |
| Revocation | https://mcp.frameo.ai/revoke |
Client ID metadata documents are accepted in place of registration.
Overview
Errors
A tool that fails returns a result rather than a protocol error. error is a
stable code, hint says what to change, and retryable says whether
the same call may succeed later. A failed paid call states whether work started and what
was charged.
{
"ok": false,
"error": "quote_mismatch",
"hint": "These settings differ from the quoted ones (differs lists each). Nothing was charged, and the quote_id is still valid for its original settings; estimate_cost with the new settings returns a quote for them.",
"differs": {"resolution": {"quoted": "480p", "requested": "720p"}},
"retryable": false
}
Tools (63)
- add_sound_to_library
- add_upload_to_library
- analyze_media
- create_handoff
- create_modules
- create_project
- create_share_link
- create_upload_url
- delete_module
- delete_project
- delete_skill
- estimate_cost
- extract_frames
- generate_images
- generate_lipsync
- generate_music
- generate_sound_effect
- generate_speech
- generate_videos
- get_presets
- get_profile
- get_skill
- import_attachments
- import_media_url
- list_library
- list_models
- list_notes
- list_presets
- list_projects
- list_references
- list_skills
- make_control_map
- poll_balance
- poll_generation
- poll_home
- poll_project
- read_note
- read_settings
- refresh_media_links
- rename_module
- rename_project
- render_html_scene
- render_motion_graphics
- run_ffmpeg
- save_note
- save_reference
- save_skill
- search_sound_effects
- search_voices
- send_feedback
- show_balance
- show_choices
- show_generations
- show_home
- show_plan
- show_upload
- switch_workspace
- update_settings
- upscale_image
- upscale_video
- view_image
- wait_task
- whoami
add_sound_to_library Writes · free
Save a library sound to a project
| Argument | Type | Default |
|---|---|---|
sound_id |
string |
required |
project_id |
string |
optional |
module_id |
string |
optional |
request_text |
string |
optional |
add_upload_to_library Writes · free
Add uploads to the project's Library
| Argument | Type | Default |
|---|---|---|
file_urls |
string[] |
required |
project_id |
string |
optional |
module_id |
string |
optional |
names |
string[] |
optional |
analyze_media Uses credits
Analyze a video or audio clip
| Argument | Type | Default |
|---|---|---|
media_url |
string |
required |
question |
string |
required |
detect_shots |
boolean |
True |
project_id |
string |
optional |
module_id |
string |
optional |
confirmed_by_user |
boolean |
False |
create_handoff Writes · free
Open the web app signed in
| Argument | Type | Default |
|---|---|---|
page |
'canvas' | 'home' | 'pricing' |
required |
source |
string |
required |
project_id |
string |
optional |
module_id |
string |
optional |
create_modules Writes · free
Add modules to a project
| Argument | Type | Default |
|---|---|---|
project_id |
string |
required |
names |
string[] |
required |
create_project Writes · free
Create a project
| Argument | Type | Default |
|---|---|---|
name |
string |
required |
aspect_ratio |
string |
'9:16' |
description |
string |
'' |
create_upload_url Writes · free
Create upload links
| Argument | Type | Default |
|---|---|---|
file_names |
string[] |
required |
project_id |
string |
optional |
module_id |
string |
optional |
delete_module Can overwrite · free
Delete a module
| Argument | Type | Default |
|---|---|---|
project_id |
string |
required |
module_id |
string |
required |
confirmed_by_user |
boolean |
False |
delete_project Can overwrite · free
Delete a project
| Argument | Type | Default |
|---|---|---|
project_id |
string |
required |
confirmed_by_user |
boolean |
False |
delete_skill Can overwrite · free
Delete a skill
| Argument | Type | Default |
|---|---|---|
skill_id |
string |
required |
path |
string |
optional |
confirmed_by_user |
boolean |
False |
estimate_cost Read-only · free
Quote the cost of a generation
| Argument | Type | Default |
|---|---|---|
items |
any[] |
required |
project_id |
string |
optional |
module_id |
string |
optional |
extract_frames Writes · free
Extract frames from a video
| Argument | Type | Default |
|---|---|---|
video_url |
string |
required |
duration |
number |
optional |
at_seconds |
number[] |
optional |
start_ms |
integer |
optional |
end_ms |
integer |
optional |
project_id |
string |
optional |
module_id |
string |
optional |
generate_images Uses credits
Generate images
| Argument | Type | Default |
|---|---|---|
items |
ImageItem[] |
required |
project_id |
string |
optional |
module_id |
string |
optional |
confirmed_by_user |
boolean |
False |
generate_lipsync Uses credits
Lip-sync a video to a voiceover
| Argument | Type | Default |
|---|---|---|
video_url |
string |
required |
audio_url |
string |
required |
model |
string |
optional |
project_id |
string |
optional |
module_id |
string |
optional |
request_text |
string |
optional |
quote_id |
string |
optional |
confirmed_by_user |
boolean |
False |
generate_music Uses credits
Generate a music track
| Argument | Type | Default |
|---|---|---|
prompt |
string |
required |
duration |
integer |
30 |
model |
string |
optional |
project_id |
string |
optional |
module_id |
string |
optional |
request_text |
string |
optional |
quote_id |
string |
optional |
confirmed_by_user |
boolean |
False |
generate_sound_effect Uses credits
Generate a sound effect
| Argument | Type | Default |
|---|---|---|
prompt |
string |
required |
duration |
integer |
5 |
model |
string |
optional |
project_id |
string |
optional |
module_id |
string |
optional |
request_text |
string |
optional |
quote_id |
string |
optional |
confirmed_by_user |
boolean |
False |
generate_speech Uses credits
Generate a voiceover
| Argument | Type | Default |
|---|---|---|
text |
string |
required |
voice_id |
string |
required |
language_code |
string |
optional |
stability |
number |
optional |
similarity |
number |
optional |
style_instructions |
string |
optional |
project_id |
string |
optional |
module_id |
string |
optional |
request_text |
string |
optional |
quote_id |
string |
optional |
confirmed_by_user |
boolean |
False |
generate_videos Uses credits
Generate videos
| Argument | Type | Default |
|---|---|---|
items |
VideoItem[] |
required |
project_id |
string |
optional |
module_id |
string |
optional |
confirmed_by_user |
boolean |
False |
get_presets Read-only · free
Get presets
| Argument | Type | Default |
|---|---|---|
preset_ids |
string[] |
required |
get_profile Read-only · free
Get the signed-in profile
No arguments.
get_skill Read-only · free
Get a skill's instructions
| Argument | Type | Default |
|---|---|---|
skill_id |
string |
required |
path |
string |
optional |
import_attachments Writes · free
Import files attached in the chat
| Argument | Type | Default |
|---|---|---|
files |
AttachedFile[] |
required |
project_id |
string |
optional |
module_id |
string |
optional |
import_media_url Writes · free
Import media from links
| Argument | Type | Default |
|---|---|---|
urls |
string[] |
required |
project_id |
string |
optional |
module_id |
string |
optional |
names |
string[] |
optional |
list_library Read-only · free
List a project's Library
| Argument | Type | Default |
|---|---|---|
project_id |
string |
optional |
module_id |
string |
optional |
kind |
string |
optional |
origin |
string |
optional |
cursor |
string |
optional |
list_models Read-only · free
List the generation models
| Argument | Type | Default |
|---|---|---|
kind |
string |
'video' |
list_notes Read-only · free
List or search a module's notes
| Argument | Type | Default |
|---|---|---|
path |
string |
'/' |
query |
string |
optional |
scope |
string |
optional |
project_id |
string |
optional |
module_id |
string |
optional |
list_presets Read-only · free
List presets
| Argument | Type | Default |
|---|---|---|
category |
string |
optional |
query |
string |
optional |
sub_category |
string |
optional |
list_projects Read-only · free
List projects
| Argument | Type | Default |
|---|---|---|
query |
string |
optional |
limit |
integer |
10 |
project_id |
string |
optional |
list_references Read-only · free
List a project's references
| Argument | Type | Default |
|---|---|---|
project_id |
string |
optional |
module_id |
string |
optional |
kind |
'character' | 'location' | 'prop' |
optional |
list_skills Read-only · free
List skills
No arguments.
make_control_map Uses credits
Make a depth, pose or cutout map
| Argument | Type | Default |
|---|---|---|
source_url |
string |
required |
extract |
'depth' | 'segmentation' | 'pose' | 'normals' | 'albedo' |
required |
prompt |
string |
optional |
output |
'cutout' | 'matte' |
optional |
colormap |
'grayscale' | 'turbo' |
optional |
quality |
'fast' | 'best' |
optional |
draw_mode |
'body-pose' | 'full-pose' | 'face-pose' | 'hand-pose' | 'face-hand-mask' | 'face-mask' | 'hand-mask' |
optional |
project_id |
string |
optional |
module_id |
string |
optional |
request_text |
string |
optional |
quote_id |
string |
optional |
confirmed_by_user |
boolean |
False |
poll_balance Read-only · free
Refresh the balance
| Argument | Type | Default |
|---|---|---|
generation_quote |
integer |
optional |
poll_generation Read-only · free
Refresh the generations gallery
| Argument | Type | Default |
|---|---|---|
generation_ids |
string[] |
required |
poll_home Read-only · free
Refresh the home card
| Argument | Type | Default |
|---|---|---|
limit |
integer |
6 |
poll_project Read-only · free
Open a project on the home card
| Argument | Type | Default |
|---|---|---|
project_id |
string |
optional |
module_id |
string |
optional |
read_note Read-only · free
Read a module's note
| Argument | Type | Default |
|---|---|---|
path |
string |
required |
scope |
string |
optional |
project_id |
string |
optional |
module_id |
string |
optional |
read_settings Read-only · free
Settings
No arguments.
refresh_media_links Read-only · free
Refresh media links
| Argument | Type | Default |
|---|---|---|
urls |
string[] |
required |
rename_module Can overwrite · free
Rename a module
| Argument | Type | Default |
|---|---|---|
project_id |
string |
required |
module_id |
string |
required |
name |
string |
required |
rename_project Can overwrite · free
Rename a project
| Argument | Type | Default |
|---|---|---|
project_id |
string |
required |
name |
string |
required |
render_html_scene Writes · free
Render an animated scene
| Argument | Type | Default |
|---|---|---|
jobs |
HtmlScene[] |
required |
project_id |
string |
optional |
module_id |
string |
optional |
render_motion_graphics Writes · free
Render a motion-graphics clip from a template
| Argument | Type | Default |
|---|---|---|
template |
string |
required |
reason |
string |
required |
title |
string |
optional |
subtitle |
string |
optional |
lines |
string[] |
optional |
aspect_ratio |
string |
'9:16' |
duration |
number |
5 |
font |
string |
'Inter' |
accent |
string |
optional |
background |
string |
optional |
text_color |
string |
optional |
count_from |
integer |
optional |
count_to |
integer |
optional |
project_id |
string |
optional |
module_id |
string |
optional |
run_ffmpeg Writes · free
Run an ffmpeg command
| Argument | Type | Default |
|---|---|---|
jobs |
FfmpegJob[] |
required |
project_id |
string |
optional |
module_id |
string |
optional |
request_text |
string |
optional |
save_note Can overwrite · free
Save a module's note
| Argument | Type | Default |
|---|---|---|
path |
string |
required |
value |
any |
required |
project_id |
string |
optional |
module_id |
string |
optional |
overwrite |
boolean |
False |
request_text |
string |
optional |
save_reference Can overwrite · free
Save a reference to a project
| Argument | Type | Default |
|---|---|---|
kind |
'character' | 'location' | 'prop' |
required |
name |
string |
required |
image_urls |
string[] |
required |
project_id |
string |
optional |
module_id |
string |
optional |
description |
string |
optional |
voice_id |
string |
optional |
save_skill Can overwrite · free
Save a skill
| Argument | Type | Default |
|---|---|---|
skill_id |
string |
required |
text |
string |
required |
path |
string |
optional |
title |
string |
optional |
summary |
string |
optional |
when |
string |
optional |
search_sound_effects Read-only · free
Search the sound-effect library
| Argument | Type | Default |
|---|---|---|
query |
string |
required |
category |
string |
optional |
max_duration |
integer |
optional |
limit |
integer |
8 |
search_voices Read-only · free
Search voices
| Argument | Type | Default |
|---|---|---|
query |
string |
'' |
gender |
string |
'' |
age |
string |
'' |
language_code |
string |
'' |
accent |
string |
'' |
limit |
integer |
8 |
send_feedback Writes · free
Send feedback to the Frameo team
| Argument | Type | Default |
|---|---|---|
title |
string |
required |
description |
string |
required |
feedback_type |
string |
required |
trigger |
string |
required |
project_id |
string |
optional |
module_id |
string |
optional |
tool_name |
string |
optional |
show_balance Read-only · free
Show balance
| Argument | Type | Default |
|---|---|---|
generation_quote |
integer |
optional |
show_choices Read-only · free
Ask the user questions on a card
| Argument | Type | Default |
|---|---|---|
questions |
Question[] |
required |
show_generations Read-only · free
Show generations
| Argument | Type | Default |
|---|---|---|
generation_ids |
string[] |
required |
final |
boolean |
required |
share_title |
string |
optional |
share_description |
string |
optional |
show_home Read-only · free
Frameo.AI
No arguments.
show_plan Read-only · free
Show a shot plan to approve
| Argument | Type | Default |
|---|---|---|
shots |
Shot[] |
required |
total_credits |
integer |
optional |
title |
string |
optional |
notes |
string |
optional |
aspect_ratio |
string |
optional |
show_upload Read-only · free
Upload files
| Argument | Type | Default |
|---|---|---|
project_id |
string |
optional |
module_id |
string |
optional |
switch_workspace Writes · free
Switch the workspace
| Argument | Type | Default |
|---|---|---|
workspace_id |
string |
required |
update_settings Writes · free
Save settings
| Argument | Type | Default |
|---|---|---|
set |
WorkspaceSetting |
required |
upscale_image Uses credits
Upscale an image
| Argument | Type | Default |
|---|---|---|
image_url |
string |
required |
factor |
number |
2.0 |
model |
string |
optional |
project_id |
string |
optional |
module_id |
string |
optional |
request_text |
string |
optional |
quote_id |
string |
optional |
confirmed_by_user |
boolean |
False |
upscale_video Uses credits
Upscale a video
| Argument | Type | Default |
|---|---|---|
video_url |
string |
required |
factor |
number |
2.0 |
model |
string |
optional |
project_id |
string |
optional |
module_id |
string |
optional |
request_text |
string |
optional |
quote_id |
string |
optional |
confirmed_by_user |
boolean |
False |
view_image Read-only · free
View an image or video frame
| Argument | Type | Default |
|---|---|---|
media_url |
string |
required |
resolution |
'default' | 'high' | 'max' |
'default' |
at_seconds |
number |
1.0 |
wait_task Read-only · free
Wait for generations to finish
| Argument | Type | Default |
|---|---|---|
generation_ids |
string[] |
required |
timeout_seconds |
integer |
25 |
whoami Read-only · free
Check the Frameo connection
No arguments.