How to Use the itch.io MCP in Windsurf

Q: Can Windsurf update my itch.io game pages?

No, this integration only reads data. The getusergames tool lets Windsurf view your itch.io projects and purchases, but it cannot edit your actual game files or store listings.

Q: Can I filter games by price using this server?

Yes. The getusergames and getcollectiongames tools return prices along with titles and cover images, allowing your agent to sort and filter the lists based on cost.

Let Cascade navigate your itch.io library and game collections autonomously while you stay in your Windsurf flow.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect itch.io MCP to Windsurf

Create your Vinkius account to connect itch.io to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup itch.io with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit your itch.io library with Cascade

The `get_user_games` tool pulls your entire itch.io library directly into your IDE. Cascade uses this data to map out what games you own, what you've developed, and what's on your radar without you needing to click back and forth to a browser. Cascade doesn't just list them; it chains actions. You can tell it to find a specific local project folder that matches one of your itch.io uploads, and it will locate the files and prepare a workspace update on its own.

Organize itch.io collections via Windsurf

The `get_user_collections` tool fetches all your custom itch.io lists and their unique IDs. Cascade reads this structure to understand how you categorize your playtests, references, or game jam entries. Once Cascade knows your collection IDs, it can run `get_collection_games` to inspect all titles in a specific list. This lets you build local reference indexes or update documentation inside Windsurf based on your actual itch.io curation.

Secure your itch.io MCP Server connection

The `get_me` tool returns your itch.io profile details to verify your API connection is active. Cascade runs this check first to ensure your credentials are valid before trying to read your private developer or gamer data. This MCP Server integration runs inside a secure Vinkius sandbox, keeping your itch.io developer keys safe. Windsurf handles the connection, so you never have to hardcode keys into your workspace files.

Setup guide

Set up itch.io MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the itch.io MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my itch.io payment history." If connected, Cascade will call the itch.io tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "itchio-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by itch.io. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect itch.io now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about itch.io MCP in Windsurf

Open your Windsurf settings, go to Cascade, and add the server configuration under the MCP Servers UI. You can also paste the Vinkius endpoint directly into your local configuration file.

No, this integration only reads data. The `get_user_games` tool lets Windsurf view your itch.io projects and purchases, but it cannot edit your actual game files or store listings.

No, you only need one itch.io API key. Once configured in Windsurf, Cascade can access all four tools, including your collections and profile data, without prompting you again.

Yes. The `get_user_games` and `get_collection_games` tools return prices along with titles and cover images, allowing your agent to sort and filter the lists based on cost.

Yes, your itch.io profile, collection, and game data are completely isolated. Vinkius runs the connector in a secure sandbox, meaning your credential token is never exposed to external networks or written to your local workspace logs.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript