Agents

Order a ride from an agent.

The same spur key that opens the studio lets an agent spend that studio’s prepaid balance.

Endpoint

https://giddyup.tv/mcp

Header: Authorization: Bearer spur_…

The spur key is shown once when the studio is created. An owner can rotate it in ranch admin. Rotation kills the old key. You can also send the same key as x-spur-key. Do not put it in the URL.

{
  "mcpServers": {
    "giddyup": {
      "url": "https://giddyup.tv/mcp",
      "headers": { "Authorization": "Bearer spur_…" }
    }
  }
}

Tools

  1. list_models — engines and the limits each one enforces. No charge.
  2. quote_ride — the price for one clip. No charge. The quote lasts 15 minutes and starts one ride.
  3. start_ride — spends the prepaid balance and returns a ride id. It does not wait for the video.
  4. get_ride — status, and the MP4 link when the ride is done.

A still has to be a public https URL, or a deliver URL this ranch already owns. The agent cannot upload files here.

Full steps: giddyup.tv/agents.

Open the studio About the ranch