Reference

Available MCP tools

Every connected client discovers the same HYBRD tools from the server. Clients should present the requested access to the signed-in athlete before calling them.

Tools

Tool	Description
`list_workouts`	List scheduled and completed workouts. Requires workouts:read.
`get_plan_intents`	Read the coaching narrative behind the current plan. Requires workouts:read.
`get_profile`	Read profile facts. Requires profile:read.
`list_benchmarks`	List latest performance benchmarks. Requires profile:read.
`get_onboarding_status`	Read remaining onboarding work. Requires profile:read.
`get_stripe_checkout_link`	Create a personal Stripe checkout link. Requires profile:read.
`update_profile`	Update profile facts. Requires profile:write.
`upsert_benchmarks`	Update performance benchmarks. Requires profile:write.
`create_workout`	Create a completed or scheduled workout. Requires workouts:write.

Create workouts and update profile data

Approved write tools let a connected AI create structured workouts and update profile facts and performance benchmarks. Workout creation requires workouts:write. Profile and benchmark updates require profile:write. Once workouts are in HYBRD, the platform handles delivery, logging, connected training data, and automatic pace and weight progression. Access remains tied to the HYBRD account you authorize.

Scopes

The authorization server advertises these four scopes. Request only the access the selected tools require. Workout writes are never part of a default read-only grant.

Scope	Description
`profile:read`	View profile facts, benchmarks, and remaining onboarding work.
`profile:write`	Update profile facts, body weight, timezone, and benchmarks.
`workouts:read`	View workouts and the coaching narrative behind the current plan.
`workouts:write`	Create completed or scheduled workouts.

Limits

list_workouts date windows are at most 90 days. With no dates, the default window is the last 7 days through the next 7 days.
list_workouts returns at most 20 workouts by default and 50 per page. Use nextCursor for the next page.
If a requested date window is too broad, narrow the window and make a follow-up request.
create_workout duration is at least 60 seconds. Use canonical units: kilograms, meters, seconds, watts, and seconds per kilometer.
Write-tool retry keys (idempotencyKey) are optional.
Stripe checkout links expire after 24 hours.