# GAMEMONITORING MCP

MCP (Model Context Protocol) daje agentom dostęp do gier, serwerów, ich statusu i liczby graczy w GAMEMONITORING. Wszystkie narzędzia służą do odczytu. Publiczny dostęp działa bez konta i klucza API.

## Połącz agenta

Przy ręcznej konfiguracji wybierz Streamable HTTP i wklej adres URL. Cursor i VS Code umożliwiają bezpośrednią instalację. Dla klientów wiersza poleceń są gotowe komendy do skopiowania.

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

### Przykładowe polecenie dla agenta

```text
Znajdź w GAMEMONITORING trzy serwery Rust z największą liczbą graczy online. Pokaż adres i liczbę graczy na każdym serwerze.
```

## Narzędzia MCP

Zacznij od search_games. Użyj zwróconego steam_id jako game_steam_id do wyszukiwania, filtrowania i liczenia serwerów. Szczegóły serwera pobierzesz według jego identyfikatora GAMEMONITORING zwróconego przez search_servers.

### search_games

Wyszukuje gry według nazwy, slugu lub Steam App ID. Zwraca steam_id, nazwę, slug oraz liczbę serwerów i graczy.

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

### get_server_filters

Zwraca mapy, wersje, kraje, języki, tryby gry i inne filtry. Podaj game_steam_id konkretnej gry lub pusty obiekt, aby pobrać wspólne filtry.

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

### search_servers

Wyszukuje serwery według gry i filtrów. Obsługuje sortowanie, limit od 1 do 100 i offset. Podaj grę, aby zawęzić wyszukiwanie.

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

### get_server

Zwraca publiczne szczegóły i bieżący status dla liczbowego server_id.

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

### get_server_list_metadata

Zlicza wszystkie pasujące serwery, serwery online i graczy online przy tych samych filtrach co wyszukiwanie serwerów.

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

## Format danych

W poprawnej odpowiedzi tools/call pole result.structuredContent zawiera dane. result.content zawiera postać tekstową i odnośnik do źródłowego żądania REST.

Błędy protokołu pojawiają się w polu error najwyższego poziomu. Gdy narzędzie zwróci błąd, result.isError ma wartość true nawet przy HTTP 200. Szczegóły znajdziesz w result.structuredContent.error, jeśli są dostępne. Po przekroczeniu limitu czasu zawęź wyszukiwanie według gry lub innych filtrów.
