steam-games-mcp 0.7.0 → 0.8.1

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,372 +6,165 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
- ## [0.7.0] - 2026-07-16
9
+ ## [0.8.1] - 2026-07-18
10
10
 
11
11
  ### Changed
12
12
 
13
- - Runtime floor raised to Node ≥ 20 (was ≥ 18).
13
+ - Sharpen `search_games`, `get_prices`, `get_items` and `get_global_achievements`'s descriptions — cross-reference `get_items`/`get_prices` for the right batch size vs richness tradeoff, and disclose concrete parameter/return-shape facts instead of restating the schema ([d75122a](https://github.com/Grinv/steam-games-mcp/commit/d75122a), [db8c25e](https://github.com/Grinv/steam-games-mcp/commit/db8c25e), [72781e9](https://github.com/Grinv/steam-games-mcp/commit/72781e9)).
14
+
15
+ ## [0.8.0] - 2026-07-18
14
16
 
15
17
  ### Added
16
18
 
17
- - `steam_machine` compat field/filter — `get_items`, `discover_games` and
18
- `get_wishlist` now distinguish Steam Machine support from general `steam_os`.
19
- - `get_followed_games` tool — a player's Steam store follows list (keyless).
20
- - `get_player_bans` tool — VAC/game/community/economy ban status.
21
- - `get_player_summary` now also returns Steam level.
19
+ - Add `compare_players` — shared games between two players' full libraries, with each one's playtime ([a36baa9](https://github.com/Grinv/steam-games-mcp/commit/a36baa9)).
20
+ - Add guided prompts (`what_should_i_play`, `is_it_worth_buying`, `deals_digest`) that orchestrate existing tools for common questions ([a36baa9](https://github.com/Grinv/steam-games-mcp/commit/a36baa9)).
22
21
 
23
22
  ### Fixed
24
23
 
25
- - `get_followed_games` no longer errors out if just the count lookup fails.
26
- - `build-tests.mjs` clears `dist-tests/` before rebuilding, so deleted/renamed
27
- test files can't leave stale compiled copies behind.
28
- - Fixed a `RateLimiter` edge case that could misfire under a clock near the
29
- epoch.
24
+ - Fix the fatal-startup error message showing the generic template name instead of `steam-games-mcp` ([1becccf](https://github.com/Grinv/steam-games-mcp/commit/1becccf)).
25
+
26
+ ## [0.7.0] - 2026-07-16
27
+
28
+ ### Changed
29
+
30
+ - Raise runtime floor to Node ≥ 20 (was ≥ 18) ([58d978c](https://github.com/Grinv/steam-games-mcp/commit/58d978c)).
30
31
 
31
- ### Internal
32
+ ### Added
33
+
34
+ - Add a `steam_machine` compat field/filter (separate from `steam_os`) to `get_items`, `discover_games` and `get_wishlist` ([58d978c](https://github.com/Grinv/steam-games-mcp/commit/58d978c)).
35
+ - Add `get_followed_games` — a player's Steam store follows list, keyless ([58d978c](https://github.com/Grinv/steam-games-mcp/commit/58d978c)).
36
+ - Add `get_player_bans` — VAC/game/community/economy ban status ([58d978c](https://github.com/Grinv/steam-games-mcp/commit/58d978c)).
37
+ - Expose Steam level in `get_player_summary`'s response ([58d978c](https://github.com/Grinv/steam-games-mcp/commit/58d978c)).
38
+
39
+ ### Fixed
32
40
 
33
- - Split the grown `clients/web.ts` / `tools/web.ts` into smaller per-concern
34
- files.
35
- - Split `steam.test.ts` into per-domain test files with shared fixtures.
36
- - Tests now use `t.mock` / `t.after` (Node 20's stable `node:test` APIs)
37
- instead of manual restore/`finally` boilerplate.
38
- - Integration tests are grouped into `describe()` blocks per tool.
41
+ - Fix `get_followed_games` erroring out when just the count lookup fails ([58d978c](https://github.com/Grinv/steam-games-mcp/commit/58d978c)).
42
+ - Prevent a `RateLimiter` edge case that could misfire under a clock near the epoch ([58d978c](https://github.com/Grinv/steam-games-mcp/commit/58d978c)).
39
43
 
40
44
  ## [0.6.0] - 2026-07-12
41
45
 
42
46
  ### Added
43
47
 
44
- - `get_friend_list` tool — a player's Steam friends (name, online state, current
45
- game, friends-since), enriched via `GetPlayerSummaries`. Requires `STEAM_API_KEY`
46
- and a public friends list.
47
- - `find_friends_who_own` tool — which of a player's friends own given appid(s)
48
- and how many hours they've played, checked against each friend's FULL
49
- owned-games list (unlike `get_owned_games` / `get_friend_list`, never capped
50
- to the top 50 by playtime). Friends with a private library are reported
51
- separately, not counted as non-owners.
48
+ - Add `get_friend_list` — a player's Steam friends (status, current game, friends-since) ([2d21075](https://github.com/Grinv/steam-games-mcp/commit/2d21075)).
49
+ - Add `find_friends_who_own` — which friends own given appid(s) and their playtime, checked against each friend's full library ([2d21075](https://github.com/Grinv/steam-games-mcp/commit/2d21075)).
52
50
 
53
51
  ### Fixed
54
52
 
55
- - `get_wishlist` (`include_details`): Steam's `GetWishlistSortedFiltered` only
56
- attaches store data to roughly the first 100 entries of a wishlist, no matter
57
- what pagination params are sent (verified live) — on a bigger wishlist,
58
- filters were silently only checking that prefix while the tool description
59
- claimed the whole wishlist was covered. The response now reports `enriched`
60
- (how many entries actually got store data) alongside `total`, with a `note`
61
- explaining the gap when Steam truncates it.
53
+ - Fix `get_wishlist`'s `include_details` silently missing entries past ~100 on big wishlists — the response now reports `enriched` alongside `total` ([2d21075](https://github.com/Grinv/steam-games-mcp/commit/2d21075)).
62
54
 
63
55
  ## [0.5.0] - 2026-07-09
64
56
 
65
- Richer store cards and catalog/wishlist discovery for the SteamOS / Steam Machine
66
- era: three hardware-compatibility ratings, native-platform and user-tag filters,
67
- a one-call enriched wishlist, discount expiry and clickable store links — all
68
- keyless. Plus a substantial DRY/KISS refactor of the store-service layer.
57
+ Richer store cards and catalog/wishlist discovery for the SteamOS / Steam Machine era.
69
58
 
70
59
  ### Added
71
60
 
72
- - **SteamOS and Steam Frame compatibility.** Valve's store API now returns two
73
- compatibility ratings alongside `steam_deck_compat_category`:
74
- `steam_os_compat_category` (SteamOS in general — any SteamOS device, including
75
- the new Steam Machine, not just it) and `steam_frame_compat_category` (the Steam
76
- Frame VR headset). `get_items` and `discover_games` now surface both as
77
- `steam_os` / `steam_frame` (same `verified`/`playable`/`unsupported`/`unknown`
78
- scale as `steam_deck`), and `discover_games` gains matching `steam_os` /
79
- `steam_frame` filters. So "games that run on the Steam Machine / SteamOS" and
80
- "Frame-Verified VR games" are now answerable.
81
- - **Popular user tags.** `get_items` and `discover_games` now surface each game's
82
- top user tags (e.g. `Roguelike`, `Souls-like`, `Deckbuilding`) as readable
83
- names — resolved keyless from Steam's tag dictionary
84
- (`IStoreService/GetTagList`, cached per language). `discover_games` also gains a
85
- `tags` filter (AND, case-insensitive), so "roguelike deckbuilders on sale" is a
86
- single call. Like the other `discover_games` filters it runs over the
87
- popularity-first scan window (Steam's catalog API silently ignores tag filters),
88
- so raise `count` when combining niche tags.
89
- - **Native-platform (`platform`) filter + `platforms` field.** Store cards
90
- (`get_items`, `discover_games`, `get_wishlist` detailed) now list each game's
91
- native OS builds as `platforms` (`windows`/`mac`/`linux`), and `discover_games` /
92
- `get_wishlist` gain a `platform` filter to keep only games with a native build
93
- for that OS. Note: `linux` means a native Linux/SteamOS build — distinct from
94
- `steam_os` (SteamOS Proton compatibility), which is a separate filter.
95
- - **Enriched, filterable wishlist in one call.** `get_wishlist` gains
96
- `include_details` — full store cards per item (name, price/discount, review %,
97
- Deck/SteamOS/Frame compat, tags, release) via
98
- `IWishlistService/GetWishlistSortedFiltered`, so "my wishlist with prices" no
99
- longer needs a follow-up `get_items`. Narrow it in the same call with `tags`,
100
- `platform` (native build), `steam_deck` / `steam_os` / `steam_frame` (Proton
101
- compatibility), `min_review` and `min_discount` / `on_sale_only` (e.g. "top
102
- metroidvanias on my wishlist, on sale, well-reviewed, that run on SteamOS") —
103
- filters run over the whole wishlist before the output cap, and `matched` reports
104
- the pre-cap count. The default (no flags) still returns the light appid list.
105
- - **`discount_end` — when a deal expires.** Store cards (`get_items`,
106
- `discover_games`, `get_wishlist` detailed) now include `discount_end` (ISO 8601
107
- UTC) for discounted games, so "how long is this discount valid?" is answerable
108
- and "deals ending soon" is sortable. Sourced from the store service's
109
- `active_discounts`; the Storefront-backed `get_game` / `get_prices` don't carry
110
- it.
111
- - **Clickable `store_url` on every card.** `get_items`, `discover_games` and
112
- `get_wishlist` (both light and detailed) now include a `store_url` linking
113
- straight to each game's Steam store page — so results are one click away from the
114
- page (the storefront tools already carried it; the store-service tools didn't).
61
+ - Add `steam_os`/`steam_frame` compatibility ratings to `get_items`/`discover_games`, with matching filters ([a01a3db](https://github.com/Grinv/steam-games-mcp/commit/a01a3db)).
62
+ - Add popular user tags to `get_items`/`discover_games` cards, with a matching `tags` filter ([a01a3db](https://github.com/Grinv/steam-games-mcp/commit/a01a3db)).
63
+ - Add a `platforms` field (native Windows/Mac/Linux) to store cards, with a matching `platform` filter ([a01a3db](https://github.com/Grinv/steam-games-mcp/commit/a01a3db)).
64
+ - Add `get_wishlist`'s `include_details` — full store cards, filterable by tags, platform, compat rating, review and discount ([a01a3db](https://github.com/Grinv/steam-games-mcp/commit/a01a3db)).
65
+ - Add `discount_end` (ISO 8601 UTC) to discounted store cards ([a01a3db](https://github.com/Grinv/steam-games-mcp/commit/a01a3db)).
66
+ - Add `store_url` (Steam store page link) to `get_items`/`discover_games`/`get_wishlist` cards ([a01a3db](https://github.com/Grinv/steam-games-mcp/commit/a01a3db)).
67
+
68
+ ### Changed
69
+
70
+ - Dedupe concurrent cache fetches for the same key, avoiding redundant upstream requests on a cold cache ([a01a3db](https://github.com/Grinv/steam-games-mcp/commit/a01a3db)).
115
71
 
116
72
  ### Fixed
117
73
 
118
- - **A failed tag lookup no longer masquerades as "no games matched."** If
119
- Steam's tag dictionary (`IStoreService/GetTagList`) is temporarily
120
- unavailable, `discover_games` and `get_wishlist`'s `tags` filter used to
121
- silently return zero results (an empty dictionary made every tag comparison
122
- fail) with no indication anything was wrong. Both now return a clear,
123
- actionable error instead when a `tags` filter can't be reliably applied;
124
- tag _display_ (no filter requested) still degrades gracefully to an empty
125
- `tags` list, unaffected.
126
- - **`get_wishlist`'s `country`/`language` no longer silently no-op.** Passing
127
- either without any other filter used to fall through to the light,
128
- appid-only response, which carries no price and therefore ignored both
129
- parameters. Setting `country` or `language` now switches to the detailed
130
- (store-card) view, same as any other filter.
131
- - **`check:api` now also verifies `IWishlistService/GetWishlistSortedFiltered`**,
132
- the endpoint backing `get_wishlist`'s `include_details`/filters — previously
133
- the only new store service from this release without a live release-gate check.
134
-
135
- ### Internal
136
-
137
- - **Refactored the grown store-service layer (DRY/KISS), no behaviour change.**
138
- Split the 660-line `format/web.ts` into `format/web.ts` (official Web API / player
139
- data) and `format/store.ts` (keyless store services); extracted a shared
140
- `baseCard` so `get_items` and `discover_games`/wishlist cards stop duplicating ~10
141
- fields (and `get_items` now also carries the native `platforms` list);
142
- centralised the tool param schemas + `reply()` wrapper in `tools/common.ts`
143
- (killing duplicate `READ_ONLY`/`appid`/`country`/`language`/compat defs across the
144
- two registration files); folded the repeated client `data_request` block into one
145
- helper; and unified the client-side filtering (compat / native platform / tags /
146
- review / discount / recency) that `discover_games` and the wishlist detailed view
147
- both apply into a single `storeItemFilter` predicate. A second pass over the
148
- storefront layer: shared `formattedPrice` / `storeUrl` helpers (dropped a stray
149
- inline URL), a `#search` helper behind `searchGames`/`resolveAppId`, and — since
150
- `getFeatured` and `getSpecials` hit the same endpoint — caching the raw
151
- `featuredcategories` payload once so the two share a single upstream call per
152
- region. A follow-up pass extracted `priceFields` so `get_items`'s nested price
153
- block and the other cards' flat one share one `discount_pct`/`discount_end`/
154
- original-price-fallback derivation instead of two hand-written copies.
155
- - **`TtlCache` now shares one in-flight fetch across concurrent callers of the
156
- same key**, instead of each starting its own. This mattered in practice once
157
- `get_items`/`discover_games`/`get_wishlist` all began fetching the same
158
- `tags:${language}` tag-dictionary cache key: two of those tools called at once
159
- on a cold cache used to trigger two redundant `GetTagList` requests against the
160
- keyless, rate-limited endpoint; now the second call reuses the first's promise.
161
- - **Expanded test coverage** to ~94% lines (112 tests): direct unit tests for the
162
- store card builders and `discountEnd`, the shared `storeItemFilter` (one case per
163
- filter dimension), the new cache in-flight dedup, sparse-/malformed-payload
164
- fallbacks in the storefront and Web API formatters, and regressions for the
165
- `tags`-filter/`country`-`language` fixes above. Added `check:api` guards for
166
- the compat + tag fields and the `GetTagList` dictionary (see also the
167
- `GetWishlistSortedFiltered` guard under Fixed).
168
- - Added an **e2e smoke test** that drives the real built bundle the way a client
169
- does — a spawned `node dist/index.js` over stdio, run from a dir with no
170
- node_modules — asserting it handshakes, registers all tools, and gates player
171
- tools. Covers the integration boundary that the recent 0.4.4–0.4.6 bugs hid in
172
- (in-memory unit tests never ran the actual artifact).
173
- - Fixed that e2e smoke test failing on **Node 18**: the sandbox ran the ESM
174
- bundle as a bare `index.js` with no `package.json`, so Node < 20.19 (no ESM
175
- syntax auto-detection) parsed it as CommonJS and the child died with "Cannot
176
- use import statement outside a module". The sandbox now ships a
177
- `{"type":"module"}` package.json, mirroring the real npm/.mcpb artifact.
178
-
179
- ### Dependencies
180
-
181
- - Dev-dependency bumps: `@types/node` 26.1.1, `prettier` 3.9.4,
182
- `typescript-eslint` 8.63.0. (TypeScript 7 deferred — `typescript-eslint` isn't
183
- compatible with it yet.)
74
+ - Return a clear error, instead of silently zero results, when the `tags` filter can't reach Steam's tag dictionary ([a01a3db](https://github.com/Grinv/steam-games-mcp/commit/a01a3db)).
75
+ - Stop `get_wishlist`'s `country`/`language` from silently no-oping without another filter — it now always switches to the detailed view ([a01a3db](https://github.com/Grinv/steam-games-mcp/commit/a01a3db)).
184
76
 
185
77
  ## [0.4.6] - 2026-06-30
186
78
 
187
79
  ### Fixed
188
80
 
189
- - **Unfilled `.mcpb` optional fields leaked as literal `${user_config.x}`.** When
190
- an optional field (Steam ID, API key) is left blank in the Claude Desktop
191
- install form, `.mcpb` passes the **unsubstituted placeholder string** (not "")
192
- as the env var. A non-empty placeholder was taken as a real value: an unset key
193
- became `STEAM_API_KEY="${user_config.steam_api_key}"`, so `web.configured` went
194
- true and the server sent garbage to Steam → **403**; an unset `STEAM_ID` became
195
- a bogus default player. `loadConfig` now treats `${...}` placeholders as unset
196
- (like empty strings). Adds `config.test.ts`.
81
+ - Prevent unfilled optional `.mcpb` fields from leaking as the literal `${user_config.x}` string instead of empty, which caused 403s ([f9d0318](https://github.com/Grinv/steam-games-mcp/commit/f9d0318)).
197
82
 
198
83
  ## [0.4.5] - 2026-06-30
199
84
 
200
85
  ### Fixed
201
86
 
202
- - **`.mcpb` bundle was not self-contained.** Despite `bundle: true`, tsup leaves
203
- `dependencies` external, so `dist/index.js` still imported `@modelcontextprotocol/sdk`
204
- and `zod` at runtime — but the `.mcpb` ships no `node_modules`, so the server
205
- crashed standalone with `ERR_MODULE_NOT_FOUND` (masked only where the client
206
- installs deps for us). Added `noExternal` to inline all runtime deps; a new
207
- `bundle.test.ts` guards that the build stays self-contained.
87
+ - Prevent the `.mcpb` bundle from crashing standalone (`ERR_MODULE_NOT_FOUND`) by inlining runtime deps instead of leaving them external ([c24a072](https://github.com/Grinv/steam-games-mcp/commit/c24a072)).
208
88
 
209
89
  ### Changed
210
90
 
211
- - Build is now **minified** with **no sourcemap** → `dist/index.js` ~1.1 MB → ~620 KB,
212
- leaner npm tarball and `.mcpb`. (We log `err.message`, not raw stacks, so
213
- diagnostics are unaffected.)
91
+ - Minify the build with no sourcemap, shrinking `dist/index.js` from ~1.1 MB to ~620 KB ([c24a072](https://github.com/Grinv/steam-games-mcp/commit/c24a072)).
214
92
 
215
93
  ## [0.4.4] - 2026-06-30
216
94
 
217
95
  ### Fixed
218
96
 
219
- - **Server disconnected immediately in strict clients (e.g. Claude Desktop).** The
220
- MCP logging sink (added in 0.4.0) mirrored the startup "ready" line to the client
221
- as a `notifications/message` right after `connect()` — i.e. **before** the
222
- `initialize` handshake completed, violating the MCP lifecycle, so strict clients
223
- dropped the connection. Client log mirroring now activates only after
224
- `initialized`; pre-init logs go to stderr only. Regression test added.
225
-
226
- ### Changed
227
-
228
- - README: direct one-click `.mcpb` download link + Claude Desktop / MCP Registry
229
- install notes.
97
+ - Stop strict MCP clients (e.g. Claude Desktop) from disconnecting immediately — log mirroring now starts only after `initialized` ([0194f04](https://github.com/Grinv/steam-games-mcp/commit/0194f04)).
230
98
 
231
99
  ## [0.4.3] - 2026-06-30
232
100
 
233
101
  ### Added
234
102
 
235
- - **Self-describing registry entry.** `server.json` now declares
236
- `environmentVariables` (`STEAM_API_KEY`, `STEAM_ID`, `STEAM_COUNTRY`,
237
- `STEAM_LANGUAGE`) on both packages, so registry consumers (agents, installers)
238
- can surface every config option — previously only `STEAM_API_KEY` showed up
239
- (and only because tools inferred it).
103
+ - Expose `environmentVariables` in `server.json` so registry consumers can surface every config option ([9f6bdef](https://github.com/Grinv/steam-games-mcp/commit/9f6bdef)).
240
104
 
241
105
  ## [0.4.2] - 2026-06-30
242
106
 
243
107
  ### Fixed
244
108
 
245
- - **MCP Registry publish.** The v0.4.1 registry publish failed schema validation —
246
- `server.json`'s `description` was 118 chars but the registry caps it at 100.
247
- Shortened it (npm/manifest are unaffected) and added a `version.test.ts` guard.
248
- This is the first release to actually land in the registry.
109
+ - Shorten `server.json`'s `description`, which exceeded the registry's 100-char cap and broke the v0.4.1 publish ([dfb1c6d](https://github.com/Grinv/steam-games-mcp/commit/dfb1c6d)).
249
110
 
250
111
  ## [0.4.1] - 2026-06-30
251
112
 
252
113
  ### Added
253
114
 
254
- - **MCP Registry publishing setup** (`registry.modelcontextprotocol.io`)
255
- as `io.github.Grinv/steam-games-mcp`, listing both the npm and `.mcpb` packages.
256
- `package.json` gains an `mcpName` marker (npm ownership verification) and
257
- `server.json` lists both packages with the `.mcpb` `fileSha256`. The release
258
- workflow now publishes to the registry automatically via `mcp-publisher` with
259
- GitHub OIDC (no token), injecting the freshly-packed bundle's hash.
115
+ - Publish to the MCP Registry (npm + `.mcpb` packages), automated in the release workflow ([c61d0ac](https://github.com/Grinv/steam-games-mcp/commit/c61d0ac)).
260
116
 
261
117
  ## [0.4.0] - 2026-06-30
262
118
 
263
119
  ### Added
264
120
 
265
- - **MCP logging capability.** The server now declares the `logging` capability and
266
- mirrors its stderr log lines to the connected client as `notifications/message`,
267
- so MCP hosts can surface server logs in their UI and adjust verbosity at runtime
268
- via `logging/setLevel`. stderr logging is unchanged; the new channel is
269
- best-effort, credential-redacted, and gated by the same `LOG_LEVEL` threshold.
270
-
271
- ### Changed
272
-
273
- - **Internal: `src/format.ts` split into `src/format/`** (`storefront.ts`, `web.ts`,
274
- shared helpers in `shared.ts`), mirroring the `clients/` and `tools/` layout. No
275
- behavior change; public tool output is identical.
276
- - `npm run test:coverage` now enforces the 80%-lines gate locally (previously only
277
- in CI), so coverage regressions are caught before pushing. Falls back to
278
- report-only on Node < 22.8 (the threshold flag's minimum).
121
+ - Support the MCP logging capability, mirroring stderr log lines to the client as `notifications/message` ([649ce1c](https://github.com/Grinv/steam-games-mcp/commit/649ce1c)).
279
122
 
280
123
  ### Fixed
281
124
 
282
- - Logger stderr prefix said `[mal-mcp]` (template leftover); now `[steam-games-mcp]`.
283
- - `redact()` now masks the Steam Web API `key` query param. It travels in request
284
- URLs that are logged at debug level, so it could previously leak into logs (and,
285
- with the new MCP logging channel, to clients).
125
+ - Correct the logger's stderr prefix, which showed `[mal-mcp]` (template leftover) instead of `[steam-games-mcp]` ([649ce1c](https://github.com/Grinv/steam-games-mcp/commit/649ce1c)).
126
+ - Mask the Steam Web API `key` query param in `redact()`, which could leak into logs ([649ce1c](https://github.com/Grinv/steam-games-mcp/commit/649ce1c)).
286
127
 
287
- ### Removed
288
-
289
- - Dead `src/lib/tokenStore.ts` — a MAL OAuth-token persistence leftover from the
290
- template, unused here (Steam auth is a single env key, no token rotation).
291
-
292
- ## [0.3.0]
128
+ ## [0.3.0] - 2026-06-30
293
129
 
294
130
  ### Changed
295
131
 
296
- - **`discover_deals` merged into `discover_games`** (breaking). They were the same
297
- catalog query with different presets, so they collapse into one tool. Pass
298
- `min_discount` for deals, `released_after` / `released_within_days` for new
299
- releases, `steam_deck` for Deck-capable games, and `min_review` / `min_reviews`
300
- for rating — in any combination. Migration: replace
301
- `discover_deals({ min_discount })` with `discover_games({ min_discount })`.
132
+ - Merge `discover_deals` into `discover_games` (breaking) — pass `min_discount`, `released_after`, `steam_deck` or `min_review` in any combination ([4e62041](https://github.com/Grinv/steam-games-mcp/commit/4e62041)).
133
+ Migrate `discover_deals({ min_discount })` calls to `discover_games({ min_discount })`.
302
134
 
303
135
  ### Added
304
136
 
305
- - `STEAM_ID` config (env / `.mcpb` user_config): set a default player — a 17-digit
306
- SteamID64 or a vanity name (resolved once via the Web API) — so the player tools
307
- (`get_wishlist`, `get_owned_games`, `get_recently_played`, `get_player_summary`,
308
- `get_player_achievements`) default to you. Their `steamid` argument is now
309
- optional and falls back to `STEAM_ID`; ask "my wishlist" without passing an ID.
310
- - `get_game` now accepts a `name` as an alternative to `appid` — a title is
311
- resolved to the closest store match, so you can look a game up without an appid.
312
- - `get_player_achievements` gains a per-call `language` override for achievement
313
- names/descriptions, matching `get_game_achievements` (falls back to `STEAM_LANGUAGE`).
314
- - `discover_games` — find games catalog-wide (keyless) by discount, release recency
315
- (`released_after` / `released_within_days`), **Steam Deck** compatibility and
316
- review quality, in any combination. Sorts the catalog by popularity so the scanned
317
- window holds real games with genuine Deck ratings and review counts (the default
318
- appid order surfaced Deck-untested shovelware). Answers both "games >80% off with
319
- 90%+ reviews" and "recent well-reviewed games that run on Steam Deck".
320
- - **Steam Deck compatibility** (`verified` / `playable` / `unsupported` / `unknown`)
321
- is reported by `get_items` and `discover_games` (via `include_platforms`), with a
322
- `steam_deck` filter on `discover_games`. Note: Steam's catalog API has no
323
- server-side Deck filter or release-date sort, so the Deck/recency/review filters
324
- are applied over the popularity-sorted page (raise `count` for stricter filters).
325
-
326
- ### Docs
327
-
328
- - README: natural-language example queries and a step-by-step
329
- "Getting your credentials" guide (API key, Steam ID, public profile).
330
-
331
- ## [0.2.0]
137
+ - Add `STEAM_ID` config — a default SteamID64/vanity name that player tools fall back to when `steamid` is omitted ([4e62041](https://github.com/Grinv/steam-games-mcp/commit/4e62041)).
138
+ - Add a `name` parameter to `get_game` as an alternative to `appid`, resolved to the closest store match ([4e62041](https://github.com/Grinv/steam-games-mcp/commit/4e62041)).
139
+ - Add a per-call `language` override to `get_player_achievements`, matching `get_game_achievements` ([4e62041](https://github.com/Grinv/steam-games-mcp/commit/4e62041)).
140
+ - Add `discover_games` — find games catalog-wide by discount, recency, Steam Deck compatibility and review quality ([4e62041](https://github.com/Grinv/steam-games-mcp/commit/4e62041)).
141
+ - Add Steam Deck compatibility ratings to `get_items`/`discover_games`, with a matching filter ([4e62041](https://github.com/Grinv/steam-games-mcp/commit/4e62041)).
142
+
143
+ ## [0.2.0] - 2026-06-30
332
144
 
333
145
  ### Changed
334
146
 
335
- - **Renamed the package to `steam-games-mcp`** (npm `steam-mcp` is taken by an
336
- unrelated project). The GitHub repo, npm package, `.mcpb` and config snippets
337
- all use `steam-games-mcp`; install with `npx -y steam-games-mcp`.
147
+ - Rename the package to `steam-games-mcp` (npm `steam-mcp` was taken) ([3a8577b](https://github.com/Grinv/steam-games-mcp/commit/3a8577b)).
338
148
 
339
149
  ### Added
340
150
 
341
- - `discover_deals` — catalog-wide deal discovery via Steam's own keyless
342
- `IStoreQueryService/Query` (`price_filters.min_discount_percent`): find all
343
- games at/above a discount, with discount %, price, review % and release date in
344
- one call; optional `min_review` / `min_reviews` thresholds. No appids needed.
345
- - `get_items` — batch store card (price/discount, review % positive, release
346
- date) for a LIST of appids in one keyless call (`IStoreBrowseService/GetItems`).
347
- Collapses the previous N-per-game review calls.
151
+ - Add `discover_deals` — catalog-wide deal discovery by discount %, price and review %, with optional review thresholds ([1e1bd7f](https://github.com/Grinv/steam-games-mcp/commit/1e1bd7f)).
152
+ - Add `get_items` — batch store cards (price, discount, review %, release date) for a list of appids in one call ([e4d88ea](https://github.com/Grinv/steam-games-mcp/commit/e4d88ea)).
153
+
154
+ ### Fixed
155
+
156
+ - Restore `get_prices` to the manifest and drop a stale, already-removed `get_deals` reference in `get_specials` ([e14b05b](https://github.com/Grinv/steam-games-mcp/commit/e14b05b)).
348
157
 
349
158
  ### Removed
350
159
 
351
- - The IsThereAnyDeal (ITAD) integration and `ITAD_API_KEY`: `get_deals`,
352
- `get_game_info`, `get_current_prices`, `get_price_history`. Deal discovery,
353
- batch prices and review scores are now Steam-native and keyless via
354
- `discover_deals`, `get_items` and `get_prices`, so the third-party dependency
355
- is gone. **Price history is no longer offered** — Steam exposes no price-history
356
- API (only SteamDB/ITAD track it), and we chose to stay Steam-only and
357
- dependency-free.
160
+ - Remove the IsThereAnyDeal (ITAD) integration — deal discovery, batch prices and reviews are now Steam-native via `discover_deals`/`get_items`/`get_prices` ([1e1bd7f](https://github.com/Grinv/steam-games-mcp/commit/1e1bd7f)).
161
+ Price history is no longer offered; Steam exposes no price-history API.
358
162
 
359
- ## [0.1.0]
163
+ ## [0.1.0] - 2026-06-30
360
164
 
361
165
  ### Added
362
166
 
363
- - Initial release. Steam MCP server on the reusable carcass (`lib/`: http,
364
- rateLimit, cache, errors, logger, result) with tsup/tsc build, `node:test`,
365
- `.mcpb` manifest, `server.json`, live `check:api`, and GitHub Actions CI/release.
366
- - Store/keyless tools: `search_games` (with price), `get_game` (price, genres,
367
- platforms, Metacritic, age rating, DLC, requirements, highlighted achievements),
368
- `get_game_reviews` (+ `review_language` / `type`), `get_review_histogram`,
369
- `get_prices` (batch), `get_specials`, `get_featured`, `get_game_news`,
370
- `get_global_achievements`, `get_current_players`, `get_wishlist`.
371
- - Player tools (free `STEAM_API_KEY`): `resolve_vanity_url`, `get_player_summary`
372
- (with `visibility`), `get_owned_games`, `get_recently_played`,
373
- `get_player_achievements`, `get_game_achievements` (names + rarity). Private
374
- profiles return a clear `found: false` reason; `get_player_achievements`
375
- distinguishes a private profile from a game with no achievements.
376
- - Region/locale aware via `STEAM_COUNTRY` / `STEAM_LANGUAGE`, with per-call
377
- `country` / `language` overrides on the store/search/detail tools.
167
+ - Initial release of the Steam MCP server, built on the reusable carcass (`lib/`) with `.mcpb`/`server.json`/CI ([95be5ec](https://github.com/Grinv/steam-games-mcp/commit/95be5ec)).
168
+ - Add store/keyless tools: `search_games`, `get_game`, `get_game_reviews`, `get_review_histogram`, `get_prices`, `get_specials`, `get_featured`, `get_game_news`, `get_global_achievements`, `get_current_players`, `get_wishlist` ([95be5ec](https://github.com/Grinv/steam-games-mcp/commit/95be5ec), [808c0bc](https://github.com/Grinv/steam-games-mcp/commit/808c0bc), [b4e0a10](https://github.com/Grinv/steam-games-mcp/commit/b4e0a10)).
169
+ - Add player tools (free `STEAM_API_KEY`): `resolve_vanity_url`, `get_player_summary`, `get_owned_games`, `get_recently_played`, `get_player_achievements`, `get_game_achievements` ([95be5ec](https://github.com/Grinv/steam-games-mcp/commit/95be5ec), [c31b09a](https://github.com/Grinv/steam-games-mcp/commit/c31b09a), [c663715](https://github.com/Grinv/steam-games-mcp/commit/c663715), [0239c0e](https://github.com/Grinv/steam-games-mcp/commit/0239c0e)).
170
+ - Add region/locale support via `STEAM_COUNTRY`/`STEAM_LANGUAGE`, with per-call overrides ([048f8fe](https://github.com/Grinv/steam-games-mcp/commit/048f8fe)).
package/README.md CHANGED
@@ -3,11 +3,17 @@
3
3
  [![npm version](https://img.shields.io/npm/v/steam-games-mcp.svg)](https://www.npmjs.com/package/steam-games-mcp)
4
4
  [![CI](https://github.com/Grinv/steam-games-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Grinv/steam-games-mcp/actions/workflows/ci.yml)
5
5
  [![license: MIT](https://img.shields.io/npm/l/steam-games-mcp.svg)](LICENSE)
6
+ [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.Grinv%2Fsteam--games--mcp-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.Grinv/steam-games-mcp&version=latest)
7
+ [![steam-games-mcp MCP server](https://glama.ai/mcp/servers/Grinv/steam-games-mcp/badges/score.svg)](https://glama.ai/mcp/servers/Grinv/steam-games-mcp)
6
8
 
7
9
  An [MCP](https://modelcontextprotocol.io) server for **Steam**: search games and
8
10
  read store details, prices, reviews, discounts and news (no key), plus player
9
11
  profiles, libraries and achievements via the official **Steam Web API** (free key).
10
12
 
13
+ **Read-only · official Steam APIs only · most tools need no key · open source.**
14
+ Nobody logs in; the only credential is a free Steam Web API key you set yourself,
15
+ and the server never writes, trades, posts, launches games, or makes purchases.
16
+
11
17
  Works with any MCP client (Claude Desktop/Code, Cursor, VS Code, Cline, …) over stdio.
12
18
 
13
19
  Once it's connected, just ask your agent in natural language.
@@ -45,6 +51,7 @@ Once it's connected, just ask your agent in natural language.
45
51
  "How far am I through Elden Ring's achievements?"
46
52
  "What's the SteamID64 for the profile name 'gabelogannewell'?"
47
53
  "Which of my friends own Portal 2, and how many hours have they played?"
54
+ "What games do my friend and I both own, and who's played them more?"
48
55
  "Show me my Steam friends list."
49
56
  "Is SteamID 76561197960287930 VAC banned?"
50
57
  "What games am I following that aren't on my wishlist?"
@@ -111,7 +118,7 @@ need a free API key and a public profile. Three short steps:
111
118
  > The key and Steam ID go in your MCP client config (the `env` block above) — see
112
119
  > [docs/clients.md](docs/clients.md) for per-client examples. Never commit them.
113
120
 
114
- ## What it does
121
+ ## Tools
115
122
 
116
123
  Key: **–** no credentials · **K** Steam Web API key.
117
124
 
@@ -140,6 +147,7 @@ Key: **–** no credentials · **K** Steam Web API key.
140
147
  | `get_player_achievements` | K | A player's achievement progress in a game |
141
148
  | `get_friend_list` | K | A player's friends — name, online state, current game (public friends list) |
142
149
  | `find_friends_who_own` | K | Which friends own given appid(s) + their playtime — checks each friend's FULL library, not just top 50 |
150
+ | `compare_players` | K | Games two players both own, with each one's playtime — checks each player's FULL library, not just top 50 |
143
151
 
144
152
  **Two tiers.** Store/search + discovery tools (`store`/`api.steampowered.com`)
145
153
  need **no credentials** — including catalog-wide discovery (`discover_games`:
@@ -154,6 +162,17 @@ default to you, so "my wishlist / library" works without passing an ID each time
154
162
  > (keyless) store APIs. SteamDB is not used (no public API + scraping disallowed).
155
163
  > Steam has no price-history API, so that isn't offered. Not affiliated with Valve.
156
164
 
165
+ ## Prompts
166
+
167
+ Guided one-shot prompts that orchestrate several tools for a common question —
168
+ use these when your client exposes MCP prompts, instead of describing the steps yourself:
169
+
170
+ | Prompt | Args | What it does |
171
+ | -------------------- | --------------------------------------------------- | -------------------------------------------------------------------------- |
172
+ | `what_should_i_play` | `steamid`, `budget`, `tags` (all optional) | Recommends catalog games from your library/taste, excluding what you own |
173
+ | `is_it_worth_buying` | `game` (title or appid) | Price, review trend and Steam Deck compatibility → a buy/wait/skip verdict |
174
+ | `deals_digest` | `min_discount`, `min_review`, `tags` (all optional) | A curated list of well-reviewed discounted games |
175
+
157
176
  ## Develop
158
177
 
159
178
  ```sh
@@ -167,6 +186,7 @@ npm run inspector # run under the MCP Inspector
167
186
  ```
168
187
 
169
188
  Runtime requires Node ≥ 20. Contributor/agent guidance: [AGENTS.md](AGENTS.md).
189
+ Security policy: [SECURITY.md](SECURITY.md).
170
190
  Per-client config and all tunables: [docs/clients.md](docs/clients.md).
171
191
 
172
192
  ## Updating