How to Use the itch.io MCP in Claude Code

Q: How do I add the itch.io MCP Server to Claude Code?

Run the command claude mcp add --transport http itchio-mcp -- in your terminal. This adds the server to your local configuration file instantly.

Pipe your itch.io profile, games, and collections directly into your terminal workflows using Claude Code.

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 Claude Code

Create your Vinkius account to connect itch.io to Claude Code 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query your itch.io profile from the command line

The `get_me` tool fetches your itch.io username, display name, and avatar URL directly inside your terminal session. Claude Code runs this query to verify your API token is active and valid before running more complex scripts. This headless MCP Server tool is perfect for quick status checks in Claude Code. You can run a single terminal command to confirm your developer credentials are correct without opening a browser or logging into the itch.io dashboard.

Extract itch.io game metadata for terminal pipelines

The `get_user_games` tool outputs raw JSON containing your owned, collected, and developed itch.io games. Claude Code can parse this output and pipe the game titles, prices, and developer URLs directly into your shell scripts. This makes it simple to automate itch.io library backups or build custom command-line search tools in Claude Code. It processes the structured data instantly, letting you filter your itch.io library with standard terminal utilities.

List your itch.io collections via Claude Code

The `get_user_collections` tool retrieves your itch.io collection names, game counts, and unique IDs. Claude Code uses this information to help you locate specific lists and pass their IDs to other terminal commands. Once you have the ID, Claude Code can trigger `get_collection_games` to dump the contents of that itch.io list. It is an efficient way to audit your curated bundles or developer assets without leaving your keyboard.

Setup guide

Set up itch.io MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see itchio-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest itch.io transactions." It will automatically discover and invoke the available itch.io tools.

Terminal

claude mcp add --transport http itchio-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "itchio-mcp": {
      "type": "url",
      "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 Claude Code

Run the command `claude mcp add --transport http itchio-mcp -- ` in your terminal. This adds the server to your local configuration file instantly.

Yes, this MCP Server works perfectly in headless environments. Claude Code can execute commands in GitHub Actions or Docker containers to fetch your itch.io game lists automatically.

No, Claude Code queries the live Vinkius endpoint every time you invoke a tool. This guarantees you always get the latest game and collection data from your itch.io account.

The data returns as structured JSON containing game titles, URLs, cover images, and pricing. This clean format makes it easy to parse and pipe into other command-line tools.

Your itch.io profile, collection, and game data are processed strictly through local environment configurations. Vinkius manages the secure connection, ensuring your credentials are never exposed to public logs or external third parties.

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