# GAMEMONITORING MCP

MCP (Model Context Protocol) gives agents access to GAMEMONITORING games, servers, online status, and player counts. All tools are read-only. Public access requires no account or API key.

## Connect an agent

For manual setup, select Streamable HTTP and paste the URL. Cursor and VS Code offer direct installation. Command-line clients have ready-to-copy commands.

```text
https://api.gamemonitoring.net/mcp
```

### Codex

```bash
codex mcp add gamemonitoring --url 'https://api.gamemonitoring.net/mcp'
```

### Claude Code

```bash
claude mcp add --scope user --transport http gamemonitoring 'https://api.gamemonitoring.net/mcp'
```

### Gemini CLI

```bash
gemini mcp add --scope user --transport http gamemonitoring 'https://api.gamemonitoring.net/mcp'
```

### MCP JSON

```json
{
  "mcpServers": {
    "gamemonitoring": {
      "url": "https://api.gamemonitoring.net/mcp"
    }
  }
}
```

### Example prompt for an agent

```text
Use GAMEMONITORING to find the three Rust servers with the most players online. Show each server address and player count.
```

## MCP tools

Start with search_games. Pass the returned steam_id as game_steam_id to search, filter, or count servers. To get server details, use the GAMEMONITORING server ID returned by search_servers.

### search_games

Finds games by name, slug, or Steam App ID. Returns steam_id, name, slug, and server and player counts.

```json
{
  "name": "Rust",
  "limit": 1
}
```

### get_server_filters

Lists maps, versions, countries, languages, game modes, and other filters. Pass game_steam_id for a specific game or an empty object for shared filters.

```json
{
  "game_steam_id": 252490
}
```

### search_servers

Finds servers by game and filters. Supports sorting, limit from 1 to 100, and offset. Include the game to narrow the search.

```json
{
  "game_steam_id": 252490,
  "status": "online",
  "sort": "numplayers",
  "limit": 3
}
```

### get_server

Returns public details and current status for a numeric server_id.

```json
{
  "server_id": 1
}
```

### get_server_list_metadata

Counts all matching servers, online servers, and online players using the same filters as server search.

```json
{
  "game_steam_id": 252490,
  "status": "online"
}
```

## Data format

On a successful tools/call, result.structuredContent contains the data. result.content includes a text representation and a link to the underlying REST request.

Protocol errors appear in the top-level error field. On a tool error, result.isError is true, even with HTTP 200. Look for details in result.structuredContent.error when available. If a search times out, narrow it by game or other filters.
