Agents
Let an agent order the ride.
Point an MCP client at giddyup.tv/mcp with the studio spur key. The agent lists the models, gets a price, starts the ride, and picks up the MP4.
The key
The credential is the studio spur key. It is shown once when you create the studio, and again if an owner rotates it in ranch admin. Rotation kills the old key immediately.
Send it as Authorization: Bearer spur_…. The same key also works as the x-spur-key header. Keep it out of the URL. Google sign-in is for the browser. The agent uses the spur key.
The endpoint
The protocol address is https://giddyup.tv/mcp. Add it to the agent like this, and replace spur_… with the key:
{
"mcpServers": {
"giddyup": {
"url": "https://giddyup.tv/mcp",
"headers": { "Authorization": "Bearer spur_…" }
}
}
}The client posts JSON to that address. A browser visit shows a short card. This page is the guide.
The four tools
Ask the agent to use them in this order. Only start_ride spends money.
| Tool | What it does | Spends |
|---|---|---|
list_models | The engines this ranch can ride, and the duration, resolution, aspect, audio, and still limits each one enforces. | No |
quote_ride | The price of one clip, and a quote_id that lasts 15 minutes. | No |
start_ride | Starts that quoted clip and returns a ride id. It returns before the video is finished. | Yes |
get_ride | The status. When the ride is done, an MP4 link that lasts one hour. | No |
How a quote works
- Call
quote_ridewith a model id fromlist_models. Duration, resolution, aspect, and audio are optional. A value the model rejects comes back as an error. - Pass the same settings to
start_ride, plus an idea or a full prompt, unless the quote already has a still. - One quote starts one ride. Calling start again with a quote that already started returns the same ride id.
- If the price moves before the ride starts, the quote stays put. Quote again.
- If the ride fails to start, that quote is used up. Quote again before another try.
- A quote that sits for 15 minutes expires.
start_ride places the same hold as the studio. The amount is the quote. A ride that fails before delivery returns the hold. A Giddyup Biz ranch gets the same 15% off it gets in the studio.
Stills and references
A first frame, last frame, or reference image, video, or audio has to be a public https URL, or a deliver URL this ranch already owns. The agent has no upload tool. The models page lists which engines take a still and which take references.
What stays in the browser
The agent orders rides for one ranch. Opening the studio, inviting a member, adding credits, and rotating the key stay on the site. A request with no spur key is refused.