steam-games-mcp 0.4.6 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -6,6 +6,151 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.6.0] - 2026-07-12
10
+
11
+ ### Added
12
+
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.
21
+
22
+ ### Fixed
23
+
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.
31
+
32
+ ## [0.5.0] - 2026-07-09
33
+
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.
38
+
39
+ ### Added
40
+
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).
84
+
85
+ ### Fixed
86
+
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.)
153
+
9
154
  ## [0.4.6] - 2026-06-30
10
155
 
11
156
  ### Fixed
package/README.md CHANGED
@@ -19,14 +19,18 @@ Once it's connected, just ask your agent in natural language.
19
19
  "What are recent reviews saying about Baldur's Gate 3?"
20
20
  "Have Cyberpunk 2077's reviews recovered since launch?"
21
21
  "Which games are >80% off right now with 90%+ positive reviews?"
22
+ "Find roguelike deckbuilders on sale."
23
+ "What discounted games run natively on macOS?"
22
24
  "Which recent, well-reviewed games run on Steam Deck?"
25
+ "What well-reviewed games run on the Steam Machine / SteamOS?"
26
+ "Any Steam Frame–Verified VR games on sale?"
23
27
  "What's discounted on Steam's front page right now?"
24
28
  "Show me Steam's top sellers and newest releases."
25
29
  "Any recent patch notes for No Man's Sky?"
26
30
  "How rare is each achievement in Elden Ring?"
27
31
  "How many people are playing Counter-Strike 2 right now?"
28
32
  "Get current prices for appids 620, 413150 and 1145360."
29
- "For appids 1245620 and 1086940, show price, review % and Steam Deck status."
33
+ "For appids 1245620 and 1086940, show price, review % and Deck / SteamOS / Frame status."
30
34
  ```
31
35
 
32
36
  **With a free API key + your `STEAM_ID`** (your account; see [Getting your credentials](#getting-your-credentials)):
@@ -39,6 +43,8 @@ Once it's connected, just ask your agent in natural language.
39
43
  "List Hollow Knight's achievements and how rare each one is."
40
44
  "How far am I through Elden Ring's achievements?"
41
45
  "What's the SteamID64 for the profile name 'gabelogannewell'?"
46
+ "Which of my friends own Portal 2, and how many hours have they played?"
47
+ "Show me my Steam friends list."
42
48
  ```
43
49
 
44
50
  ## Install
@@ -106,31 +112,34 @@ need a free API key and a public profile. Three short steps:
106
112
 
107
113
  Key: **–** no credentials · **K** Steam Web API key.
108
114
 
109
- | Tool | Key | Purpose |
110
- | ------------------------- | --- | ------------------------------------------------------------------------------------------------------- |
111
- | `search_games` | – | Find games by title → appid (with price) |
112
- | `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements |
113
- | `get_items` | – | Batch store card (price, review %, **Steam Deck**, release) for a LIST of appids — one call |
114
- | `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Steam Deck** and rating — no appids needed |
115
- | `get_game_reviews` | – | Review summary + recent reviews |
116
- | `get_review_histogram` | – | Review trend over time (history + recent) |
117
- | `get_prices` | – | Batch current price/discount for many appids |
118
- | `get_specials` | – | Steam front-page discounts |
119
- | `get_featured` | – | Featured sections (top sellers, new releases, …) |
120
- | `get_game_news` | – | Recent news / patch notes |
121
- | `get_global_achievements` | – | Global achievement unlock rates (rarity) |
122
- | `get_current_players` | – | Live concurrent player count |
123
- | `get_wishlist` | – | A player's wishlist appids (public profiles) |
124
- | `get_game_achievements` | K | Full achievement list (names, descriptions) + rarity |
125
- | `resolve_vanity_url` | K | Custom profile name → SteamID64 |
126
- | `get_player_summary` | K | Player public profile |
127
- | `get_owned_games` | K | A player's games + playtime |
128
- | `get_recently_played` | K | Games played in the last two weeks |
129
- | `get_player_achievements` | K | A player's achievement progress in a game |
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 |
130
138
 
131
139
  **Two tiers.** Store/search + discovery tools (`store`/`api.steampowered.com`)
132
140
  need **no credentials** — including catalog-wide discovery (`discover_games`:
133
- deals, new releases, Steam Deck, rating) and batch price/review checks (`get_items`).
141
+ deals, new releases, Deck / SteamOS / Frame compatibility, tags, rating) and batch
142
+ price/review checks (`get_items`).
134
143
  Player tools need a free
135
144
  **`STEAM_API_KEY`** and a **public** profile; they return a clear message when the
136
145
  key is unset. Set **`STEAM_ID`** (a SteamID64 or vanity name) to make those tools