create-video-gift

Create a video gift

Workflow for the myvideogift MCP server bundled with this plugin. A finished gift is an original song plus a cinematic photo-montage film, delivered at a shareable URL.

1. Check the account first — call check_account. Rendering spends one prepaid credit; if the balance is empty, stop and send the user to https://developers.myvideogift.com to top up. Don't gather inputs they can't spend.

2. Pick the occasion — call list_occasions and choose the id that fits (it drives the song's lyrics and tone). If more than one plausibly fits, ask the user rather than guessing.

3. Gather the inputs for create_gift:

   • recipient_name and relationship are required.
   • memory (a sentence or two) and up to 6 feeling_words noticeably improve the song — ask for them instead of leaving them blank.
   • photo_urls: up to 30 publicly fetchable image URLs of the recipient. Required to render. If the user's photos aren't hosted anywhere public, they must upload them somewhere fetchable first — the API pulls by URL.

4. Consent is a hard gate — rendering requires consent=true, an attestation that the user holds the rights to the photos and the recipient's depiction. Ask the user explicitly and only pass it after they confirm. Never set it on your own.

5. Draft costs nothing — create_gift with render=false creates a free draft you can show the user for approval. To render, call create_gift again with the same inputs plus render=true and consent=true (this creates the billable gift; the draft stays a draft).

6. Poll for the film — a render takes a few minutes and returns a poll_after_sec hint. Call get_gift with the returned gift_id until status is delivered, then give the user the film_url and the shareable gift_url.

If any tool returns an error about the key or balance, surface it verbatim — the messages are written for end users.