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