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 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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