# Modio MCP > Modio MCP connects your AI agent directly to the mod.io platform. Manage game mods and community content without leaving your chat window or IDE. You can list games and fetch stats, browse available mods, add comments, submit ratings, manage file dependencies, and track user activity for any mod. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** game-mods, modding-community, game-development, user-generated-content, mod-io ## Description This connector lets you take full control of the entire modding lifecycle through natural conversation. Whether you're a developer needing to monitor official content or a dedicated modder updating assets, you can handle it all directly from your AI client. You don't have to switch between dozens of tabs just to check community feedback or update file metadata. Need to see which mods rely on specific files? Just ask. Want to track how popular a new addition is? Get the stats instantly. This MCP lets you list games, manage user profiles, add comments and ratings, and even handle purchases right from your workflow. Because Vinkius hosts this MCP in their catalog, you connect once and gain access to all these powerful mod management tools. ## Tools ### add_mod_comment Posts a comment directly onto a specific mod's page. ### add_mod_dependencies Specifies additional required files or mods for an existing mod to function correctly. ### add_mod_metadata Adds descriptive key-value pairs to a mod's profile, enhancing its searchability. ### add_mod_rating Submits a star rating for a specific mod based on user experience. ### add_mod_tags Applies relevant keywords or tags to help users find the mod. ### add_mod Creates a brand new mod entry for use in a specific game. ### checkout_mod Handles the process of purchasing a paid mod using the user's account balance. ### delete_mod_comment Removes a comment that was previously posted on a mod. ### delete_mod_dependencies Removes required file dependencies from an existing mod's definition. ### delete_mod_metadata Clears out specific metadata key-value pairs attached to a mod. ### delete_mod_tags Removes one or more tags that were previously applied to the mod's listing. ### delete_mod Permanently deletes an entire mod from the platform. ### edit_mod Modifies general details and information for a mod that already exists. ### get_game_stats Retrieves current performance statistics for an entire game title. ### get_game Fetches comprehensive details about a specific game on the platform. ### list_games Provides a complete list of all games hosted across mod.io. ### list_my_mods Retrieves a list of mods created by the user or associated with their team. ### list_my_purchased Displays all mods that the authenticated user has paid for. ### list_my_ratings Shows a record of ratings submitted by the current user account. ### list_my_subscriptions Lists all mods that the authenticated user has chosen to follow for updates. ### get_me Retrieves and displays the details of the authenticated user's profile. ### list_my_wallets Shows all available digital wallets and their current balances for purchases. ### list_mod_comments Retrieves a list of comments that have been left on a specific mod. ### list_mod_dependencies Lists all required prerequisite mods or files for a given mod. ### get_mod_file Provides detailed information about a specific file attached to a mod. ### list_mod_files Generates a list of all files associated with a particular mod. ### list_mod_metadata Retrieves the metadata key-value pairs attached to a specific mod listing. ### get_mod_stats Fetches usage and popularity statistics for an individual mod. ### list_mod_tags Retrieves all keywords or tags applied to a specific mod. ### list_mod_team Shows which users are listed as team members for the mod. ### get_mod Retrieves all core details about a specific mod, including its description and version. ### list_mods Finds a list of all mods that belong to a single game title. ### subscribe_mod Sets up automatic notifications for updates on a mod the user is interested in. ### list_token_packs Displays available packages of in-game currency or tokens for a specific game. ### unsubscribe_mod Stops automatic notifications for a mod the user no longer needs updates on. ## Prompt Examples **Prompt:** ``` List games on mod.io with 'Space' in the name. ``` **Response:** ``` I found several games matching 'Space'. Notable titles include 'Space Engineers' (ID: 164) and 'Space Station 14' (ID: 392). Would you like to see the mods available for any of these? ``` **Prompt:** ``` Show me the most popular mods for game ID 123. ``` **Response:** ``` Fetching mods for game 123... I've found 10 mods. The top ones are 'HD Textures Pack' and 'Advanced UI Overhaul'. Would you like the details for a specific mod ID? ``` **Prompt:** ``` What are my current mod subscriptions? ``` **Response:** ``` Checking your profile... You are currently subscribed to 3 mods: 'Realistic Physics', 'Night Sky Mod', and 'Custom Shaders'. Would you like to check for updates on any of these? ``` ## Capabilities ### Discovering Game Content List games available on the platform and fetch detailed statistics for specific titles. ### Managing Mod Assets Add, edit, or delete mod content, including managing metadata key-value pairs and listing file dependencies. ### Community Interaction Submit ratings for mods, add comments, or list existing community discussions to track engagement. ### Tracking User Data View your personal profile details, list subscribed content, and check purchase history. ## Use Cases ### Assessing Launch Readiness A developer needs to know if their latest patch is stable. They ask their agent to run `get_mod_stats` for the core game and then use `list_my_wallets` to check if they have enough funds to purchase a necessary testing mod, all without leaving their terminal. ### Responding to Community Criticism A community manager notices complaints about poor organization. They ask the agent to run `list_mod_dependencies` for the problematic mod and then use `add_mod_metadata` to add clear instructions, solving the issue immediately. ### Updating Deprecated Content A modder finds that a critical file needs updating. They ask their agent to run `list_mod_files`, identify the outdated asset, and then use `edit_mod` to push out the new version. ### Market Research A user wants to see what’s popular in a new niche. They ask their agent to run `list_games` to find relevant titles, then use `get_game_stats` on the top contender to gauge its overall popularity. ## Benefits - You never have to switch context. Instead of visiting the mod.io website, checking stats, and then returning to your IDE, you can use this MCP connector directly in your agent's prompt. - It gives you granular control over content management. Need to add a description field or list dependencies for an old mod? Use `add_mod_metadata` or `add_mod_dependencies` without ever touching the web UI. - Community insights are instant. Instead of browsing forums, you can use the agent to run `list_mod_comments` and instantly assess community sentiment on a new feature. - Tracking is precise. You can get hard metrics using `get_mod_stats` or check out your own history with `list_my_purchased`, all in one chat session. - It simplifies content flow. Listing available games via `list_games` and then finding all mods for a title via `list_mods` makes initial research incredibly fast. ## How It Works The bottom line is that you get full mod management visibility without needing to log into the separate mod.io website. 1. Subscribe to this MCP and provide your mod.io API Key and Access Token. 2. Direct your AI agent to use the connector to perform a specific action (e.g., 'What mods are available for Game X?'). 3. The agent executes the tool call, pulling real-time data on games, files, or user activity back into the chat. ## Frequently Asked Questions **How do I list all available mods using the Modio MCP?** You can first run `list_games` to see what titles are available. Then, use `list_mods` with a specific game ID to get a comprehensive list of all mods for that title. **Can I check my personal mod history using the Modio MCP?** Yes, you can view what you've purchased by calling `list_my_purchased`, or see your community contributions by running `list_my_ratings`. **What if I need to update a mod and also fix its dependencies? Is that possible with Modio MCP?** Absolutely. You can use the agent to run `list_mod_dependencies` first to see what's required, and then use `add_mod_dependencies` to update the list directly. **Can I add metadata or tags to a mod using the Modio MCP?** Yes. Use `list_mod_metadata` first to see what's already there, and then use `add_mod_metadata` or `add_mod_tags` to apply new descriptive information. **Does the Modio MCP allow me to delete content?** Yes, you can perform cleanup actions like removing a mod using `delete_mod`, deleting comments with `delete_mod_comment`, or cleaning up files via `list_mod_files`.