Servers Playground How we check Add a server Log in

Hyperhuman

Working Security A

cc.hyperhuman/hyperhumanv0.1.0 Domain verified

Create, personalize and deliver branded workouts and programs from any AI assistant.

Health & Science

Watch Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.hyperhuman.cc/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

adapt_plan

Adapts an existing program for a user profile. Use when the user wants to customize a program.

plan_idstring, required

localestring

team_idstring

max_weeksinteger

min_weeksinteger

end_user_ageinteger

end_user_genderstring

user_requirementsstring

workouts_per_weekinteger

end_user_fitness_levelsarray

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Hyperhuman MCP server | mcptry

Tools (45)

adapt_plan

Adapts an existing program for a user profile. Use when the user wants to customize a program.

Argument	Type	Description
locale	string
plan_id*	string
team_id	string
max_weeks	integer
min_weeks	integer
end_user_age	integer
end_user_gender	string
user_requirements	string
workouts_per_week	integer
end_user_fitness_levels	array

Input schema (JSON)

{
  "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
}

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.

Argument	Type	Description
locale	string
team_id	string
workout_id*	string
duration_max	integer
duration_min	integer
end_user_age	integer
end_user_gender	string
user_requirements	string
end_user_fitness_levels	array

Input schema (JSON)

{
  "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
}

clone_stock_programs

Clones stock programs to the user's team. Use when the user wants to add publisher programs to their library.

Argument	Type	Description
program_ids*	array

Input schema (JSON)

{
  "type": "object",
  "required": [
    "program_ids"
  ],
  "properties": {
    "program_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "minItems": 1
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
title	string
locale	string
team_id	string
source_id	string
source_ids	array
source_type*	string

Input schema (JSON)

{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "source_id"
      ]
    },
    {
      "required": [
        "source_ids"
      ]
    }
  ],
  "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
}

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.

Argument	Type	Description
name*	string
rounds	integer
team_id	string
group_type	string
exercise_ids*	array
rest_seconds	integer

Input schema (JSON)

{
  "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
}

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.

Argument	Type	Description
rpe	integer
pace	string
reps	integer
amrap	boolean
team_id	string
skip_intro	boolean
time_based*	boolean
exercise_id*	string
weight_level	string
duration_seconds	integer

Input schema (JSON)

{
  "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
}

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).

Argument	Type	Description
name*	string
team_id	string
goal_ids	array
difficulty	string
visibility	string
description	string
workout_ids	array
duration_in_weeks	integer
workouts_per_week	integer

Input schema (JSON)

{
  "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
}

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.

Argument	Type	Description
team_id	string
duration_seconds*	integer

Input schema (JSON)

{
  "type": "object",
  "required": [
    "duration_seconds"
  ],
  "properties": {
    "team_id": {
      "type": "string"
    },
    "duration_seconds": {
      "type": "integer",
      "minimum": 1
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
name*	string
team_id	string
instances	array
difficulty	string
visibility	string
description	string
category_ids	array
exercise_map	array

Input schema (JSON)

{
  "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
}

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.

Argument	Type	Description
drop_id*	string
team_id	string
duration	integer
aspect_ratio	string
channel_preset	string

Input schema (JSON)

{
  "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
}

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.

Argument	Type	Description
locale	string
team_id	string
goal_ids	array
max_weeks	integer
min_weeks	integer
difficulty	string
end_user_age	integer
end_user_gender	string
end_user_goal_ids	array
user_requirements	string
workouts_per_week	integer
end_user_fitness_levels

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.

Argument	Type	Description
team_id	string
equipment	array
exercise_id*	string
exercise_type	string
target_muscles	array
trainer_image_id	string
trainer_image_url	string
user_requirements	string
exercise_description	string

Input schema (JSON)

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).

Argument	Type	Description
locale	string
team_id	string
difficulty	string
category_id*	string
duration_max	integer
duration_min	integer
end_user_age	integer
end_user_gender	string
exercise_sources	array
end_user_goal_ids	array
user_requirements	string

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.

read-only

Argument	Type	Description
end_date	string
start_date	string
granularity	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "end_date": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    },
    "granularity": {
      "enum": [
        "hourly",
        "daily"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
limit	integer
days_back	integer
include_ai_clips	boolean
include_workouts	boolean
include_youtube_stats	boolean

Input schema (JSON)

{
  "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
}

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).

read-only

Argument	Type	Description
program_id	string
workout_id	string
browse_tool	string
sample_type	string

Input schema (JSON)

{
  "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
}

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).

read-only

Argument	Type	Description
platform	string
use_case	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "platform": {
      "enum": [
        "web",
        "mobile",
        "hardware",
        "cms"
      ],
      "type": "string",
      "default": "web"
    },
    "use_case": {
      "type": "string",
      "default": "mvp"
    }
  },
  "additionalProperties": false
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
locale	string
team_id	string
exercise_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "exercise_id"
  ],
  "properties": {
    "locale": {
      "type": "string"
    },
    "team_id": {
      "type": "string"
    },
    "exercise_id": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
locale	string
team_id	string
program_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "program_id"
  ],
  "properties": {
    "locale": {
      "type": "string"
    },
    "team_id": {
      "type": "string"
    },
    "program_id": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
locale	string
team_id	string
workout_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "workout_id"
  ],
  "properties": {
    "locale": {
      "type": "string"
    },
    "team_id": {
      "type": "string"
    },
    "workout_id": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
job_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
locale	string
workout_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "workout_id"
  ],
  "properties": {
    "locale": {
      "type": "string"
    },
    "workout_id": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
locale	string
workout_id*	string
browse_tool	string

Input schema (JSON)

{
  "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
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_equipment

Returns equipment for exercises. Use when updating exercise metadata or filtering exercises.

read-only

Argument	Type	Description
locale	string
category_id	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string"
    },
    "category_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

list_muscle_groups

Returns muscle groups for exercises. Use when updating exercise metadata or filtering exercises.

read-only

Argument	Type	Description
locale	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

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).

read-only

Argument	Type	Description
locale	string
difficulty	string
category_id	string
duration_max	integer
duration_min	integer

Input schema (JSON)

{
  "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
}

list_stock_programs

Returns platform stock programs (publisher programs). Use when the user wants to browse or clone stock programs.

read-only

Argument	Type	Description
page	integer
locale	string
sort_by	string
goal_ids	array
per_page	integer
sort_order	string
search_text	string
difficulties	array
duration_in_weeks	integer
workouts_per_week	integer

Input schema (JSON)

{
  "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
}

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.

read-only

Argument	Type	Description
page	integer
status	string
sort_by	string
team_id	string
per_page	integer
sort_order	string

Input schema (JSON)

{
  "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
}

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.

read-only

Argument	Type	Description
page	integer
coach	string
locale	string
team_id	string
per_page	integer
categories	array
search_text	string
skill_level	string
availability	string
equipment_ids	array
collection_names	array

list_team_goals

Returns fitness goals available for programs. Use when creating or generating programs to get valid goal IDs.

read-only

Argument	Type	Description
locale	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
page	integer
locale	string
sort_by	string
team_id	string
per_page	integer
sort_order	string
search_text	string

Input schema (JSON)

{
  "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
}

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).

read-only

Argument	Type	Description
page	integer
locale	string
sort_by	string
team_id	string
per_page	integer
sort_order	string
search_text	string

Input schema (JSON)

{
  "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
}

list_workout_categories

Returns workout categories for workouts. Use when creating or updating workouts to get valid category_ids.

read-only

Argument	Type	Description
locale	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
limit	integer
locale	string
team_id	string
end_user_age	integer
end_user_gender	string
end_user_goal_ids	array
end_user_fitness_levels	array

Input schema (JSON)

{
  "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
}

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).

read-only

Argument	Type	Description
limit	integer
locale	string
team_id	string
end_user_age	integer
end_user_gender	string
end_user_goal_ids	array
end_user_fitness_levels	array

Input schema (JSON)

{
  "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
}

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.

destructive

Argument	Type	Description
drop_id*	string
team_id	string
channel_preset	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "drop_id"
  ],
  "properties": {
    "drop_id": {
      "type": "string",
      "minLength": 1
    },
    "team_id": {
      "type": "string"
    },
    "channel_preset": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

regenerate_drop_cover

Regenerates AI cover image for a drop. Use when the user wants a new cover for the social asset.

destructive

Argument	Type	Description
drop_id*	string
team_id	string
duration	integer
aspect_ratio	string
channel_preset	string

Input schema (JSON)

{
  "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
}

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.

destructive

Argument	Type	Description
title	string
drop_id*	string
team_id	string
channel_preset	string

Input schema (JSON)

{
  "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
}

update_exercise_group

Updates an exercise group. Use when the user wants to change name, exercises, rounds, or rest time.

destructive

Argument	Type	Description
name	string
rounds	integer
team_id	string
group_id*	string
group_type	string
exercise_ids	array
rest_seconds	integer

Input schema (JSON)

{
  "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
}

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.

destructive

Argument	Type	Description
name	string
team_id	string
exercise_id*	string
skill_level	string
category_ids	array
equipment_ids	array
muscle_group_ids	array

Input schema (JSON)

{
  "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
}

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.

destructive

Argument	Type	Description
name	string
team_id	string
goal_ids	array
difficulty	string
program_id*	string
visibility	string
description	string
workout_ids	array
duration_in_weeks	integer
workouts_per_week	integer

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.

destructive

Argument	Type	Description
name	string
team_id	string
instances	array
difficulty	string
visibility	string
workout_id*	string
description	string
category_ids	array

Input schema (JSON)

{
  "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": [
    "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": [
    "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
}

Hyperhuman

Try it

adapt_plan

Hyperhuman

Try it

adapt_plan

Install

Tools (45)

Security checkA100/100