# GAMEMONITORING MCP

MCP (Model Context Protocol) gibt Agenten Zugriff auf Spiele, Server, Online-Status und Spielerzahlen von GAMEMONITORING. Alle Werkzeuge bieten Lesezugriff. Der öffentliche Zugang ist ohne Konto oder API-Schlüssel möglich.

## Agent verbinden

Wähle bei manueller Einrichtung Streamable HTTP und füge die URL ein. Für Cursor und VS Code gibt es eine direkte Installation. Für Kommandozeilen-Clients stehen Befehle zum Kopieren bereit.

```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"
    }
  }
}
```

### Beispielanfrage an einen Agenten

```text
Finde mit GAMEMONITORING die drei Rust-Server mit den meisten Spielern online. Zeige für jeden Server die Adresse und die Spielerzahl.
```

## MCP-Werkzeuge

Beginne mit search_games. Verwende die zurückgegebene steam_id als game_steam_id, um Server zu suchen, zu filtern oder zu zählen. Für Serverdetails verwende die GAMEMONITORING-Server-ID aus search_servers.

### search_games

Sucht Spiele nach Name, Slug oder Steam App ID. Liefert steam_id, Name, Slug sowie Server- und Spielerzahlen.

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

### get_server_filters

Listet Karten, Versionen, Länder, Sprachen, Spielmodi und andere Filter auf. Übergib game_steam_id für ein bestimmtes Spiel oder ein leeres Objekt für allgemeine Filter.

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

### search_servers

Sucht Server nach Spiel und Filtern. Unterstützt Sortierung, limit von 1 bis 100 und offset. Gib das Spiel an, um die Suche einzugrenzen.

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

### get_server

Liefert öffentliche Details und den aktuellen Status zur numerischen server_id.

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

### get_server_list_metadata

Zählt alle passenden Server, Online-Server und Spieler online mit denselben Filtern wie die Serversuche.

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

## Datenformat

Bei erfolgreichem tools/call enthält result.structuredContent die Daten. result.content enthält eine Textdarstellung und einen Link zur zugrunde liegenden REST-Anfrage.

Protokollfehler stehen im Feld error auf oberster Ebene. Bei einem Werkzeugfehler ist result.isError auch bei HTTP 200 gleich true. Falls vorhanden, stehen Details in result.structuredContent.error. Grenze die Suche bei einer Zeitüberschreitung nach Spiel oder anderen Filtern ein.
