How to Use the Mod.io MCP in Claude Code

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

Run claude mcp add --transport http modio-mcp -- in your terminal. Claude Code saves this to your local MCP configuration, allowing you to query Mod.io tools instantly from the command line.

Q: How does Claude Code handle Mod.io pagination?

When calling tools like getmods or getcollections, Claude Code automatically handles pagination flags. It pipes the complete list directly to your terminal without cutting off the data.

Q: Can I manage my mod collections from the terminal?

Yes, you can use getcollections to view lists and addcollection to create new ones. Claude Code lets you script these actions to organize game files without a GUI.

Q: Does the Mod.io MCP Server protect my profile data?

The MCP Server retrieves your profile details using getme and ratings using getmyratings over an encrypted SSE connection. Vinkius processes these payloads in memory within an ephemeral sandbox, ensuring your private user data never touches disk.

Pipe Mod.io data directly into your terminal scripts and CI/CD pipelines 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 Mod.io MCP to Claude Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Script headless Mod.io deployments with Claude Code

The `get_mods` tool dumps all Mod.io listings for a target game directly to your Claude Code stdout. Claude Code runs this Mod.io query inside your terminal, filters the JSON payload, and pipes the output to other CLI tools like jq. This allows you to build headless Mod.io validation scripts using Claude Code. You can trigger a build, package the assets, and push them to Mod.io using `add_mod` from a single Claude Code prompt.

Automate CI/CD mod verification

The `get_mod_files` tool retrieves all uploaded files for Claude Code to inspect. Claude Code calls this Mod.io tool in your deployment pipeline to verify that the latest build has successfully propagated to the CDN. If the build is corrupt, Claude Code triggers `delete_mod` or `edit_mod` on Mod.io to roll back the release. Claude Code acts as a CLI-driven release manager for your game's Mod.io content.

Query game statistics from the shell

The `get_game_stats` tool fetches real-time Mod.io player and mod download metrics. Claude Code executes this Mod.io tool to generate quick reports or trigger alerts when download volumes spike. You don't need to open a web browser to monitor your Mod.io game health. Run a single Claude Code command, get the stats, and pipe them into your terminal dashboard or logging system.

Setup guide

Set up Mod.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 modio-mcp with a green status indicator.
3

Start using tools

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

Terminal

claude mcp add --transport http modio-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 Mod.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": {
    "modio-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 Mod.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 Mod.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 Mod.io MCP in Claude Code

Run `claude mcp add --transport http modio-mcp -- ` in your terminal. Claude Code saves this to your local MCP configuration, allowing you to query Mod.io tools instantly from the command line.

Yes, Claude Code is built for headless execution. You can run it in SSH sessions or cron jobs to automate Mod.io tasks like checking subscriptions with get_my_subscriptions.

When calling tools like get_mods or get_collections, Claude Code automatically handles pagination flags. It pipes the complete list directly to your terminal without cutting off the data.

Yes, you can use get_collections to view lists and add_collection to create new ones. Claude Code lets you script these actions to organize game files without a GUI.

The MCP Server retrieves your profile details using get_me and ratings using get_my_ratings over an encrypted SSE connection. Vinkius processes these payloads in memory within an ephemeral sandbox, ensuring your private user data never touches disk.

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