# GAMEMONITORING MCP

MCP (Model Context Protocol) oferă agenților acces la jocuri, servere, starea lor online și numărul de jucători din GAMEMONITORING. Toate instrumentele permit doar citirea. Accesul public este disponibil fără cont sau cheie API.

## Conectează un agent

Pentru configurarea manuală, alege Streamable HTTP și lipește adresa URL. Cursor și VS Code permit instalarea directă. Pentru clienții în linie de comandă poți copia comenzile pregătite.

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

### Exemplu de cerere pentru un agent

```text
Găsește cu GAMEMONITORING cele trei servere Rust cu cei mai mulți jucători online. Afișează adresa și numărul de jucători pentru fiecare server.
```

## Instrumente MCP

Începe cu search_games. Folosește valoarea steam_id returnată ca game_steam_id pentru căutarea, filtrarea și numărarea serverelor. Pentru detalii, folosește ID-ul serverului GAMEMONITORING returnat de search_servers.

### search_games

Caută jocuri după nume, slug sau Steam App ID. Returnează steam_id, numele, slugul și numărul de servere și de jucători.

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

### get_server_filters

Listează hărți, versiuni, țări, limbi, moduri de joc și alte filtre. Trimite game_steam_id pentru un anumit joc sau un obiect gol pentru filtrele comune.

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

### search_servers

Caută servere după joc și filtre. Acceptă sortarea, limit între 1 și 100 și offset. Specifică jocul pentru a restrânge căutarea.

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

### get_server

Returnează detaliile publice și starea curentă pentru un server_id numeric.

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

### get_server_list_metadata

Numără toate serverele care corespund filtrelor, serverele online și jucătorii online folosind aceleași filtre ca la căutarea serverelor.

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

## Formatul datelor

La un apel tools/call reușit, result.structuredContent conține datele. result.content include o reprezentare textuală și un link către cererea REST sursă.

Erorile de protocol apar în câmpul error de la nivelul superior. În cazul unei erori a instrumentului, result.isError este true chiar și cu HTTP 200. Dacă sunt disponibile, detaliile apar în result.structuredContent.error. Dacă expiră timpul de așteptare, restrânge căutarea după joc sau după alte filtre.
