Ryot MCP Starter
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RYOT_COOKIE | No | Optional cookie string for authentication | |
| RYOT_USER_ID | No | User ID required for collection tools (e.g., watchlist, backlog) | |
| RYOT_BASE_URL | Yes | The base URL of your Ryot instance, e.g. https://ryot.shivansh.top | |
| RYOT_AUTH_HEADER | Yes | The exact Authorization header value, typically 'Bearer <token>' | |
| RYOT_WALKING_EXERCISE_ID | No | Optional default walking exercise ID | |
| RYOT_GAME_BACKLOG_COLLECTION | No | Default game backlog collection name | Game Backlog |
| RYOT_WALL_PUSHUP_EXERCISE_ID | No | Optional default wall pushup exercise ID | |
| RYOT_SIT_TO_STAND_EXERCISE_ID | No | Optional default sit-to-stand exercise ID | |
| RYOT_SHOW_WATCHLIST_COLLECTION | No | Default show watchlist collection name | Show Watchlist |
| RYOT_MOVIE_WATCHLIST_COLLECTION | No | Default movie watchlist collection name | Movie Watchlist |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ryot_health_checkA | Check whether the MCP can reach Ryot's GraphQL endpoint. |
| ryot_graphqlA | Run a GraphQL query or mutation against Ryot. Use after discovering the schema. |
| ryot_schema_searchA | Search the live Ryot GraphQL schema for types, fields, inputs, queries, and mutations. |
| ryot_find_candidate_operationsB | Find likely root GraphQL queries/mutations for the requested domain. |
| ryot_workout_discoveryC | Find Ryot schema operations and fields related to workouts, routines, exercises, sets, measurements, and fitness progress. |
| ryot_media_discoveryC | Find Ryot schema operations and fields related to movies, shows, books, podcasts, music, watchlists, and collections. |
| ryot_game_discoveryB | Find Ryot schema operations and fields related to video games, gaming progress, reviews, and collections. |
| ryot_log_workoutA | Create or update a completed Ryot workout. Requires Ryot exercise IDs, not exercise names. |
| ryot_create_workout_templateC | Create or update a Ryot workout template/routine. Requires Ryot exercise IDs. |
| ryot_log_body_measurementC | Log weight/body measurements in Ryot. Use statistic names like weight, waist, body_fat, chest, etc. |
| ryot_search_exercisesA | Search Ryot exercises. Returns Ryot's cached exercise ID response; use exercise IDs for workout logging/templates. |
| ryot_list_recent_workoutsB | List/search the user's logged workouts. Returns Ryot's cached workout ID response. |
| ryot_list_workout_templatesC | List/search Ryot workout templates/routines. Returns Ryot's cached template ID response. |
| ryot_get_workout_detailsB | Get full details for a logged workout by workoutId. |
| ryot_get_workout_template_detailsA | Get full details for a workout template/routine by workoutTemplateId. |
| ryot_log_walkB | Log a simple walking workout. Uses walkingExerciseId or RYOT_WALKING_EXERCISE_ID. Duration is stored as seconds. |
| ryot_log_bodyweight_setB | Log a simple bodyweight exercise workout, such as wall push-ups, squats, or chair sit-to-stands. Requires a Ryot exercise ID. |
| ryot_log_minimum_workoutA | Log the default minimum workout: walking + chair sit-to-stand + wall push-up. Exercise IDs can be passed or set via env vars. |
| ryot_create_minimum_routine_templateB | Create a reusable Minimum Day routine/template in Ryot. Exercise IDs can be passed or set via env vars. |
| ryot_start_today_routineC | Practical start/log shortcut for today. Since Ryot stores completed workout logs, this logs the minimum routine for today, optionally linked to a templateId. |
| ryot_search_mediaA | Search Ryot metadata for movies, shows, books, anime, manga, music, podcasts, games, etc. Returns Ryot's cached search response. |
| ryot_search_movieC | Search movies in Ryot. Defaults to TMDB. |
| ryot_search_showC | Search TV shows in Ryot. Defaults to TMDB; TVDB is also supported. |
| ryot_search_gameC | Search video games in Ryot using IGDB by default. |
| ryot_get_metadata_detailsC | Get Ryot metadata details for a movie/show/book/game/etc by metadataId. |
| ryot_get_user_metadata_detailsA | Get user-specific Ryot state for a metadata item: in-progress state, history, collections, reviews, and next episode/chapter when available. |
| ryot_get_movie_statusB | Get your Ryot status/history/collections for a movie by metadataId. |
| ryot_get_show_statusA | Get your Ryot status, episode history, show progress, next entry, and collections for a show by metadataId. |
| ryot_get_game_statusC | Get your Ryot playing status/history/collections/reviews for a video game by metadataId. |
| ryot_mark_media_progressB | Generic progress tool: start, complete, drop, hold, or update progress percent for any Ryot metadata item. |
| ryot_mark_movie_watchedB | Log a movie as completed/watched, optionally with startedOn and manualTimeSpent. |
| ryot_mark_movie_in_progressC | Start a new in-progress entry for a movie. |
| ryot_mark_show_episode_watchedC | Log one TV show episode as watched/completed, for example S01E05. |
| ryot_mark_show_episode_startedC | Start an in-progress entry for a specific TV episode. |
| ryot_mark_show_in_progressB | Mark a show's latest entry as in progress, or create a new in-progress entry if no episode is supplied. |
| ryot_mark_game_startedC | Start playing a game in Ryot. |
| ryot_mark_game_completedC | Mark a game as completed in Ryot. |
| ryot_mark_game_droppedC | Mark the latest game progress entry as dropped. |
| ryot_mark_game_on_holdC | Mark the latest game progress entry as on hold. |
| ryot_update_game_progress_percentC | Set progress percentage for the latest in-progress game entry. |
| ryot_create_collectionC | Create or update a Ryot collection such as Watchlist, Game backlog, Wishlist, or Fitness references. |
| ryot_add_to_collectionC | Add metadata, games, exercises, workouts, templates, or measurements to a Ryot collection. creatorUserId is required by Ryot; can be set via RYOT_USER_ID. |
| ryot_add_movie_to_watchlistB | Add a movie metadata item to your movie watchlist collection. Defaults to RYOT_MOVIE_WATCHLIST_COLLECTION or 'Movie Watchlist'. |
| ryot_add_show_to_watchlistC | Add a TV show metadata item to your show watchlist collection. Defaults to RYOT_SHOW_WATCHLIST_COLLECTION or 'Show Watchlist'. |
| ryot_add_game_to_backlogC | Add a video game metadata item to your game backlog collection. Defaults to RYOT_GAME_BACKLOG_COLLECTION or 'Game Backlog'. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/shivanshBTW/ryot-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server