The short answer
Key takeaways
- Remote MCP over HTTP with OAuth; no API key.
- Every tool spends the signed-in account’s credits.
- Prices can be checked before anything runs.
Endpoint
https://renderhour.com/api/mcp, over streamable HTTP.
Sign-in
The first time a tool runs, the client opens RenderHour to sign in and grant access (OAuth with PKCE). Tokens are tied to the account; no key is pasted into the client.
Tools
- get_balance: Credits left on the account, by wallet.
- add_footage: Bring a video the user shot into the account from a public https address (MP4 or MOV, up to 100 MB), so create_edit can cut it. Free. Answers with its id. A file on the user’s own computer cannot come through the chat: ask the user to upload it on the Footages page of the site (the answer of list_footage gives its address), then find it with list_footage.
- list_footage: The videos of the account that an edit can use, newest first: uploads and results, with id, name and length. Free.
- edit_cost: The exact price in credits of an edit of the given footage with a director, the price of a change to it afterwards, and the credits the account has. Free. Call it and tell the user the price before create_edit.
- create_edit: Cut the user’s footage into a finished video from a brief: the director picks the shots, cuts silences and filler words, frames for the canvas, adds captions and the music track. Spends credits: show the user the price from edit_cost first. A failed edit returns them. It takes a few minutes; the answer is an edit id for edit_status.
- edit_status: How far an edit is, and once it is done, links to its MP4 and SRT subtitles and its shot list. Free.
- request_changes: Ask for a change to a finished edit in words (“shorter”, “open on the product”, “no captions in the first five seconds”): a new version of it. Spends credits: show the user the change price from edit_cost or edit_status first. The answer is the new version’s edit id for edit_status.
- answer_questions: Answer the multiple-choice questions the director asked before writing an edit (edit_status shows them while the edit needs an answer). Ask the user, then pass the option number chosen for each question id; a question left out takes the suggested option. Without answers the director goes ahead with its suggestions 15 minutes after asking. Free.
- share_edit: A link to a finished edit that needs no account: kind view lets anyone with it watch the edit for 7 days; kind review lets anyone with it watch and leave comments at moments of it for 30 days (edit_status lists the comments). Free. Each call makes a new link; give it to the user.
- list_edits: The edits of the account, newest first, with their stage and price. Free.
Example requests
- Edit these three clips into a 30-second vertical Reel with captions; tell me the price first.
- Make a square version of my last edit for the feed.
- What did my last edit cost, and is it finished?