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 +79 -261
- package/README.md +53 -28
- package/dist/index.js +39 -26
- package/package.json +3 -3
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`
|
|
14
|
-
|
|
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`
|
|
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
|
-
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
-
|
|
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
|
-
-
|
|
88
|
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
252
|
-
-
|
|
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
|
-
-
|
|
266
|
-
|
|
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
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
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
|
-
-
|
|
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
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
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
|
-
-
|
|
321
|
-
|
|
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
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
-
|
|
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
|
[](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.
|
|
@@ -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
|
|
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
|
-
##
|
|
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
|
-
| `
|
|
131
|
-
| `
|
|
132
|
-
| `
|
|
133
|
-
| `
|
|
134
|
-
| `
|
|
135
|
-
| `
|
|
136
|
-
| `
|
|
137
|
-
| `
|
|
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 ≥
|
|
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
|