# itch.io MCP MCP > itch.io MCP connects your AI agent directly to your entire indie game library on itch.io. Use this tool to browse all games you own, view specific collections, or check your profile details from a natural conversation. It lets you get organized data about your published work and purchased titles—whether you're a developer managing assets or just a gamer cataloging favorites. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** indie-games, game-library, digital-content, user-collections, game-development ## Description If you deal with indie game content—buying it, making it, curating it—you know the library gets huge. This MCP lets your AI agent talk directly to your itch.io account. You can ask for an overview of all games you own or check out a specific collection you built up. It reads everything from your profile details to the assets contained within any organized grouping. This isn't just another data source; it gives your AI client real control over your game catalog. When connected through Vinkius, your agent can process and organize that information on demand. You can manage multiple pieces of metadata—like listing all games associated with a certain collection ID or getting a full breakdown of your personal profile info—all without ever leaving your chat interface. It’s just hands-free access to what you've built and loved. ## Tools ### get_collection_games io collection by its collection ID. Returns game titles, URLs, cover images, prices and developer info. Get games in a specific itch.io collection ### get_me io user profile including username, display name, profile URL, avatar URL and cover URL. Use this to verify your API key is working. Get your itch.io account info ### get_user_collections io. Returns collection names, IDs, game counts and URLs. Get your itch.io game collections ### get_user_games io account including games you've purchased, collected or developed. Returns game titles, URLs, cover images, prices and developer info. Get games you own or created on itch.io ## Prompt Examples **Prompt:** ``` Show me my itch.io profile info. ``` **Response:** ``` Your itch.io profile: Username: gamer123, Display Name: Cool Gamer, Profile URL: https://gamer123.itch.io ``` **Prompt:** ``` What games do I own on itch.io? ``` **Response:** ``` You own 15 games on itch.io including: Celeste, Hollow Knight, Undertale, Hades, Stardew Valley, and more. Each with cover images and purchase info. ``` **Prompt:** ``` Show me my itch.io collections. ``` **Response:** ``` You have 3 collections: "Favorites" (8 games), "Indie Gems" (12 games), "Game Jam Entries" (5 games). ``` ## Capabilities ### Retrieve user account details Get a clean readout of your itch.io username, display name, and profile URL. ### List all game collections See a list of every collection you've made on the platform, including how many games are in each one. ### View owned or developed games Pull up a comprehensive list of all titles associated with your account, whether you bought them or published them. ### Get specific collection contents Specify a collection ID and get detailed data—titles, cover images, prices—for every game inside it. ## Use Cases ### I need to write a 'Best of' list for my blog. A curator needs to pull all games from their 'Favorites' collection. They ask the agent, and it runs get_collection_games using the specific Collection ID, returning all titles, cover images, and prices instantly. ### I just launched a new game and need to verify my details. The developer uses get_me first. It confirms their username and profile URL are accurate, allowing them to update marketing materials with confidence. ### I can't remember how many games I own or if I bought that one. They ask the agent what they own. The system uses get_user_games, returning a detailed list of every title associated with their account for quick reference. ### I want to see all my curated groupings at once. The user asks to see their collections. The agent calls get_user_collections and returns the name, ID, and game count for every single collection they've made. ## Benefits - Instead of navigating the site, you can use get_user_collections to list all your curated groups in one prompt. It gives you an immediate count of games for every collection. - Need a quick check on who you are? Use get_me. You instantly verify your profile details without needing to copy and paste URLs or visit your account page. - When you need to audit everything, use get_user_games. This tool pulls together all titles—purchased, collected, or published—into one list for review. - If you only care about a specific group, use get_collection_games. Just give it the collection ID and get all the necessary game details (titles, prices, images) immediately. - It’s reliable data access. Because this MCP is hosted on Vinkius, you connect your client once and gain immediate access to these crucial gaming metadata tools. ## How It Works The bottom line is that it translates complex backend game metadata into simple text responses for your client. 1. You subscribe to this MCP using your itch.io API Key. 2. Your AI agent accesses the defined tools and runs queries against your account data. 3. The tool sends back structured information, giving you a full list of games, collections, or profile details. ## Frequently Asked Questions **How do I list my itch.io profile info using get_me?** You ask your agent to get your account details. It runs get_me and sends back key identifiers like your username, display name, and profile URL. **What is the difference between get_user_games and get_collection_games?** get_user_games lists everything on your whole account. get_collection_games only shows games inside a specific collection you reference by ID. **Can I see all my game collections with get_user_collections?** Yes, that’s exactly what it does. It returns a full list of your collections and gives you the current count for each one. **Do I need to know my API key to use get_user_games?** Absolutely. The MCP requires an API Key to authenticate your request, ensuring that all data retrieved via get_user_games belongs only to you. **What specific ID format do I need when calling get_collection_games?** You must use the unique collection identifier found in your profile data. The tool requires this explicit ID, not just the readable name of the collection. **If my API key is wrong or revoked, how will I know when using get_me?** The MCP will return an error code and a message indicating authentication failure. Your agent should check the response body for details on why the credentials were rejected. **Can I combine results from get_user_games with data from get_collection_games?** The MCP executes these tools separately; you can't query them together. You must run both tools first, then use your AI client to write the logic that compares and synthesizes the two sets of game data. **Does get_user_games list all games I own, or is there a limit on the results?** The tool retrieves your current ownership status. If you have many titles, the response might be paginated; your agent will handle requesting subsequent pages if they exist. **How do I get an itch.io API key?** Log in to [**itch.io**](https://itch.io), go to **User Settings > API Keys** and click **Create API Key**. Give it a name and copy the key immediately. **What games can I access?** You can access games you own (purchased or claimed as free), games you've developed, and games in your collections.