Direct a complete product film from your AI agent.

https://framedeo.com/mcp
Authorization: Bearer $FRAMEDEO_API_TOKEN

Turn https://acme.com into a 30-second launch film.
Use the attached logo and dashboard screenshot. Choose a clean technical
template, write a calm voice-over, add minimal music, generate the motion,
tighten scene three, then export H.264 at 1080p and return the download link.

---
name: framedeo
description: Direct, generate, edit, and export complete product films using Framedeo MCP tools. Use when creating launch videos, product demos, feature explainers, or marketing clips from a URL, brand logo, screenshots, and editorial images.
---

# Framedeo MCP Skill

Direct complete, narrated product films using Framedeo's 33 Model Context Protocol (MCP) tools. A product URL and real captures go in; an editable, rendered video file comes out.

## Server Connection

- Hosted HTTP endpoint: https://framedeo.com/mcp
- Authentication: Authorization: Bearer $FRAMEDEO_API_TOKEN
- Health check: https://framedeo.com/health

### Quick Connect (Claude Code)
```bash
claude mcp add --transport http --scope user \
  --header "Authorization: Bearer $FRAMEDEO_API_TOKEN" \
  framedeo https://framedeo.com/mcp
```

## Essential Rules

1. Grounded truth only: Never invent claims, user counts, logos, or quotes. Every beat must be vouched for by the inspected URL, user instructions, or uploaded captures.
2. The film is cut to the voice-over: Motion beats and cut points sync to the narration. You MUST attach the logo, template, voice-over, and music before calling framedeo_generate_film.
3. Logo is mandatory: Brand mark (framedeo_upload_logo) is required before generation will run.
4. Read before editing: Always call framedeo_read_film to inspect generated shots and beat IDs before issuing edits with framedeo_edit_film.
5. Exports render the saved project: framedeo_edit_film auto-saves. If manually editing DSL, save via framedeo_save_film before exporting.
6. Resume timeouts: Film generation and rendering happen asynchronously on the server. If a request times out, resume waiting with framedeo_wait_for_film or framedeo_get_export.
7. Keep media roles separate: framedeo_upload_screenshot is for complete, readable product UI. framedeo_upload_image is for editorial media that may be cropped and animated by a composition preset.

## 9-Step Director Workflow

1. Inspect URL:
   framedeo_inspect_url { "url": "https://example.com" }

2. Create Project & Brief:
   framedeo_create_project {
     "url": "https://example.com",
     "ai_instructions": "30-second crisp launch video focusing on developer ergonomics."
   }

3. Upload Brand Assets & Captures:
   framedeo_upload_logo { "project_id": "prj_...", "url": "https://example.com/logo.svg" }
   framedeo_upload_screenshot { "project_id": "prj_...", "url": "https://example.com/dashboard.png" }
   framedeo_upload_image { "project_id": "prj_...", "url": "https://example.com/customer-photo.jpg" }

   Editorial images may drive mosaic-window-flow, photo-constellation, split-word-media, card-detail-morph, folio-marquee, spotlight-carousel or flipbook-rush when the brief or reference clearly calls for one. They remain editable Studio groups with assets, direction, stagger, intensity, duration, crop, seed and exit controls.
   Product screenshots may drive the screenshot compositions macro-pullback, swing-tour, depth-cascade or tilted-scroll the same way: the camera frames each capture, which is never cropped.
   Search compositions need no upload: caret-close-up, iris-prompt or glow-trace draw a search field that types the query a customer would type, up to the click. Ask for the moment in the brief.

4. Choose Film Template:
   framedeo_list_templates { "project_id": "prj_..." }
   framedeo_choose_template { "project_id": "prj_...", "template_id": "problem-hinge-proof" }

5. Draft & Set Voice-Over Narration:
   framedeo_write_voiceover_script { "project_id": "prj_...", "target_seconds": 30 }
   framedeo_set_voiceover { "project_id": "prj_...", "script": "...", "voice_id": "v_..." }

6. Choose & Set Music Bed:
   framedeo_list_music { "mood": "tech" }
   framedeo_set_music { "project_id": "prj_...", "track_id": "trk_..." }

7. Generate Motion:
   framedeo_generate_film { "project_id": "prj_...", "wait": true }

8. Read Film & Refine Shots:
   framedeo_read_film { "project_id": "prj_..." }
   framedeo_edit_film {
     "project_id": "prj_...",
     "shot_id": "station-a",
     "instruction": "Hold the dashboard two seconds longer."
   }

9. Export Film & Download:
   framedeo_export_film {
     "project_id": "prj_...",
     "quality": "final",
     "resolution": "1080p",
     "format": "h264"
   }

## Tool Reference Index

- Projects: framedeo_inspect_url, framedeo_write_brief, framedeo_create_project, framedeo_list_projects, framedeo_get_project, framedeo_delete_project
- Assets: framedeo_upload_logo, framedeo_upload_image, framedeo_upload_screenshot, framedeo_upload_video, framedeo_upload_audio, framedeo_list_assets, framedeo_set_images, framedeo_set_screenshots
- Templates & Audio: framedeo_list_templates, framedeo_choose_template, framedeo_list_voices, framedeo_write_voiceover_script, framedeo_set_voiceover, framedeo_upload_voiceover, framedeo_remove_voiceover, framedeo_list_music, framedeo_set_music, framedeo_upload_music, framedeo_remove_music
- Generate & Edit: framedeo_generate_film, framedeo_wait_for_film, framedeo_read_film, framedeo_edit_film, framedeo_save_film
- Export: framedeo_export_film, framedeo_get_export, framedeo_download_export