# Mod.io MCP > Modio MCP Server lets you manage your entire gaming modding library directly from any AI agent. Use this to browse games with `get_games`, search for mods using `get_mods`, or subscribe/unsubscribe from content with `subscribe_mod`. You can also rate specific mods with `rate_mod` and organize everything into custom collections using `add_collection`. It's the central hub for all your mod.io activity. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** modding, user-generated-content, game-api, digital-assets, community-management ## Description # Mod.io MCP Server Connect your mod.io account to any AI agent, and you'll manage your entire modding library without touching a browser. You just ask your agent what you need. This server gives your client direct access to the core features of mod.io: discovery, management, and user actions. It exposes tools that handle everything from pulling game stats to updating your subscription status. ### Game Information & Discovery You can start by seeing a complete list of every game hosted on mod.io using `get_games`. Need the deep dive? You'll pull detailed information about one specific title with `get_game` or grab performance metrics and stats for any given ID using `get_game_stats`. To find content, you can get all mods listed for a specified game through `get_mods`, and view specifics on a single mod using `get_mod`. When you need the actual files, you'll list all available assets with `get_mod_files` or retrieve a specific data file using `get_mod_file`. ### User Interaction & Account State Need to keep up with content? You can sign up for updates and access from a mod using `subscribe_mod`, and you'll remove that status entirely with `unsubscribe_mod`. When you give feedback, submit a rating—positive or negative—for any mod using `rate_mod`. Your account tools let you track what you own: check out every single mod you purchased via `get_my_purchases`, review your history of submitted ratings with `get_my_ratings`, and see which mods you're currently subscribed to by running `get_my_subscriptions`. For financials, you can display available credits and financial info using `get_my_wallets` or fetch the required text for user consent forms via `get_terms`. Finally, run `get_me` to pull your basic profile information. ### Organizing Mods & Collections The system lets you build custom organizational groups. You'll create a brand new grouping of mods using `add_collection`, and then list every available collection for a game with `get_collections`. To see what's inside, run `get_collection_mods` with a specific collection ID. If you find an existing mod that belongs in a group, you can add it to that collection using `add_mod`. ### Advanced Content Management (Creator Tools) If you're running the show and managing listings, these tools are for you. You can change details or metadata on an existing mod listing with `edit_mod`. If a mod needs to disappear from the system entirely, you'll delete it using `delete_mod`. ### Summary of Tools by Functionality * **Game Metadata:** Use `get_games`, `get_game_stats`, and `get_game` to know what games are out there. * **Mod Data Access:** Pull mod lists (`get_mods`), view details (`get_mod`), list files (`get_mod_files`), or get a specific file asset using `get_mod_file`. * **User Status:** Manage subscriptions and ratings with `subscribe_mod`, `unsubscribe_mod`, and `rate_mod`. * **Organization:** Build groups with `add_collection`, check available collections with `get_collections`, and view their contents via `get_collection_mods`. * **Creator Control:** Edit or remove listings using `edit_mod` and `delete_mod`. ## Tools ### add_collection Creates a new, organized grouping of mods within the platform. ### add_mod Adds an existing mod to a specified game's content list. ### get_collection_mods Retrieves a list of all mods that belong to a specific collection ID. ### get_collections Lists every mod collection available for a particular game. ### delete_mod Removes a mod from the system entirely. Use this carefully. ### edit_mod Changes the details or metadata for an existing mod listing. ### get_game_stats Retrieves performance metrics and statistics for a given game ID. ### get_game Pulls detailed information about one specific, known game title. ### get_games Gets the complete list of all games hosted on mod.io. ### get_me Fetches basic profile information for the authenticated user account. ### get_mod_file Retrieves the actual data file for a specified mod asset. ### get_mod_files Lists all available files and assets associated with a specific mod. ### get_mod Gets detailed information for one specific mod, including its creator and file status. ### get_mods Gets every single mod listed for a specified game title. ### get_my_purchases Shows all mods the user has bought using their account wallet. ### rate_mod Submits a specific rating (positive/negative) for a mod based on its ID. ### get_my_ratings Retrieves a history of all mod ratings submitted by the user. ### subscribe_mod Signs up the user to receive updates and access content from a given mod. ### get_my_subscriptions Lists every mod that the user is currently subscribed to. ### get_terms Fetches the required text and links needed for user consent forms. ### unsubscribe_mod Removes the user's subscription status for a specific mod. ### get_my_wallets Displays financial information and available credits for monetization actions. ## Prompt Examples **Prompt:** ``` List all games available on mod.io. ``` **Response:** ``` I've retrieved the list of games. You can explore titles like 'Deep Rock Galactic' (ID: 123) or 'Totally Accurate Battle Simulator' (ID: 456). Which one would you like to see mods for? ``` **Prompt:** ``` Show me the mods for game ID 123. ``` **Response:** ``` Fetching mods for game 123... I found several entries using `get_mods`. Notable mods include 'Enhanced Lighting' and 'New Maps Pack'. Would you like the full details for any of these? ``` **Prompt:** ``` Rate mod 789 for game 123 as positive. ``` **Response:** ``` Processing your rating... I've used `rate_mod` to submit a positive rating for mod 789 in game 123. Your feedback has been successfully recorded. ``` ## Capabilities ### Fetch Game Metadata & Stats You can get a list of all available games or pull deep statistics for any specific game title. ### Search and View Mods The system lets you search for mods associated with a game, view detailed descriptions, and retrieve individual mod files. ### Manage Subscriptions & Ratings You can programmatically subscribe or unsubscribe from mods, and submit content ratings directly through the agent. ### Handle User Collections The tools allow you to create new mod collections, add specific mods to them, and retrieve all items within a collection. ### Manage Mod Listings (Creator Tools) If you're a creator, you can edit details of existing mods or delete them entirely using the `edit_mod` and `delete_mod` functions. ## Use Cases ### Curating a Starter Pack Collection A community manager notices that players struggle to find good mods for 'Cyberpunk 2077'. They ask their agent to `get_mods` for the game. After reviewing the results, they use `add_collection` and then call `add_mod` multiple times to build a curated 'Starter Pack' collection, making it easy for new users. ### Tracking a Mod Creator's Success A mod developer wants to know if their latest update worked. They run `get_game_stats` to check the overall game trend, then use `get_mods` to see how many people downloaded their specific mod entry, confirming the success of their changes. ### Reviewing a User's Activity A user wants to know what they forgot about. They ask their agent to pull their profile data using `get_me`. The agent then checks `get_my_subscriptions` and `get_my_purchases` to give them a complete history of everything they own or follow. ### Managing Content Lifecycle A mod creator discovers an outdated asset. They use the agent to pull all files with `get_mod_files`, identify the old one, and then run `delete_mod` to remove it entirely from the platform. ## Benefits - **Never leave the conversation.** You can browse games using `get_games` or find a mod with `get_mods`, all without opening a browser. Your agent pulls the data right into your workspace. - **Full lifecycle control.** Need to organize content? Use `add_collection` and then populate it instantly by calling `add_mod`. It keeps your community efforts structured in one place. - **Track user engagement instantly.** Instead of checking a dashboard, you can pull rating history with `get_my_ratings` or see who is subscribed using `get_my_subscriptions`. This gives immediate insight into community health. - **Handle content updates from scratch.** Mod creators don't need to manually update every field. They just use `edit_mod` and the agent handles the API call, updating the public record. - **Automate user onboarding.** You can check a new user’s activity stream by calling `get_my_wallets` or seeing their purchase history with `get_my_purchases`. This makes compliance checks simple. - **Know what's available.** Get deep stats on any game using `get_game_stats`, which gives you more than just a name—it provides metrics you need to assess the title's current popularity. ## How It Works The bottom line is: your AI client runs these commands against mod.io using your credentials, keeping you in the chat interface while it handles the heavy lifting. 1. 1. Subscribe to this MCP server and provide your mod.io API Key and Access Token. 2. 2. Tell your AI client the task (e.g., 'List all games that need new mods'). 3. 3. The agent executes the necessary tool calls, like `get_games` or `get_mods`, and reports the results back to you. ## Frequently Asked Questions **How do I see all available games using the modio API?** Run the `get_games` tool. This function retrieves a complete list of every title currently hosted on mod.io, giving you IDs and basic names to start your process. **What is the difference between get_mods and get_mod?** `get_mods` lists all mods for an entire game ID. `get_mod` gives detailed information about one specific mod, requiring you to pass that single mod's unique identifier. **Can I add a mod manually using the Modio MCP Server?** Yes, use the `add_mod` tool. This requires an OAuth 2 Access Token and lets you link a specific mod asset to a game within your account. **How do I check if a user bought content?** Use `get_my_purchases`. This tool pulls a list of all mods the authenticated user has paid for, making it easy to track revenue or access rights. **If I use `get_me`, what happens when my OAuth 2 Access Token expires?** Your AI client will receive an HTTP authentication error. You'll need to refresh your token using the platform’s standard OAuth flow before retrying any calls. The server won't process stale credentials. **When I call `subscribe_mod`, what specific actions are taken on my account?** Subscribing links that mod to your personal library and triggers update notifications for you. This ensures the mod shows up correctly when you run `get_my_subscriptions`. **What parameters does the tool `add_collection` require?** It requires defining a unique collection name and linking it to an existing game ID. You must provide these mandatory IDs in the function call; otherwise, the API will fail. **If I use `get_my_wallets`, what kind of financial information can my AI agent access?** The tool returns details about your stored currency and monetization assets. This data helps you track purchasing power or manage paid content within the modio ecosystem. **Can I see the details of a specific mod using its ID?** Yes! Use the `get_mod` tool with the game_id and mod_id. Your agent will return full metadata, descriptions, and stats for that specific mod. **How do I subscribe to a mod through the AI?** Simply use the `subscribe_mod` action with the target game and mod IDs. The agent will handle the authentication and add it to your subscription library. **Is it possible to check game popularity statistics?** Yes, the `get_game_stats` tool provides real-time data on game popularity, mod counts, and download metrics for any game on the platform.