HIITplay Developer Docs

Free API sandbox

The curated five-minute workout is deterministic, read-only, and available without an account, API key, OAuth, or payment. It is a live contract, not a mocked response.

curl "https://hiitplay.fit/api/workouts/preview?duration_minutes=5"

Open the HIITplay API Sandbox for the request, response shape, failure example, and browser playback link.

MCP for AI clients

The Streamable HTTP server at /mcp exposes four tools and six documentation resources. Discovery and the free workout.preview tool are anonymous. Protected tools use OAuth dynamic client registration and the hiitplay.agent scope.

{
  "mcpServers": {
    "hiitplay": { "url": "https://hiitplay.fit/mcp" }
  }
}

See the MCP setup guide, server card, and protected-resource metadata.

Schemas and errors

The OpenAPI 3.1 document defines unique operation IDs, typed parameters, request bodies, response schemas, authentication, and structured errors. API errors include a stable code, human-readable message, and concrete resolution hint.

Markdown documentation is available at /docs.md, /mcp.md, and /llms.txt.

Product boundaries

HIITplay varies generated workouts by duration only. Integrations must not claim adaptation to goals, injuries, equipment, fitness level, or medical needs. Workout Session Links, OAuth credentials, and payment links are private and time-limited.