# esportsodds.gg (pypi · esportsodds)

CS2 match data for AI assistants: matches, maps, vetoes, rounds, player stats, teams, rankings.

- Trust score: 65/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- pypi · `esportsodds`: 65/100 (this document), [markdown](https://verifymcp.io/servers/esportsodds-esportsodds/esportsodds.md), [page](https://verifymcp.io/servers/esportsodds-esportsodds/esportsodds)

## Channel facts

- Registry: `pypi`
- Package: `esportsodds`
- Version: `0.4.5`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 50/100
  - Malware scan not yet available for this package.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - No production dependencies, so there is no dependency health to assess.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to esportsodds/esportsodds-python).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 2 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 70/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 3055 tokens (~127/item across 24 items; 24 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 94/100
  - 92% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 24 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 25 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the esportsodds.gg MCP server?

esportsodds.gg runs locally as a PyPI package, launched with uvx esportsodds. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add esportsodds-esportsodds -- uvx esportsodds
```

### Cursor

```json
{
  "mcpServers": {
    "esportsodds-esportsodds": {
      "command": "uvx",
      "args": [
        "esportsodds"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "esportsodds-esportsodds": {
      "command": "uvx",
      "args": [
        "esportsodds"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add esportsodds-esportsodds -- uvx esportsodds
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "esportsodds-esportsodds": {
      "type": "local",
      "command": [
        "uvx",
        "esportsodds"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add esportsodds-esportsodds --command uvx --arg esportsodds
```

### Hermes

```yaml
mcp_servers:
  esportsodds-esportsodds:
    command: "uvx"
    args: ["esportsodds"]
```

### Netclaw

```json
{
  "McpServers": {
    "esportsodds-esportsodds": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "esportsodds"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add esportsodds-esportsodds -t stdio -c uvx -a esportsodds
```

### Other

```json
{
  "mcpServers": {
    "esportsodds-esportsodds": {
      "command": "uvx",
      "args": [
        "esportsodds"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 65, −15)

- [security regression] Malware scan: pass → unverified

### 2026-11-03 (score 80, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-02 (score 65)

First indexed and scored.

## MCP tools (24)

### `matches_list` (~356 tokens)

List matches

One page of matches, newest fixture first. That order starts a list of scheduled matches with the fixture furthest away. For the next matches to be played, pass `status="scheduled", sort="scheduled_at"`. Returns 20 rows unless you set `limit`; when `next_cursor` is not null, pass it as `cursor` for the next page.

Input parameters:

- `changed_since` (string): Only matches whose `changed_at` is at or after this instant; the change feed (prefer `iter_changes`, which also handles the overlap).
- `cursor` (string): `next_cursor` from the previous page; omit for the first.
- `date_from` (string): Scheduled on or after this day (UTC, inclusive).
- `date_to` (string): Scheduled on or before this day (UTC, inclusive of the whole day).
- `has` (string): Only matches that carry all of these sub-resources, for example `["rounds", "depth"]`. Several values: comma-separated.
- `limit` (integer): Page size (default 100, maximum 500).
- `sort` (string): `-scheduled_at` (default, newest first), `scheduled_at` (oldest first, which for scheduled matches is soonest first), `changed_at` or `-changed_at`. A cursor is tied to the sort it came from.
- `status` (string): `scheduled`, `live`, `completed` or `cancelled`. With `scheduled`, also pass `sort="scheduled_at"` to get the next fixtures, not the furthest away.
- `team` (string): Only this team's matches (id).
- `tournament` (string): Only this tournament's matches (id).

### `matches_get` (~154 tokens)

Get a match

One match. The `data_available` flags say which sub-resources exist for it. Pass `include` to get the ones you need back in this same request.

Input parameters:

- `include` (string): Embed related resources: `teams` (adds `team_a`/`team_b`), `tournament` and `odds` (the latest line per outcome), or the match's own `maps`, `stats`, `vetoes`, `rounds`, `depth`, `lineups`, `streams`…
- `match` (string, required): The match's id, which is always a UUID.

### `matches_maps` (~60 tokens)

Match map scores

Per-map scores for one match. Also in the match itself: get the match with `include="maps"` to save this request.

Input parameters:

- `match` (string, required): The match id (a UUID). Matches have no slug: find one with `matches_list`.

### `matches_stats` (~61 tokens)

Match player stats

Per-player performance stats for one match. Also in the match itself: get the match with `include="stats"` to save this request.

Input parameters:

- `match` (string, required): The match id (a UUID). Matches have no slug: find one with `matches_list`.

### `matches_vetoes` (~70 tokens)

Match vetoes

The map veto (pick and ban) sequence for one match. Also in the match itself: get the match with `include="vetoes"` to save this request.

Input parameters:

- `match` (string, required): The match id (a UUID). Matches have no slug: find one with `matches_list`.

### `matches_rounds` (~64 tokens)

Match rounds

Round-by-round team stats for one match. Also in the match itself: get the match with `include="rounds"` to save this request.

Input parameters:

- `match` (string, required): The match id (a UUID). Matches have no slug: find one with `matches_list`.

### `matches_lineups` (~87 tokens)

Match lineups

Pre-match roster snapshots. A snapshot is a listed roster (substitutes included), not a confirmed starting five; the players who played are in `stats`. Also in the match itself: get the match with `include="lineups"` to save this request.

Input parameters:

- `match` (string, required): The match id (a UUID). Matches have no slug: find one with `matches_list`.

### `odds_list` (~231 tokens)

Market line

Odds lines, newest first. With `match` this is that match's line history, paginated by `cursor`. Without it (or with `match` and `latest=True`) it is a snapshot: the latest line per market and outcome, in a single page capped at `limit`, whose `next_cursor` is always null. Returns 20 rows unless you set `limit`; when `next_cursor` is not null, pass it as `cursor` for the next page.

Input parameters:

- `cursor` (string): `next_cursor` from the previous page (match history only).
- `latest` (boolean): With `match`, return the current board instead of the tick history.
- `limit` (integer): Page size (default 200, maximum 1000).
- `market` (string): With `match`, only this market type (for example `match_winner`).
- `match` (string): One match's id.
- `source` (string): `eo_market` or `eo_model`. `eo_model` rows are absent until the model line is released. Omit for both.

### `teams_list` (~196 tokens)

List teams

One page of teams, by name. Returns 20 rows unless you set `limit`; when `next_cursor` is not null, pass it as `cursor` for the next page.

Input parameters:

- `cursor` (string): `next_cursor` from the previous page.
- `limit` (integer): Page size (default 100, maximum 500).
- `q` (string): Search by name, 2 to 100 characters, case-insensitive: matches a team's name, short name, slug or alternate name.
- `region` (string): One circuit region, by full name: `Europe`, `North America`, `South America`, `Asia`, `CIS`, `Oceania` or `Africa`.
- `slug` (string): Exact slug match (returns the one team, or an empty page).
- `sort` (string): `name` (default) or `slug`; prefix `-` to reverse.

### `teams_get` (~80 tokens)

Get a team

One team.

Input parameters:

- `include` (string): `rank` fills `own_rank`, the team's position on the 3-month leaderboard. Several values: comma-separated.
- `rank` (boolean): The same as `include="rank"`. Off by default because it costs the API an extra query.
- `team` (string, required): The team's id or slug.

### `teams_h2h` (~48 tokens)

Head to head

The completed-match record between two teams.

Input parameters:

- `opponent` (string, required): The other team (id or slug). Required.
- `team` (string, required): The first team (id or slug).

### `teams_form` (~54 tokens)

Team form

A team's recent completed results, newest first (default 10, maximum 50).

Input parameters:

- `limit` (integer): How many rows to return.
- `team` (string, required): The team's id (a UUID) or its slug.

### `teams_maps` (~178 tokens)

Team map record

A team's win and loss record per map, best win rate first. With no arguments this covers the team's whole history, including maps that have left the pool. The arguments narrow it to what is current.

Input parameters:

- `active` (boolean): Only the maps in today's Active Duty pool.
- `era` (string): `cs2` keeps Counter-Strike 2 matches only; `all` (the default) keeps every one.
- `include` (string): `detail` adds each map's last-played date, pool membership and the team's round record by side and in pistol rounds. Several values: comma-separated.
- `team` (string, required): The team's id or slug.
- `window` (string): A trailing span such as `"6m"` (whole months, up to `"60m"`) or `"all"` (the default).

### `teams_results` (~83 tokens)

Team results

A team's completed, decided matches, newest first, with every played map's score and both teams' ratings going into the match (default 20, maximum 100).

Input parameters:

- `limit` (integer): How many results to return.
- `opponent` (string): Only the matches against this team (id or slug).
- `team` (string, required): The team's id or slug.

### `teams_players` (~122 tokens)

Team players

The players in a team's newest completed match with stats, usually five. Each comes with their own figures over the last 12 months (the same as `players.performance`), whether they have a player page, and when their current run with the team began. `as_of` is that match's date; a team with no such match returns `as_of: null` and no players. A figure from fewer than 10 recorded maps is null. Players are identified by nickname, country and role only.

Input parameters:

- `team` (string, required): The team's id or slug.

### `tournaments_list` (~212 tokens)

List tournaments

One page of tournaments. Returns 20 rows unless you set `limit`; when `next_cursor` is not null, pass it as `cursor` for the next page.

Input parameters:

- `cursor` (string): `next_cursor` from the previous page.
- `event_type` (string): `lan` or `online`.
- `limit` (integer): Page size (default 100, maximum 500).
- `q` (string): Search by name, 2 to 100 characters, case-insensitive: matches a tournament's name or slug.
- `region` (string): One circuit region, by full name (for example `Europe`).
- `slug` (string): Exact slug match.
- `status` (string): `upcoming`, `ongoing`, `finished` or `cancelled`.
- `tier` (string): One prestige tier, `S` (highest) down to `C`.
- `year` (integer): Tournaments starting in this calendar year (2000 to 2100).

### `tournaments_get` (~33 tokens)

Get a tournament

One tournament (id or slug).

Input parameters:

- `tournament` (string, required): The tournament's id (a UUID) or its slug.

### `tournaments_teams` (~36 tokens)

Tournament teams

The teams that took part in a tournament.

Input parameters:

- `tournament` (string, required): The tournament's id (a UUID) or its slug.

### `players_list` (~230 tokens)

List players

One page of players, by nickname. Returns 20 rows unless you set `limit`; when `next_cursor` is not null, pass it as `cursor` for the next page.

Input parameters:

- `cursor` (string): `next_cursor` from the previous page.
- `ids` (string): Look up specific players: up to 500 ids, as a list or comma-separated string. Several values: comma-separated.
- `limit` (integer): Page size (default 100, maximum 500).
- `q` (string): Search by nickname, 2 to 100 characters, case-insensitive: matches a player's nickname or slug.
- `role` (string): One in-game role: `AWP`, `IGL`, `Lurker`, `Rifler` or `Support` (exact, case-sensitive; only some players have one on file).
- `slug` (string): Exact slug match.
- `sort` (string): `nickname` (default) or `slug`; prefix `-` to reverse.
- `team` (string): Only this team's roster (id).

### `players_get` (~80 tokens)

Get a player

One player.

Input parameters:

- `include` (string): `rank` fills `own_rank`, the player's position on the 3-month leaderboard. Several values: comma-separated.
- `player` (string, required): The player's id or slug.
- `rank` (boolean): The same as `include="rank"`. Off by default because it costs the API an extra query.

### `players_career` (~44 tokens)

Player career stats

A player's all-time career totals and averages (averages are null with no rated maps).

Input parameters:

- `player` (string, required): The player's id (a UUID) or its slug.

### `players_matches` (~95 tokens)

Player matches

A player's recent completed matches, newest first, with the team they played for, the opponent, the series score from their side, the tournament and their own kills, deaths and ADR. Walkovers and matches before Counter-Strike 2 are left out. Not paginated.

Input parameters:

- `limit` (integer): How many matches to return (default 10, maximum 25).
- `player` (string, required): The player's id or slug.

### `rankings_list` (~217 tokens)

Rankings

A leaderboard. Not paginated: `limit` truncates the board and `next_cursor` is always null.

Input parameters:

- `delta_days` (integer): Days back that a team's `rank_delta` is measured against, 1 to 90 (default 7).
- `include` (string): `trend` adds, to each team row, the board value at each of the last twelve weekly marks, oldest first. Several values: comma-separated.
- `limit` (integer): Rows to return (default 100, maximum 500).
- `region` (string): One circuit region, by full name.
- `role` (string): One player role (with `type="player"`).
- `sort` (string): `rank` (default), `value` or `name`; prefix `-` to reverse. Re-sorting reorders the rows but never changes their `rank`.
- `type` (string): `team` (default) or `player`. They rank on different metrics, named in each row's `metric`.

### `maps_list` (~113 tokens)

Map figures

Each competitive map's league-wide figures: maps played, average rounds, rounds played and won on each side, and the bans and picks recorded in vetoes. Most played first. Read a map's bans and picks against its own `veto_matches`.

Input parameters:

- `era` (string): `cs2` or `all` (the default).
- `window` (string): A trailing span of whole months from `"1m"` to `"12m"` (default `"6m"`); there is no `"all"`.

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/esportsodds-esportsodds/esportsodds#diagnostics

## Score history

- 2026-11-05: 65
- 2026-11-04: 80
- 2026-11-03: 80
- 2026-11-02: 65

## Common questions

### What is the esportsodds.gg MCP server?

esportsodds.gg is an MCP server listed in the public MCP registry as io.github.esportsodds/esportsodds. CS2 match data for AI assistants: matches, maps, vetoes, rounds, player stats, teams, rankings. This page covers its PyPI package (esportsodds).

### Is the esportsodds.gg MCP server safe to use?

esportsodds.gg scores 65 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the esportsodds.gg MCP server expose?

esportsodds.gg exposes 24 tools: matches_list, matches_get, matches_maps, matches_stats, matches_vetoes, and 19 more. Their descriptions and schemas cost roughly 2,904 tokens of context every time the server is loaded.

### Is the esportsodds.gg MCP server still maintained?

esportsodds.gg is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the esportsodds.gg MCP server under?

esportsodds.gg declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- PyPI project: https://pypi.org/project/esportsodds/
- Socket report: https://socket.dev/pypi/package/esportsodds
- Repository: https://github.com/esportsodds/esportsodds-python
- Changelog RSS feed: https://verifymcp.io/servers/esportsodds-esportsodds/esportsodds.xml
- Changelog JSON feed: https://verifymcp.io/servers/esportsodds-esportsodds/esportsodds.json
- HTML version of this page: https://verifymcp.io/servers/esportsodds-esportsodds/esportsodds