steam-games-mcp 0.7.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 +68 -281
- package/README.md +21 -1
- package/dist/index.js +39 -26
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -6,372 +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
|
+
|
|
9
20
|
## [0.7.0] - 2026-07-16
|
|
10
21
|
|
|
11
22
|
### Changed
|
|
12
23
|
|
|
13
|
-
-
|
|
24
|
+
- Raise runtime floor to Node ≥ 20 (was ≥ 18) ([58d978c](https://github.com/Grinv/steam-games-mcp/commit/58d978c)).
|
|
14
25
|
|
|
15
26
|
### Added
|
|
16
27
|
|
|
17
|
-
- `steam_machine` compat field/filter
|
|
18
|
-
|
|
19
|
-
- `
|
|
20
|
-
- `
|
|
21
|
-
- `get_player_summary` now also returns Steam level.
|
|
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)).
|
|
22
32
|
|
|
23
33
|
### Fixed
|
|
24
34
|
|
|
25
|
-
- `get_followed_games`
|
|
26
|
-
- `
|
|
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.
|
|
30
|
-
|
|
31
|
-
### Internal
|
|
32
|
-
|
|
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.
|
|
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)).
|
|
39
37
|
|
|
40
38
|
## [0.6.0] - 2026-07-12
|
|
41
39
|
|
|
42
40
|
### Added
|
|
43
41
|
|
|
44
|
-
- `get_friend_list`
|
|
45
|
-
|
|
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.
|
|
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)).
|
|
52
44
|
|
|
53
45
|
### Fixed
|
|
54
46
|
|
|
55
|
-
- `get_wishlist`
|
|
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.
|
|
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)).
|
|
62
48
|
|
|
63
49
|
## [0.5.0] - 2026-07-09
|
|
64
50
|
|
|
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.
|
|
51
|
+
Richer store cards and catalog/wishlist discovery for the SteamOS / Steam Machine era.
|
|
69
52
|
|
|
70
53
|
### Added
|
|
71
54
|
|
|
72
|
-
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
-
|
|
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).
|
|
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)).
|
|
115
65
|
|
|
116
66
|
### Fixed
|
|
117
67
|
|
|
118
|
-
-
|
|
119
|
-
|
|
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.)
|
|
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)).
|
|
184
70
|
|
|
185
71
|
## [0.4.6] - 2026-06-30
|
|
186
72
|
|
|
187
73
|
### Fixed
|
|
188
74
|
|
|
189
|
-
-
|
|
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`.
|
|
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)).
|
|
197
76
|
|
|
198
77
|
## [0.4.5] - 2026-06-30
|
|
199
78
|
|
|
200
79
|
### Fixed
|
|
201
80
|
|
|
202
|
-
-
|
|
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.
|
|
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)).
|
|
208
82
|
|
|
209
83
|
### Changed
|
|
210
84
|
|
|
211
|
-
-
|
|
212
|
-
leaner npm tarball and `.mcpb`. (We log `err.message`, not raw stacks, so
|
|
213
|
-
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)).
|
|
214
86
|
|
|
215
87
|
## [0.4.4] - 2026-06-30
|
|
216
88
|
|
|
217
89
|
### Fixed
|
|
218
90
|
|
|
219
|
-
-
|
|
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.
|
|
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)).
|
|
230
92
|
|
|
231
93
|
## [0.4.3] - 2026-06-30
|
|
232
94
|
|
|
233
95
|
### Added
|
|
234
96
|
|
|
235
|
-
-
|
|
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).
|
|
97
|
+
- Expose `environmentVariables` in `server.json` so registry consumers can surface every config option ([9f6bdef](https://github.com/Grinv/steam-games-mcp/commit/9f6bdef)).
|
|
240
98
|
|
|
241
99
|
## [0.4.2] - 2026-06-30
|
|
242
100
|
|
|
243
101
|
### Fixed
|
|
244
102
|
|
|
245
|
-
-
|
|
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.
|
|
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)).
|
|
249
104
|
|
|
250
105
|
## [0.4.1] - 2026-06-30
|
|
251
106
|
|
|
252
107
|
### Added
|
|
253
108
|
|
|
254
|
-
-
|
|
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.
|
|
109
|
+
- Publish to the MCP Registry (npm + `.mcpb` packages), automated in the release workflow ([c61d0ac](https://github.com/Grinv/steam-games-mcp/commit/c61d0ac)).
|
|
260
110
|
|
|
261
111
|
## [0.4.0] - 2026-06-30
|
|
262
112
|
|
|
263
113
|
### Added
|
|
264
114
|
|
|
265
|
-
-
|
|
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).
|
|
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)).
|
|
279
116
|
|
|
280
117
|
### Fixed
|
|
281
118
|
|
|
282
|
-
-
|
|
283
|
-
-
|
|
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).
|
|
286
|
-
|
|
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).
|
|
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)).
|
|
291
121
|
|
|
292
|
-
## [0.3.0]
|
|
122
|
+
## [0.3.0] - 2026-06-30
|
|
293
123
|
|
|
294
124
|
### Changed
|
|
295
125
|
|
|
296
|
-
-
|
|
297
|
-
|
|
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 })`.
|
|
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 })`.
|
|
302
128
|
|
|
303
129
|
### Added
|
|
304
130
|
|
|
305
|
-
- `STEAM_ID` config
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
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]
|
|
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
|
|
332
138
|
|
|
333
139
|
### Changed
|
|
334
140
|
|
|
335
|
-
-
|
|
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`.
|
|
141
|
+
- Rename the package to `steam-games-mcp` (npm `steam-mcp` was taken) ([3a8577b](https://github.com/Grinv/steam-games-mcp/commit/3a8577b)).
|
|
338
142
|
|
|
339
143
|
### Added
|
|
340
144
|
|
|
341
|
-
- `discover_deals` — catalog-wide deal discovery
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
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)).
|
|
348
151
|
|
|
349
152
|
### Removed
|
|
350
153
|
|
|
351
|
-
-
|
|
352
|
-
|
|
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.
|
|
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.
|
|
358
156
|
|
|
359
|
-
## [0.1.0]
|
|
157
|
+
## [0.1.0] - 2026-06-30
|
|
360
158
|
|
|
361
159
|
### Added
|
|
362
160
|
|
|
363
|
-
- Initial release
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
-
|
|
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.
|
|
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
|
[](https://www.npmjs.com/package/steam-games-mcp)
|
|
4
4
|
[](https://github.com/Grinv/steam-games-mcp/actions/workflows/ci.yml)
|
|
5
5
|
[](LICENSE)
|
|
6
|
+
[](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.Grinv/steam-games-mcp&version=latest)
|
|
7
|
+
[](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
|
-
##
|
|
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
|