# Gameye

> Gameye is an MCP server for cloud and infrastructure. Start, inspect and stop multiplayer game server sessions on Gameye from your editor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** CLI, API, self-hosted
- **Website:** https://gameye.com
- **Repository:** https://github.com/gameye/gameye-mcp
- **MCP Registry name:** io.github.Gameye/gameye-mcp
- **Categories:** cloud and infrastructure, games and play
- **Listing updated:** 2026-11-14

## About

This beta server (0.x, and it says so to every client) wraps the Gameye orchestration API so an agent can launch and inspect game server sessions, check image tags and regions, and fetch logs and artifacts. Gameye runs dedicated servers on bare metal and cloud through one REST API, with no SDK inside the game server binary.

It works before you have an account. Without `GAMEYE_API_TOKEN` it still offers offline tools: the bundled Gameye skills, a template lookup and a Dockerfile checker. Every other tool returns a `Token required:` message with the setup steps and the narrowest token scopes. With a token, `GAMEYE_ENV` picks the host: sandbox is the default for self-serve customers, and production is for enterprise. The environment belongs to the server process, so an agent cannot switch to production mid-conversation.

Gameye's own pricing page lists on-demand capacity at $0.07 per vCPU per hour and reserved at $0.035, with bandwidth included, plus a self-serve trial of 120 minutes of server time. It needs Node.js 22 or newer.

## Features

- **Session control:** Launch, inspect and stop game server sessions from chat.
- **Offline mode:** Skills, templates and a Dockerfile check work without a token.
- **Logs and artifacts:** Fetch session logs and artifacts without leaving the editor.
- **Sandbox by default:** Production cannot be selected by an agent during a conversation.
- **Scoped tokens:** Each tool documents the narrowest token scopes it needs.
- **Bundled skills:** Ships Gameye skills the agent can read for each game engine.

## Good for

- Spin up a test match server from your editor
- Read logs from a failing session
- Check a Dockerfile before deploying a game server
- Look up available image tags and regions
- Stop sessions left running after a playtest

## Install

### Claude Code (Terminal)

```sh
claude mcp add gameye-mcp --env GAMEYE_API_TOKEN='<GAMEYE_API_TOKEN>' -- npx -y gameye-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gameye-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gameye-mcp"
      ],
      "env": {
        "GAMEYE_API_TOKEN": "<GAMEYE_API_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gameye-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gameye-mcp"
      ],
      "env": {
        "GAMEYE_API_TOKEN": "<GAMEYE_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gameye-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gameye-mcp"
      ],
      "env": {
        "GAMEYE_API_TOKEN": "<GAMEYE_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gameye-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gameye-mcp"
      ],
      "env": {
        "GAMEYE_API_TOKEN": "<GAMEYE_API_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gameye-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gameye-mcp"
      ],
      "env": {
        "GAMEYE_API_TOKEN": "<GAMEYE_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `gameye_context`: Reports the server's state, environment and token status.
- `gameye_list_skills`: Lists the Gameye skills bundled with the server.
- `gameye_get_skill`: Returns one bundled Gameye skill.
- `gameye_get_template`: Returns a bundled template.
- `gameye_check_dockerfile`: Checks a Dockerfile for use with Gameye.
- `gameye_update_skills`: Fetches updated skills from GitHub.

## FAQ

### Do I need a Gameye account?

Not to start. Without a token the offline tools still work; the account tools return setup steps.

### Can an agent reach production by mistake?

No. The environment is fixed per server process and no tool takes an environment argument.

### What does Gameye capacity cost?

The pricing page lists $0.07 per vCPU hour on demand and $0.035 reserved, bandwidth included.

### Is the MCP server stable?

It is labelled beta, so tools, inputs and outputs may change between releases.

### Is Gameye free?

Gameye is a paid product with a free trial.

### How do I add Gameye to Claude Code?

Run this command in your terminal: claude mcp add gameye-mcp --env GAMEYE_API_TOKEN='<GAMEYE_API_TOKEN>' -- npx -y gameye-mcp

### What are the best alternatives to Gameye?

The closest alternatives to Gameye are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Agent Yurt.

## Alternatives

- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [Haze City](https://ai-powered.com/mcp/haze-city): Haze City is an open-source MCP server for games and play.
- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [Vector Alienspace](https://ai-powered.com/mcp/vector-alienspace): Vector Alienspace is a free MCP server for knowledge and memory.
- [Vector Defence](https://ai-powered.com/mcp/vector-defence): Vector Defence is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/gameye
