steam-games-mcp 0.17.1 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -6,6 +6,80 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.18.0] - 2026-11-20
10
+
11
+ ### Changed
12
+
13
+ - **Breaking:** refuse a `language`, `review_language` or `STEAM_LANGUAGE` that isn't one of Steam's 31 language names (any case), such as `ru`. ([d043f14](https://github.com/Grinv/steam-games-mcp/commit/d043f14), [3380fe5](https://github.com/Grinv/steam-games-mcp/commit/3380fe5))
14
+ - **Breaking:** refuse a SteamID64 that can't name an account (accountid 0, past the 32-bit range), as `steamid` or as `STEAM_ID` at startup. ([ca88d61](https://github.com/Grinv/steam-games-mcp/commit/ca88d61), [ca4d441](https://github.com/Grinv/steam-games-mcp/commit/ca4d441), [80d047f](https://github.com/Grinv/steam-games-mcp/commit/80d047f))
15
+ - **Breaking:** `get_game_achievements` errors, not zero achievements, for an appid Steam rejects (normally no such app); a DLC stays `total: 0`. ([ca88d61](https://github.com/Grinv/steam-games-mcp/commit/ca88d61), [5293ecc](https://github.com/Grinv/steam-games-mcp/commit/5293ecc))
16
+ - **Breaking:** report a `get_prices` row Steam failed to price as `available: null` (see `notes`), not `false`, which now only means an unsold appid. ([bb7ac0d](https://github.com/Grinv/steam-games-mcp/commit/bb7ac0d))
17
+ - **Breaking:** report an online `state` Steam doesn't show (a non-public or unreadable profile) as `null` instead of `offline`. ([c7caaca](https://github.com/Grinv/steam-games-mcp/commit/c7caaca))
18
+ - **Breaking:** report a profile's `visibility` as `null` when Steam doesn't send it. ([009dda0](https://github.com/Grinv/steam-games-mcp/commit/009dda0))
19
+ - **Breaking:** rename `find_friends_who_own`'s `private_friends` (and `_total`) to `not_shown_friends`, as Steam doesn't say why a library is hidden. ([3380fe5](https://github.com/Grinv/steam-games-mcp/commit/3380fe5))
20
+ - Report a rejected `STEAM_API_KEY` as its own "retrying won't help" error on every key-gated tool, library tools included. ([11ca193](https://github.com/Grinv/steam-games-mcp/commit/11ca193), [749f94f](https://github.com/Grinv/steam-games-mcp/commit/749f94f))
21
+ - Stop suggesting the API key is invalid on a 401/403 that isn't Steam's rejected-key answer. ([ef9b00f](https://github.com/Grinv/steam-games-mcp/commit/ef9b00f), [e526a32](https://github.com/Grinv/steam-games-mcp/commit/e526a32))
22
+ - Install ~0.6 MB instead of ~14.5 MB with `npx`: the bundled zod and MCP SDK are no longer downloaded. ([93f162a](https://github.com/Grinv/steam-games-mcp/commit/93f162a))
23
+ - Stop a cancelled tool call's Steam requests, except cached ones, which finish into the cache for the next call. ([c6e4b06](https://github.com/Grinv/steam-games-mcp/commit/c6e4b06))
24
+ - Keep a Steam failure's own cause in a tool error: a rate-limited or failed tag dictionary now says so and whether to retry. ([9576069](https://github.com/Grinv/steam-games-mcp/commit/9576069))
25
+ - Report a server bug as "Internal error in steam-games-mcp", its stack logged, not as raw exception text or "upstream unavailable". ([9576069](https://github.com/Grinv/steam-games-mcp/commit/9576069))
26
+ - Leave candidates without a review score out of `get_recommended_games`, where they used to count as neutral. ([f7acad0](https://github.com/Grinv/steam-games-mcp/commit/f7acad0))
27
+ - Drop the made-up "(404)" from not-found errors the server words itself, e.g. "No Steam app with id …". ([9576069](https://github.com/Grinv/steam-games-mcp/commit/9576069))
28
+ - Word the `found: false` reasons of `resolve_vanity_url` and `get_player_achievements` ourselves, not with Steam's text (e.g. "No match"). ([dfe55c4](https://github.com/Grinv/steam-games-mcp/commit/dfe55c4))
29
+
30
+ ### Added
31
+
32
+ - Say in a result's `notes` which part of an answer is missing, or comes from an older cached copy, because Steam failed. ([0110867](https://github.com/Grinv/steam-games-mcp/commit/0110867))
33
+ - Attach every tool error to its result as an RFC 9457 problem in `_meta["io.github.Grinv/problem"]`, documented in [docs/errors.md](docs/errors.md). ([9576069](https://github.com/Grinv/steam-games-mcp/commit/9576069))
34
+ - Flag a result served from stale cache after a Steam failure with `_meta["io.github.Grinv/stale"]`. ([9576069](https://github.com/Grinv/steam-games-mcp/commit/9576069))
35
+
36
+ ### Fixed
37
+
38
+ - Report a `get_items` row Steam doesn't show in the country (e.g. Red Dead Redemption 2 under RU) as `available: false`, not `true` with no price. ([c7caaca](https://github.com/Grinv/steam-games-mcp/commit/c7caaca), [adbb341](https://github.com/Grinv/steam-games-mcp/commit/adbb341))
39
+ - Report a `get_items` row Steam's answer doesn't settle as `available: null`, with a note. ([009dda0](https://github.com/Grinv/steam-games-mcp/commit/009dda0), [adbb341](https://github.com/Grinv/steam-games-mcp/commit/adbb341), [2058d97](https://github.com/Grinv/steam-games-mcp/commit/2058d97))
40
+ - Resolve `get_game`'s `name` to the exactly matching title (ignoring case, punctuation, accents), not Steam's most popular: "portal" gave Portal 2. ([74ae13c](https://github.com/Grinv/steam-games-mcp/commit/74ae13c), [48c3322](https://github.com/Grinv/steam-games-mcp/commit/48c3322))
41
+ - Match tag names and `get_game`'s `name` the way each language writes capitals: `BAĞIMSIZ` now finds Bağımsız, `FUSSBALL` Fußball. ([265b8c4](https://github.com/Grinv/steam-games-mcp/commit/265b8c4), [6f4e8d7](https://github.com/Grinv/steam-games-mcp/commit/6f4e8d7), [c1b9180](https://github.com/Grinv/steam-games-mcp/commit/c1b9180))
42
+ - Refuse a `tags` or `exclude_tags` name missing from Steam's tag dictionary for the call's language, naming it, not answering "nothing matched". ([3387f7b](https://github.com/Grinv/steam-games-mcp/commit/3387f7b), [74a63f8](https://github.com/Grinv/steam-games-mcp/commit/74a63f8), [3380fe5](https://github.com/Grinv/steam-games-mcp/commit/3380fe5))
43
+ - Match a tag name that two Steam tags share (e.g. French "combat") as either tag in `discover_games` and `get_recommended_games`, not just one. ([34d22ea](https://github.com/Grinv/steam-games-mcp/commit/34d22ea))
44
+ - Refuse a tag name that two Steam tags share in `get_wishlist`, whose filter can only require every tag, and say why. ([34d22ea](https://github.com/Grinv/steam-games-mcp/commit/34d22ea))
45
+ - Score `get_recommended_games` by tag, not by tag name: a game no longer matches a player's taste for another tag sharing its name. ([f94d2ab](https://github.com/Grinv/steam-games-mcp/commit/f94d2ab))
46
+ - List a tag name once on a card when two of a game's tags share it. ([6418eb1](https://github.com/Grinv/steam-games-mcp/commit/6418eb1))
47
+ - Refuse an appid past 32 bits before calling Steam, which wraps it: `4294967916` came back as Portal 2 (620). ([67b321d](https://github.com/Grinv/steam-games-mcp/commit/67b321d))
48
+ - Report a game with no reviews as an unknown review % (`review_percent: null`) instead of 0%. ([188bf46](https://github.com/Grinv/steam-games-mcp/commit/188bf46), [a141672](https://github.com/Grinv/steam-games-mcp/commit/a141672))
49
+ - Read a blank achievement percent as unknown, not 0%. ([80d047f](https://github.com/Grinv/steam-games-mcp/commit/80d047f))
50
+ - Name in `get_wishlist`'s `note` the entries Steam doesn't show in the requested `country`, instead of silently leaving them out of the detailed list. ([1b6928c](https://github.com/Grinv/steam-games-mcp/commit/1b6928c), [265b8c4](https://github.com/Grinv/steam-games-mcp/commit/265b8c4))
51
+ - Stop calling a profile private when Steam only declined to show data: `get_player_achievements` said so for a public player who doesn't own the game. ([c36efc1](https://github.com/Grinv/steam-games-mcp/commit/c36efc1))
52
+ - Say in a `found: false` reason what Steam didn't return and which tool establishes why (`get_player_summary`, `get_owned_games`' `check_appids`). ([c36efc1](https://github.com/Grinv/steam-games-mcp/commit/c36efc1))
53
+ - Decide availability, visibility and a `get_prices` price per row, so one odd item (e.g. appid 4294967295) costs only its own row. ([009dda0](https://github.com/Grinv/steam-games-mcp/commit/009dda0), [38169ad](https://github.com/Grinv/steam-games-mcp/commit/38169ad))
54
+ - Never read a field or row Steam left out as a verdict ("no such app", "doesn't own", "no games"): it's an unusable answer or a noted gap. ([80d047f](https://github.com/Grinv/steam-games-mcp/commit/80d047f), [38169ad](https://github.com/Grinv/steam-games-mcp/commit/38169ad), [7f4fff3](https://github.com/Grinv/steam-games-mcp/commit/7f4fff3), [5f85703](https://github.com/Grinv/steam-games-mcp/commit/5f85703), [2806e4c](https://github.com/Grinv/steam-games-mcp/commit/2806e4c), [ec3b3aa](https://github.com/Grinv/steam-games-mcp/commit/ec3b3aa), [c1b9180](https://github.com/Grinv/steam-games-mcp/commit/c1b9180), [e526a32](https://github.com/Grinv/steam-games-mcp/commit/e526a32), [f69d3d3](https://github.com/Grinv/steam-games-mcp/commit/f69d3d3), [adbb341](https://github.com/Grinv/steam-games-mcp/commit/adbb341), [064ffe6](https://github.com/Grinv/steam-games-mcp/commit/064ffe6), [c953981](https://github.com/Grinv/steam-games-mcp/commit/c953981))
55
+ - Report an empty, non-object or unreadable Steam answer as a retryable error or a noted gap, not an internal error or "no achievements". ([8509ab2](https://github.com/Grinv/steam-games-mcp/commit/8509ab2), [f35ed43](https://github.com/Grinv/steam-games-mcp/commit/f35ed43), [11ca193](https://github.com/Grinv/steam-games-mcp/commit/11ca193))
56
+ - Report a gateway's HTML error page with a Steam answer's status as an error, not as "not shown" or an empty result. ([7f09a88](https://github.com/Grinv/steam-games-mcp/commit/7f09a88))
57
+ - Report an unexpected HTTP 400 from a player endpoint as an invalid request, not as "no such account" or an empty result. ([749f94f](https://github.com/Grinv/steam-games-mcp/commit/749f94f), [ca88d61](https://github.com/Grinv/steam-games-mcp/commit/ca88d61))
58
+ - Keep `get_game` and `get_prices` answering, with a noted gap, when Steam's price-correction payload is unusable, instead of failing the call. ([f35ed43](https://github.com/Grinv/steam-games-mcp/commit/f35ed43), [ef9b00f](https://github.com/Grinv/steam-games-mcp/commit/ef9b00f), [3380fe5](https://github.com/Grinv/steam-games-mcp/commit/3380fe5), [ec3b3aa](https://github.com/Grinv/steam-games-mcp/commit/ec3b3aa))
59
+ - Report a rejected key or a server bug in `get_player_achievements`' fallback schema lookup as such, not as "no achievement data for this appid". ([48f1324](https://github.com/Grinv/steam-games-mcp/commit/48f1324))
60
+ - Take `ResolveVanityURL`'s "No match" as final for a vanity `STEAM_ID`, instead of also asking the community profile, whose outage then replaced it. ([d754344](https://github.com/Grinv/steam-games-mcp/commit/d754344))
61
+ - Report a failed vanity `STEAM_ID` lookup (an odd `ResolveVanityURL` result or community page) as Steam's failure, not "no such profile". ([d754344](https://github.com/Grinv/steam-games-mcp/commit/d754344), [74a63f8](https://github.com/Grinv/steam-games-mcp/commit/74a63f8), [34d22ea](https://github.com/Grinv/steam-games-mcp/commit/34d22ea))
62
+ - Serve a stale cached copy only for a Steam failure, never in place of a definitive answer such as a delisted game. ([99b8fe8](https://github.com/Grinv/steam-games-mcp/commit/99b8fe8), [e526a32](https://github.com/Grinv/steam-games-mcp/commit/e526a32))
63
+ - Answer from cache within one request timeout while Steam is down, instead of after every retry (up to ~45 s per call). ([99b8fe8](https://github.com/Grinv/steam-games-mcp/commit/99b8fe8))
64
+ - Stop a clock stepped back (NTP, a restored VM) from stalling store requests, or keeping cached data fresh, for as long as the step. ([8985435](https://github.com/Grinv/steam-games-mcp/commit/8985435))
65
+ - Log upstream failures the server answers around and bugs in prompt completions, which left no trace. ([9576069](https://github.com/Grinv/steam-games-mcp/commit/9576069), [11ca193](https://github.com/Grinv/steam-games-mcp/commit/11ca193))
66
+
67
+ ## [0.17.2] - 2026-11-05
68
+
69
+ ### Fixed
70
+
71
+ - Fix `get_game` and `get_prices` showing an upgrade SKU's price when the best purchase option is a bundle (Yakuza Kiwami: $1.99, not $19.99). ([e3baf80](https://github.com/Grinv/steam-games-mcp/commit/e3baf80))
72
+ - Fix `get_wishlist` listing unranked entries first, which pushed a large wishlist's top-ranked games past the cap. ([7fac52b](https://github.com/Grinv/steam-games-mcp/commit/7fac52b))
73
+ - Fix `discover_games` and `get_recommended_games` with `min_discount: 100` searching only one popularity page instead of the whole catalog. ([44bdd42](https://github.com/Grinv/steam-games-mcp/commit/44bdd42))
74
+ - Name a nonexistent account, not only a private profile, as the cause of a player tool's `found:false`. ([2ef6245](https://github.com/Grinv/steam-games-mcp/commit/2ef6245), [913e075](https://github.com/Grinv/steam-games-mcp/commit/913e075))
75
+ - Name a game removed from the store as a cause in `get_game`'s not-found error. ([4a75395](https://github.com/Grinv/steam-games-mcp/commit/4a75395))
76
+ - Keep `tags` filters working through a Steam outage in a long-running session, from the cached tag list. ([548f35c](https://github.com/Grinv/steam-games-mcp/commit/548f35c))
77
+
78
+ ### Changed
79
+
80
+ - Change `compare_players` to return a tool error on an upstream failure (429/5xx, bad key), instead of `found:false`. ([978e797](https://github.com/Grinv/steam-games-mcp/commit/978e797))
81
+ - Document that `get_wishlist`'s detailed `total` counts games removed from the store, which never appear as cards. ([b35b245](https://github.com/Grinv/steam-games-mcp/commit/b35b245))
82
+
9
83
  ## [0.17.1] - 2026-11-04
10
84
 
11
85
  ### Fixed
package/PRIVACY.md CHANGED
@@ -48,7 +48,8 @@ carrying only what that specific call needs:
48
48
  (see Storage and retention below).
49
49
  - **Steam Community** (`steamcommunity.com`), only when the server config's
50
50
  `STEAM_ID` is a vanity name rather than a SteamID64: its public profile
51
- page (`/id/<name>/?xml=1`) is read once to resolve that name without a key.
51
+ page (`/id/<name>/?xml=1`) is read to resolve that name without a key, or
52
+ when Steam's own lookup with the key fails.
52
53
  Carries the vanity name only, never the API key.
53
54
 
54
55
  All three hosts are operated by Valve Corporation and governed by
@@ -63,22 +64,26 @@ its maintainer.
63
64
  `compare_players`, `get_recommended_games`) only return data for a Steam
64
65
  profile whose relevant visibility setting (profile / game details / friends
65
66
  list) is set to **Public**. This is enforced by Steam itself, not by this
66
- server. A private profile makes the tool report a clear "private" reason
67
- instead of the requested data; it never bypasses Steam's own privacy
67
+ server. A private profile makes the tool report that Steam returned no data,
68
+ and which tool shows why, instead of the requested data; it never bypasses Steam's own privacy
68
69
  settings.
69
70
 
70
71
  ## Storage and retention
71
72
 
72
73
  - **Caching**: successful API responses are cached in the server process's
73
- own memory only (never written to disk), for a short configurable TTL
74
- (`CACHE_TTL_MS`, default 5 minutes) to cut latency and avoid hammering the
75
- Storefront/Web APIs. Not every endpoint is cached (e.g. reviews, the
74
+ own memory only (never written to disk), as raw Steam responses keyed by
75
+ endpoint and request URL, fresh for a short configurable TTL (`CACHE_TTL_MS`, default 5
76
+ minutes) to cut latency and avoid hammering the Storefront/Web APIs. An
77
+ expired copy is kept until evicted (bounded to ~32 MB per Steam host the
78
+ server caches for — two today, the Web API and the store — oldest first),
79
+ possibly for the process's lifetime, and used only
80
+ to answer a call while Steam is failing, flagged in the result. Not every endpoint is cached (e.g. reviews, the
76
81
  `get_prices` batch and `get_current_players`' count are always fetched
77
82
  fresh, while `get_charts`' rankings, live chart included, can be up to one
78
83
  TTL old); player-specific data is never cached, with two exceptions:
79
- `get_player_summary`'s numeric Steam level is cached for up to
80
- `CACHE_TTL_MS`, keyed by SteamID, since it's non-sensitive and rarely
81
- changes; and a vanity-name `STEAM_ID` from the server config is remembered
84
+ `get_player_summary`'s numeric Steam level is cached, keyed by SteamID
85
+ (fresh for `CACHE_TTL_MS`, then kept as an expired copy like any other
86
+ entry), since it's non-sensitive and rarely changes; and a vanity-name `STEAM_ID` from the server config is remembered
82
87
  as its resolved SteamID64 until the process exits. The cache is cleared entirely when
83
88
  the process exits and is never shared across machines or users.
84
89
  - **Logging**: operational logs go to stderr only (never a file, never a
@@ -88,15 +93,15 @@ settings.
88
93
  plain query parameter on the wire. Log verbosity is controlled by
89
94
  `LOG_LEVEL` (default `info`); logs live only as long as your MCP client
90
95
  keeps that stderr stream around.
91
- - Beyond the cache TTL (and, for the resolved `STEAM_ID` above, the running
92
- process's lifetime), `steam-games-mcp` retains nothing. There is no persistent storage layer of any kind.
96
+ - Beyond the in-memory cache above (and, for the resolved `STEAM_ID`, the
97
+ running process's lifetime), `steam-games-mcp` retains nothing. There is no persistent storage layer of any kind.
93
98
 
94
99
  ## Changes to this policy
95
100
 
96
101
  Material changes will be noted in [CHANGELOG.md](CHANGELOG.md) and reflected
97
102
  here, at the same URL, with the effective date below updated.
98
103
 
99
- _Last updated: 2026-10-20._
104
+ _Last updated: 2026-11-20._
100
105
 
101
106
  ## Contact
102
107
 
package/README.md CHANGED
@@ -76,7 +76,7 @@ credentials**; player tools need a free Steam Web API key.
76
76
  "STEAM_API_KEY": "your-steam-web-api-key (optional — enables player tools)",
77
77
  "STEAM_ID": "your-steamid64-or-vanity-name (optional — default 'you' for player tools)",
78
78
  "STEAM_COUNTRY": "US (optional — store price region)",
79
- "STEAM_LANGUAGE": "english (optional — store language)"
79
+ "STEAM_LANGUAGE": "english (optional — store language, Steam's own name, e.g. russian)"
80
80
  }
81
81
  }
82
82
  }
@@ -172,6 +172,11 @@ default to you, so "my wishlist / library" works without passing an ID each time
172
172
  > (keyless) store APIs. SteamDB is not used (no public API + scraping disallowed).
173
173
  > Steam has no price-history API, so that isn't offered. Not affiliated with Valve.
174
174
 
175
+ A failed call returns `isError` with an actionable message for the model; a
176
+ client application also gets the failure as an RFC 9457 problem in the result's
177
+ `_meta` — see
178
+ [docs/errors.md](https://github.com/Grinv/steam-games-mcp/blob/main/docs/errors.md).
179
+
175
180
  ## Prompts
176
181
 
177
182
  Guided one-shot prompts that orchestrate several tools for a common question.