Hyperhuman MCP
An official Model Context Protocol server provided by Hyperhuman that enables AI assistants like Claude and Cursor to interact with Hyperhuman's fitness content infrastructure. It allows users to create, personalize, and deliver branded workouts and programs via API integration.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mcp.hyperhuman.cc/mcpWhat you can do with it
- Create personalized workout programs
- Deliver branded fitness content
- Integrate fitness APIs into AI agents
Source and maintenance
Protocol and capabilities
- Server
- hyperhuman 0.1.0
- MCP protocol
- 2025-06-18
- Tools
- 45 advertised
- Resources
- 1 advertised
- Resource templates
- 1 advertised
- Prompts
- Not advertised
{
"tools": {},
"resources": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
45 advertised
get_integration_plan — Get integration plan
Returns an integration strategy and step-by-step plan for Hyperhuman workouts or programs: embed (iframe), stream videos (VOD export), or custom player (API + playlist). Use when the user asks how to integrate Hyperhuman or what integration options exist. Pass platform (web/mobile/hardware/cms) and use_case (mvp, programs, ai_generated, corporate_wellness, vod, etc.). Not for copy-paste embed HTML snippets (use get_embed_code_samples for those).
{
"type": "object",
"properties": {
"platform": {
"enum": [
"web",
"mobile",
"hardware",
"cms"
],
"type": "string",
"default": "web"
},
"use_case": {
"type": "string",
"default": "mvp"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_sample_workouts — List sample workouts
Returns a workout carousel for sample-workout prompts. When the user is connected via OAuth, lists up to 8 team workouts through the Internal API (Bearer token only — no Content API key required). When not connected, returns up to 6 curated guest samples with embedDemoUrl. Use when the user asks for sample workouts, a workout carousel, or embed demo preview. Not for full team-library admin views (use list_team_workouts), integration plans (use get_integration_plan), or copy-paste embed HTML (use get_embed_code_samples).
{
"type": "object",
"properties": {
"locale": {
"type": "string"
},
"difficulty": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
},
"category_id": {
"type": "string"
},
"duration_max": {
"type": "integer",
"maximum": 120,
"minimum": 5
},
"duration_min": {
"type": "integer",
"maximum": 120,
"minimum": 5
}
},
"description": "Filters for sample workouts. If both duration_min and duration_max are set, duration_min must be <= duration_max.",
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_workout_details — Get workout details
Returns workout metadata, preview assets, and summary. Use when the user selects a workout or asks for details about a specific workout. sample-* ids return a curated sample detail (no auth). Connected team workout ids use the Internal API (same data as get_team_workout). Other org ids use the Content API when the team has API entitlement.
{
"type": "object",
"required": [
"workout_id"
],
"properties": {
"locale": {
"type": "string"
},
"workout_id": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_workout_playlist — Get workout playlist
Returns playlist segments with timing and media pointers (progressive MP4/M4A URLs, typically ~7 days). sample-* ids return a curated sample playlist (no auth, no live media URLs). Connected org ids use the Content API when the team has API entitlement. Use when the user wants to see the segment structure or how to play a workout.
{
"type": "object",
"required": [
"workout_id"
],
"properties": {
"locale": {
"type": "string"
},
"workout_id": {
"type": "string",
"minLength": 1
},
"browse_tool": {
"enum": [
"list_team_workouts",
"list_sample_workouts",
"list_team_programs",
"list_team_exercises",
"list_team_drops"
],
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_embed_code_samples — Get embed code samples
Returns static copy-paste code templates for workout embeds (keyHandshake iframe), program page embeds, custom player JavaScript, or Content API cURL snippets. All samples contain only placeholder values (YOUR_ORG_ID, YOUR_API_KEY) — no real credentials are fetched or transmitted. Defaults sample_type to embed_prebuilt when omitted. Primary tool when the user asks for embed code, iframe HTML, or API snippet examples. Not for integration strategy or step-by-step plans (use get_integration_plan).
{
"type": "object",
"properties": {
"program_id": {
"type": "string"
},
"workout_id": {
"type": "string"
},
"browse_tool": {
"enum": [
"list_team_workouts",
"list_sample_workouts",
"list_team_programs",
"list_team_exercises",
"list_team_drops"
],
"type": "string"
},
"sample_type": {
"enum": [
"embed_prebuilt",
"embed_ai_generated",
"custom_progress",
"custom_navigation",
"custom_integration_flow",
"content_api_list_plans",
"content_api_list_workouts",
"content_api_list_groups",
"embed_program_page",
"content_api_plan_workouts"
],
"type": "string",
"default": "embed_prebuilt"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_team_workouts — List team workouts
Returns workouts for the authenticated user's team via Internal API. Use when the user asks to see my team's workouts, my team workouts, or their organization workout library. Requires OAuth. Not for curated sample workouts or guest embed demo (use list_sample_workouts).
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1
},
"locale": {
"type": "string"
},
"sort_by": {
"enum": [
"duration",
"updatedAt",
"name",
"difficulty",
"visibility"
],
"type": "string"
},
"team_id": {
"type": "string"
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"sort_order": {
"enum": [
"ascend",
"descend"
],
"type": "string"
},
"search_text": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_team_workout — Get team workout
Returns full details of a workout from the team. Use when the user selects a workout or asks for details about a specific workout.
{
"type": "object",
"required": [
"workout_id"
],
"properties": {
"locale": {
"type": "string"
},
"team_id": {
"type": "string"
},
"workout_id": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_team_programs — List team programs
Returns workout programs (collections) for the authenticated user's team. Use when the user asks to see programs, training plans, or workout collections.
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1
},
"locale": {
"type": "string"
},
"sort_by": {
"enum": [
"name",
"updatedAt",
"durationInWeeks",
"workoutsPerWeek",
"difficulty"
],
"type": "string"
},
"team_id": {
"type": "string"
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"sort_order": {
"enum": [
"ascend",
"descend"
],
"type": "string"
},
"search_text": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_team_program — Get team program
Returns full details of a workout program from the team. Use when the user selects a program or asks for program structure.
{
"type": "object",
"required": [
"program_id"
],
"properties": {
"locale": {
"type": "string"
},
"team_id": {
"type": "string"
},
"program_id": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_team_goals — List team goals
Returns fitness goals available for programs. Use when creating or generating programs to get valid goal IDs.
{
"type": "object",
"properties": {
"locale": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_workout_categories — List workout categories
Returns workout categories for workouts. Use when creating or updating workouts to get valid category_ids.
{
"type": "object",
"properties": {
"locale": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_muscle_groups — List muscle groups
Returns muscle groups for exercises. Use when updating exercise metadata or filtering exercises.
{
"type": "object",
"properties": {
"locale": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_equipment — List equipment
Returns equipment for exercises. Use when updating exercise metadata or filtering exercises.
{
"type": "object",
"properties": {
"locale": {
"type": "string"
},
"category_id": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_team_usage — Get team usage
Returns usage quotas for the authenticated team (e.g. social drop export count and limits). Use when the user asks about usage, quotas, or limits.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_session_summary — Get session summary
Returns team name, plan label, and usage limits for the connected account. Use only when the user explicitly asks about their team, plan, or usage quotas.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_api_usage_stats — Get API usage stats
Returns API key usage statistics for the current user's team. Use when the user asks about API usage, request counts, or rate limits.
{
"type": "object",
"properties": {
"end_date": {
"type": "string"
},
"start_date": {
"type": "string"
},
"granularity": {
"enum": [
"hourly",
"daily"
],
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_team_drops — List team drops
Returns social drops (videos, covers, copy) for the team. Use when the user asks about drops, social assets, or ready-to-download content.
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1
},
"status": {
"type": "string"
},
"sort_by": {
"enum": [
"updatedAt",
"createdAt",
"status"
],
"type": "string"
},
"team_id": {
"type": "string"
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"sort_order": {
"enum": [
"ascend",
"descend"
],
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_dashboard_summary — Get dashboard summary
Returns dashboard summary: latest created workouts with stats and ready-to-download items. Use when the user asks about dashboard, recent workouts, or content ready for download.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"days_back": {
"type": "integer",
"maximum": 365,
"minimum": 1
},
"include_ai_clips": {
"type": "boolean"
},
"include_workouts": {
"type": "boolean"
},
"include_youtube_stats": {
"type": "boolean"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}create_drop — Create drop
Creates a social drop from an exercise, exercise group, workout, or program. Use when the user wants to create social media content from existing content.
{
"type": "object",
"anyOf": [
{
"required": [
"source_id"
]
},
{
"required": [
"source_ids"
],
"properties": {
"source_ids": {
"minItems": 1
}
}
}
],
"required": [
"source_type"
],
"properties": {
"title": {
"type": "string"
},
"locale": {
"type": "string"
},
"team_id": {
"type": "string"
},
"source_id": {
"type": "string"
},
"source_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 7
},
"source_type": {
"enum": [
"exercise",
"exerciseCollection",
"workout",
"workoutCollection"
],
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}regenerate_drop_copy — Regenerate drop copy
Regenerates AI copy pack (hook, caption, hashtags, CTA) for a drop. Use when the user wants to refresh or improve the social copy.
{
"type": "object",
"required": [
"drop_id"
],
"properties": {
"drop_id": {
"type": "string",
"minLength": 1
},
"team_id": {
"type": "string"
},
"channel_preset": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}regenerate_drop_cover — Regenerate drop cover
Regenerates AI cover image for a drop. Use when the user wants a new cover for the social asset.
{
"type": "object",
"required": [
"drop_id"
],
"properties": {
"drop_id": {
"type": "string",
"minLength": 1
},
"team_id": {
"type": "string"
},
"duration": {
"type": "integer",
"maximum": 60,
"minimum": 15
},
"aspect_ratio": {
"enum": [
"9:16",
"1:1",
"16:9"
],
"type": "string"
},
"channel_preset": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}export_drop — Export drop
Exports drop assets for a channel (video URL, cover URL, copy pack). Use when the user wants to download assets or prepare a drop for external publishing.
{
"type": "object",
"required": [
"drop_id"
],
"properties": {
"drop_id": {
"type": "string",
"minLength": 1
},
"team_id": {
"type": "string"
},
"duration": {
"type": "integer",
"maximum": 60,
"minimum": 15
},
"aspect_ratio": {
"enum": [
"9:16",
"1:1",
"16:9"
],
"type": "string"
},
"channel_preset": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}generate_program — Generate program
Generates an AI training program using team workouts. Use when the user wants to create a multi-week program from their workout library.
{
"type": "object",
"properties": {
"locale": {
"type": "string"
},
"team_id": {
"type": "string"
},
"goal_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"max_weeks": {
"type": "integer",
"maximum": 24,
"minimum": 1
},
"min_weeks": {
"type": "integer",
"maximum": 24,
"minimum": 1
},
"difficulty": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
},
"end_user_age": {
"type": "integer",
"maximum": 100,
"minimum": 16
},
"end_user_gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"end_user_goal_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"user_requirements": {
"type": "string",
"maxLength": 2000
},
"workouts_per_week": {
"type": "integer",
"maximum": 7,
"minimum": 1
},
"end_user_fitness_levels": {
"type": "array",
"items": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
}
},
"end_user_training_days_per_week": {
"type": "integer",
"maximum": 7,
"minimum": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}create_workout — Create workout
Creates a workout from exercise and rest instances. Use when the user wants to build a custom workout. Provide either exercise_map (ordered array of instance IDs from create_exercise_instance and create_rest_instance) or instances (raw instance objects). Workout cannot start or end with rest.
{
"type": "object",
"anyOf": [
{
"required": [
"exercise_map"
]
},
{
"required": [
"instances"
]
}
],
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"team_id": {
"type": "string"
},
"instances": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"difficulty": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
},
"visibility": {
"enum": [
"public",
"private"
],
"type": "string"
},
"description": {
"type": "string"
},
"category_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"exercise_map": {
"type": "array",
"items": {
"type": "object",
"required": [
"instance_id"
],
"properties": {
"instance_id": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"minItems": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}update_workout — Update workout
Updates an existing workout. Use when the user wants to change workout name, description, difficulty, visibility, or exercise structure. When only partial fields are provided (e.g. name), the current workout data is fetched and merged automatically.
{
"type": "object",
"required": [
"workout_id"
],
"properties": {
"name": {
"type": "string"
},
"team_id": {
"type": "string"
},
"instances": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"difficulty": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
},
"visibility": {
"enum": [
"public",
"private"
],
"type": "string"
},
"workout_id": {
"type": "string",
"minLength": 1
},
"description": {
"type": "string"
},
"category_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}create_program — Create program
Creates a workout program from team workouts. Use when the user wants to organize workouts into a multi-week program. Requires goal_ids (1-2) and workout_ids (min 2).
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"team_id": {
"type": "string"
},
"goal_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 2,
"minItems": 1
},
"difficulty": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
},
"visibility": {
"enum": [
"public",
"private"
],
"type": "string"
},
"description": {
"type": "string"
},
"workout_ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2
},
"duration_in_weeks": {
"type": "integer",
"maximum": 52,
"minimum": 1
},
"workouts_per_week": {
"type": "integer",
"maximum": 7,
"minimum": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}update_program — Update program
Updates an existing program. Use when the user wants to set duration, workouts per week, or edit program metadata. When updating, provide full program data (goal_ids, workout_ids, visibility, difficulty) from get_team_program and merge your changes.
{
"type": "object",
"required": [
"program_id"
],
"properties": {
"name": {
"type": "string"
},
"team_id": {
"type": "string"
},
"goal_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 2,
"minItems": 1
},
"difficulty": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
},
"program_id": {
"type": "string",
"minLength": 1
},
"visibility": {
"enum": [
"public",
"private"
],
"type": "string"
},
"description": {
"type": "string"
},
"workout_ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2
},
"duration_in_weeks": {
"type": "integer",
"maximum": 52,
"minimum": 1
},
"workouts_per_week": {
"type": "integer",
"maximum": 7,
"minimum": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}update_exercise_group — Update exercise group
Updates an exercise group. Use when the user wants to change name, exercises, rounds, or rest time.
{
"type": "object",
"required": [
"group_id"
],
"properties": {
"name": {
"type": "string"
},
"rounds": {
"type": "integer",
"minimum": 1
},
"team_id": {
"type": "string"
},
"group_id": {
"type": "string",
"minLength": 1
},
"group_type": {
"enum": [
"circuit",
"sets"
],
"type": "string"
},
"exercise_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"rest_seconds": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}update_exercise_metadata — Update exercise metadata
Updates exercise metadata (name, muscle groups, categories, equipment, skill level). Use when the user wants to fix or improve exercise tagging. Only team-owned exercises can be updated; stock exercises are read-only. Provide at least one field to update besides exercise_id.
{
"type": "object",
"required": [
"exercise_id"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"team_id": {
"type": "string"
},
"exercise_id": {
"type": "string",
"minLength": 1
},
"skill_level": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
},
"category_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"equipment_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"muscle_group_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}list_stock_programs — List stock programs
Returns platform stock programs (publisher programs). Use when the user wants to browse or clone stock programs.
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1
},
"locale": {
"type": "string"
},
"sort_by": {
"enum": [
"name",
"createdAt",
"updatedAt",
"durationInWeeks",
"workoutsPerWeek",
"difficulty"
],
"type": "string"
},
"goal_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"sort_order": {
"enum": [
"ascend",
"descend"
],
"type": "string"
},
"search_text": {
"type": "string"
},
"difficulties": {
"type": "array",
"items": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
}
},
"duration_in_weeks": {
"type": "integer"
},
"workouts_per_week": {
"type": "integer"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}clone_stock_programs — Clone stock programs
Clones stock programs to the user's team. Use when the user wants to add publisher programs to their library.
{
"type": "object",
"required": [
"program_ids"
],
"properties": {
"program_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}update_drop — Update drop
Updates a drop title or channel preset. Use when the user wants to change drop display title or default export channel. For copy changes use regenerate_drop_copy.
{
"type": "object",
"required": [
"drop_id"
],
"properties": {
"title": {
"type": "string"
},
"drop_id": {
"type": "string",
"minLength": 1
},
"team_id": {
"type": "string"
},
"channel_preset": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}list_team_exercises — List team exercises
Returns exercises from the team library. Use when the user wants to browse exercises, find exercises for workouts, or manage the library.
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1
},
"coach": {
"enum": [
"male",
"female"
],
"type": "string"
},
"locale": {
"type": "string"
},
"team_id": {
"type": "string"
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"categories": {
"type": "array",
"items": {
"type": "string"
}
},
"search_text": {
"type": "string"
},
"skill_level": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
},
"availability": {
"enum": [
"all",
"team",
"free-stock",
"premium-stock",
"all-stock"
],
"type": "string"
},
"equipment_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"collection_names": {
"type": "array",
"items": {
"type": "string"
}
},
"muscle_group_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_team_exercise — Get team exercise
Returns full details of an exercise from the team library. Use when the user selects an exercise or asks for exercise details.
{
"type": "object",
"required": [
"exercise_id"
],
"properties": {
"locale": {
"type": "string"
},
"team_id": {
"type": "string"
},
"exercise_id": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}create_exercise_instance — Create exercise instance
Creates an exercise instance with duration/reps, pace, weight, RPE. Use when building a workout manually - create instances for each exercise, then pass instance IDs to create_workout. Stock and team exercises can be used directly via exercise_id.
{
"if": {
"required": [
"time_based"
],
"properties": {
"time_based": {
"const": true
}
}
},
"else": {
"required": [
"reps"
]
},
"then": {
"required": [
"duration_seconds"
]
},
"type": "object",
"required": [
"exercise_id",
"time_based"
],
"properties": {
"rpe": {
"type": "integer",
"maximum": 10,
"minimum": 0
},
"pace": {
"enum": [
"slow",
"normal",
"fast"
],
"type": "string"
},
"reps": {
"type": "integer",
"minimum": 1
},
"amrap": {
"type": "boolean"
},
"team_id": {
"type": "string"
},
"skip_intro": {
"type": "boolean"
},
"time_based": {
"type": "boolean"
},
"exercise_id": {
"type": "string",
"minLength": 1
},
"weight_level": {
"enum": [
"light",
"medium",
"heavy"
],
"type": "string"
},
"duration_seconds": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}create_rest_instance — Create rest instance
Creates a rest/break instance for use between exercises in a workout. Use when building a workout manually - create rest instances, then include their IDs in create_workout exercise_map. Workout cannot start or end with rest.
{
"type": "object",
"required": [
"duration_seconds"
],
"properties": {
"team_id": {
"type": "string"
},
"duration_seconds": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}create_exercise_group — Create exercise group
Creates an exercise group (circuit or sets). Use when the user wants to group exercises for circuits or micro-workouts. Requires at least 2 exercise IDs.
{
"type": "object",
"required": [
"name",
"exercise_ids"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"rounds": {
"type": "integer",
"minimum": 1
},
"team_id": {
"type": "string"
},
"group_type": {
"enum": [
"circuit",
"sets"
],
"type": "string"
},
"exercise_ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2
},
"rest_seconds": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}generate_video_clip — Generate video clip
Generates an AI exercise video from a trainer photo (CloneMotion). Use when the user wants to create exercise videos without filming. Before calling, ensure you have the target exercise and image source (upload URL or saved trainer image ID); optionally ask for specific video requirements. Accepts trainer_image_url (HTTP URL or data:image/... base64) or trainer_image_id from Workout Defaults.
{
"type": "object",
"required": [
"exercise_id"
],
"properties": {
"team_id": {
"type": "string"
},
"equipment": {
"type": "array",
"items": {
"type": "string"
}
},
"exercise_id": {
"type": "string",
"minLength": 1
},
"exercise_type": {
"type": "string"
},
"target_muscles": {
"type": "array",
"items": {
"type": "string"
}
},
"trainer_image_id": {
"type": "string"
},
"trainer_image_url": {
"type": "string",
"pattern": "^(https?:\\/\\/|data:image\\/).+"
},
"user_requirements": {
"type": "string",
"maxLength": 2000
},
"exercise_description": {
"type": "string"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}get_video_generation_status — Get video generation status
Returns status and result of a CloneMotion video generation job. Use when the user wants to check if a generated video is ready or view the generated variants. Generation can take a few minutes; if status is pending or running, ask the user to check again after waiting.
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}generate_workout — Generate workout
Generates an AI workout via Content API. Use when the user wants to create a personalized workout on-the-fly. Returns workout structure (not persisted to team library by default).
{
"type": "object",
"required": [
"category_id"
],
"properties": {
"locale": {
"type": "string"
},
"team_id": {
"type": "string"
},
"difficulty": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
},
"category_id": {
"type": "string",
"minLength": 1
},
"duration_max": {
"type": "integer",
"maximum": 90,
"minimum": 10
},
"duration_min": {
"type": "integer",
"maximum": 90,
"minimum": 10
},
"end_user_age": {
"type": "integer",
"maximum": 100,
"minimum": 16
},
"end_user_gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"exercise_sources": {
"type": "array",
"items": {
"enum": [
"premium_stock",
"free_stock",
"team_exercises"
],
"type": "string"
}
},
"end_user_goal_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"user_requirements": {
"type": "string",
"maxLength": 2000
},
"end_user_fitness_levels": {
"type": "array",
"items": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
}
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}recommend_workouts — Recommend workouts
Returns ranked workout recommendations from the organization library (up to 12 workouts in the tool response; optional limit up to 20 is sent to the API). Use when the user wants instant suggestions based on profile (faster than generate).
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"locale": {
"type": "string"
},
"team_id": {
"type": "string"
},
"end_user_age": {
"type": "integer",
"maximum": 100,
"minimum": 16
},
"end_user_gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"end_user_goal_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"end_user_fitness_levels": {
"type": "array",
"items": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
}
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}adapt_workout — Adapt workout
Adapts an existing workout for a user profile. Use when the user wants to customize a workout (duration, difficulty, equipment) without generating from scratch.
{
"type": "object",
"required": [
"workout_id"
],
"properties": {
"locale": {
"type": "string"
},
"team_id": {
"type": "string"
},
"workout_id": {
"type": "string",
"minLength": 1
},
"duration_max": {
"type": "integer",
"maximum": 90,
"minimum": 10
},
"duration_min": {
"type": "integer",
"maximum": 90,
"minimum": 10
},
"end_user_age": {
"type": "integer",
"maximum": 100,
"minimum": 16
},
"end_user_gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"user_requirements": {
"type": "string",
"maxLength": 2000
},
"end_user_fitness_levels": {
"type": "array",
"items": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
}
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}recommend_plans — Recommend plans
Returns ranked program recommendations from the organization library (up to 12 programs in the tool response; optional limit up to 20 is sent to the API). Use when the user wants instant program suggestions.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"locale": {
"type": "string"
},
"team_id": {
"type": "string"
},
"end_user_age": {
"type": "integer",
"maximum": 100,
"minimum": 16
},
"end_user_gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"end_user_goal_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"end_user_fitness_levels": {
"type": "array",
"items": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
}
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}adapt_plan — Adapt plan
Adapts an existing program for a user profile. Use when the user wants to customize a program.
{
"type": "object",
"required": [
"plan_id"
],
"properties": {
"locale": {
"type": "string"
},
"plan_id": {
"type": "string",
"minLength": 1
},
"team_id": {
"type": "string"
},
"max_weeks": {
"type": "integer",
"maximum": 52,
"minimum": 1
},
"min_weeks": {
"type": "integer",
"maximum": 52,
"minimum": 1
},
"end_user_age": {
"type": "integer",
"maximum": 100,
"minimum": 16
},
"end_user_gender": {
"enum": [
"male",
"female"
],
"type": "string"
},
"user_requirements": {
"type": "string",
"maxLength": 2000
},
"workouts_per_week": {
"type": "integer",
"maximum": 7,
"minimum": 1
},
"end_user_fitness_levels": {
"type": "array",
"items": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
}
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}health_check — Health check
Returns MCP server readiness status with a fixed ready message. Use when the user asks if the Hyperhuman app is working, reachable, or connected.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"_viewType"
],
"properties": {
"_viewType": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}Prompts
Not advertised
Resources
1 advertised
Hyperhuman ChatGPT app widget
Interactive UI for Hyperhuman team content, workouts, programs, and developer integration outputs
ui://widget/hyperhuman-app.htmlHyperhuman ChatGPT app widget template
Interactive UI for Hyperhuman team content, workouts, programs, and developer integration outputs
ui://widget/hyperhuman-app.html30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 678 ms
- 95th percentile latency
- 678 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 678 ms · metadata changed · 45 tool(s), 1 resource(s), 1 resource template(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http hyperhuman-mcp https://mcp.hyperhuman.cc/mcpCodex
codex mcp add hyperhuman-mcp --url https://mcp.hyperhuman.cc/mcpCursor
{
"mcpServers": {
"hyperhuman-mcp": {
"url": "https://mcp.hyperhuman.cc/mcp"
}
}
}Cline
{
"mcpServers": {
"hyperhuman-mcp": {
"type": "streamableHttp",
"url": "https://mcp.hyperhuman.cc/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"hyperhuman-mcp": {
"type": "http",
"url": "https://mcp.hyperhuman.cc/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http hyperhuman-mcp https://mcp.hyperhuman.cc/mcpClaude Desktop
{
"mcpServers": {
"hyperhuman-mcp": {
"url": "https://mcp.hyperhuman.cc/mcp"
}
}
}Windsurf
{
"mcpServers": {
"hyperhuman-mcp": {
"serverUrl": "https://mcp.hyperhuman.cc/mcp"
}
}
}Let your agent find its tools
Find servers like Hyperhuman MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other ai and machine learning servers
Do you run Hyperhuman MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.