Tools
Every tool the MCP server offers, and what it costs.
Nineteen tools. None of them posts or deletes.
| Tool | What it does | Cost |
|---|---|---|
get_account | Plan, credits and about how many videos they make, when they reset, and whether videos and slideshows are ready to make or what each still needs. | free |
list_personas | Personas (AI-made, labelled as AI) with poster links and clip ids. | free |
list_footage | Uploads (kind: demo, hook, ending, image, music) with their status. | free |
list_lines | Hook lines, from the library and your own (source, lang). | free |
list_slideshow_formats | Your saved slideshow formats, for make_slideshows. | free |
plan_videos | A numbered plan with the drafts, the cost and the credits after; renders nothing (count, format, persona_ids, demo_ids, lines, music, theme, variant). | free |
render_videos | Renders the drafts from plan_videos (1–20, one format). | 25 credits per video (held, charged when ready, back on failure) |
get_videos | Status and 1-hour download links, by ids, batch_id, or the 10 newest; says when to check again. | free |
cancel_videos | Cancels waiting videos (ids or batch_id); their credits come back. | free |
retry_video | Tries a failed video again. | 25 credits held again, as in the app |
make_slideshows | Slideshows from a saved format (format_id, count 1–20). | 25 credits each |
write_lines | AI writes hook lines from your app profile and saves them as your own. | AI credits (about 4–5) |
write_caption | AI writes a post caption for one video (video_id, platform). | AI credits (about 1–3) |
list_profiles | TikTok and Instagram profile cards, and which accounts are connected. | free |
get_plan | The posting calendar (from, to). | free |
add_to_plan | Puts a video on the calendar (video_id, profile_id, planned_at); does not post. | free |
remove_from_plan | Takes a video off the calendar; the video stays. | free |
start_upload | Starts an upload and returns a URL to PUT the file to (for apps that can send bytes; in a chat, upload in the app). | free |
finish_upload | Says the bytes are in, so Getuser processes the file. | free |
How the tools behave
- Plan, then pay.
render_videostakes thedraftsfromplan_videos(1–20, one format); a bare "make 5 videos" is refused, so the founder always sees the plan and its cost first. - No double charges. The server sends an idempotency key with every paid call itself: the same drafts sent twice answer the same videos ("These drafts were already sent … no new charge").
- Waiting. A video usually takes 1–3 minutes. While videos render,
get_videosanswers "check again in about N seconds" (30 seconds plus 15 for each waiting video, at most 5 minutes); follow that hint. There are no webhooks yet. - Short results. Plain sentences, then short JSON. Posters come as links, not images, to keep the chat small. Download links last one hour.
- Annotations. Paid tools carry
destructiveHint: falseandopenWorldHint: false; tools that are safe to repeat carryidempotentHint: true. - Setup.
get_accountsays for videos and for slideshows whether they are ready or what each still needs. Videos need the app, 5 demos and the founder's own reaction; slideshows need the app and 5 images. - Uploads.
start_uploadandfinish_uploadare for apps that can send file bytes. In a chat, the founder uploads in the app and the chat uses it. - Refusals. A refusal comes back as a tool error with the API's message and what to do: credits at
getuser.app/settings?tab=plan, setup atgetuser.app, full storage atgetuser.app/videos, new Terms by opening getuser.app once, a disconnected app by connecting again.