steam-games-mcp 0.15.0 → 0.17.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,45 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.17.0] - 2026-10-22
10
+
11
+ ### Changed
12
+
13
+ - **Breaking:** Raise runtime floor to Node ≥ 22.18 (was ≥ 20.11); Node 20 reached end-of-life in April 2026. ([955ab8b](https://github.com/Grinv/steam-games-mcp/commit/955ab8b))
14
+ - Declare the Node runtime floor in `manifest.json`, so MCPB hosts can check it before launching the server. ([955ab8b](https://github.com/Grinv/steam-games-mcp/commit/955ab8b))
15
+
16
+ ## [0.16.0] - 2026-10-20
17
+
18
+ ### Added
19
+
20
+ - Add `country` and `week` to `get_charts`' `top_sellers`, for a country's own best-sellers and past weeks. ([b763cff](https://github.com/Grinv/steam-games-mcp/commit/b763cff))
21
+ - Add `kind` to `get_game_news`: `official` for the developer's own posts, `patch_notes` for update notes only. ([5318271](https://github.com/Grinv/steam-games-mcp/commit/5318271))
22
+ - Add `order` and `within_days` to `get_game_reviews`, for the newest reviews or the most helpful over any window. ([8495e0e](https://github.com/Grinv/steam-games-mcp/commit/8495e0e))
23
+ - Add a `most_played_deck` chart to `get_charts`: the top 100 played on Steam Deck in the past week. ([591d130](https://github.com/Grinv/steam-games-mcp/commit/591d130))
24
+ - Add `limit` (up to 100) to `search_games`, which returned at most ~10 matches. ([decf45e](https://github.com/Grinv/steam-games-mcp/commit/decf45e))
25
+
26
+ ### Changed
27
+
28
+ - **Breaking:** `search_games` returns games only by default (`games_only: false` includes DLC, soundtracks and demos), and drops `price.currency`. ([0084dd2](https://github.com/Grinv/steam-games-mcp/commit/0084dd2), [decf45e](https://github.com/Grinv/steam-games-mcp/commit/decf45e))
29
+ - Report `search_games`' full match count as `total`, the real item `type` instead of `app`, and the game's own price, not a bundle's. ([decf45e](https://github.com/Grinv/steam-games-mcp/commit/decf45e))
30
+ - Filter `discover_games` by tags, hardware, rating and release date catalog-wide, not just within the top `count`; `min_review` skips unrated games. ([5c1c1b2](https://github.com/Grinv/steam-games-mcp/commit/5c1c1b2))
31
+ - Pick `get_recommended_games` candidates from games with the player's favorite tags, not just the most popular ones, which mostly helps niche tastes. ([e03ffcf](https://github.com/Grinv/steam-games-mcp/commit/e03ffcf))
32
+ - Resolve `get_game`'s `name` with the same search as `search_games`, so the two agree ("portal" now finds Portal, not Portal 2). ([002d745](https://github.com/Grinv/steam-games-mcp/commit/002d745))
33
+ - Bump the MCP TypeScript SDK to 2.3.1 and zod to 4.6.7. ([af58a4b](https://github.com/Grinv/steam-games-mcp/commit/af58a4b))
34
+ - Speed up `get_recommended_games` by one upstream round trip. ([3074c37](https://github.com/Grinv/steam-games-mcp/commit/3074c37))
35
+
36
+ ### Fixed
37
+
38
+ - Fix `get_charts` rejecting `country` for `top_sellers` as a global-only chart; Steam ranks each country separately. ([b763cff](https://github.com/Grinv/steam-games-mcp/commit/b763cff))
39
+ - Fix `get_wishlist`'s detailed view filtering and pricing only a wishlist's first 100 entries; it now covers the whole wishlist. ([64d5d8e](https://github.com/Grinv/steam-games-mcp/commit/64d5d8e))
40
+ - Fix a bad or revoked API key being reported as a private profile or friends list; it now surfaces as a credentials error. ([e791dcb](https://github.com/Grinv/steam-games-mcp/commit/e791dcb))
41
+ - Fix a request hanging past `HTTP_TIMEOUT_MS` when Steam sent the headers but stalled mid-body. ([630ff5a](https://github.com/Grinv/steam-games-mcp/commit/630ff5a))
42
+ - Fix `get_game_achievements` caching a list without rarity for the full TTL after one failed rarity lookup. ([e791dcb](https://github.com/Grinv/steam-games-mcp/commit/e791dcb))
43
+ - Fix `get_game_achievements` reporting an unknown unlock rate as 0% instead of null, unlike `get_global_achievements`. ([5ae5951](https://github.com/Grinv/steam-games-mcp/commit/5ae5951))
44
+ - Fix `get_charts` occasionally leaving its last row without a name. ([5ae5951](https://github.com/Grinv/steam-games-mcp/commit/5ae5951), [bea0a55](https://github.com/Grinv/steam-games-mcp/commit/bea0a55))
45
+ - Fix tag filters with surrounding spaces silently matching or excluding nothing. ([654727b](https://github.com/Grinv/steam-games-mcp/commit/654727b))
46
+ - Fix `is_it_worth_buying`'s `game` argument letting a newline or quote append instructions to the prompt. ([654727b](https://github.com/Grinv/steam-games-mcp/commit/654727b))
47
+
9
48
  ## [0.15.0] - 2026-10-04
10
49
 
11
50
  ### Added
package/PRIVACY.md CHANGED
@@ -34,15 +34,15 @@ Each tool call results in outbound HTTPS requests to Valve/Steam hosts only,
34
34
  carrying only what that specific call needs:
35
35
 
36
36
  - **Steam Storefront API** (`store.steampowered.com`), needs no key. Carries
37
- only the search term/appid(s) and the `cc`/`l` (country/language) query
38
- parameters. Backs the classic store tools (`search_games`, `get_game`,
37
+ only the appid(s) and the `cc`/`l` (country/language) query
38
+ parameters. Backs the classic store tools (`get_game`,
39
39
  `get_game_reviews`, `get_review_histogram`, `get_prices`, `get_specials`,
40
40
  `get_featured`).
41
41
  - **Steam Web API** (`api.steampowered.com`), used for player data
42
42
  (profiles, libraries, achievements, friends) and several keyless endpoints:
43
- news, global achievement rates, current player counts, the top-sellers / most-played / live-players charts, a player's wishlist
44
- and followed games, and the modern store-card services behind `get_items`,
45
- `discover_games`, `get_recommended_games` and `get_wishlist`'s detailed
43
+ news, global achievement rates, current player counts, the top-sellers / most-played / Steam Deck most-played / live-players charts, a player's wishlist
44
+ and followed games, and the modern store-card services behind `search_games`
45
+ and `get_game`'s name lookup (these carry the search term), `get_items`, `discover_games`, `get_recommended_games` and `get_wishlist`'s detailed
46
46
  cards. When `STEAM_API_KEY`
47
47
  is set, it travels as a `key` query parameter on every request to this
48
48
  host, per Valve's own API convention, never as a header, never logged
@@ -97,7 +97,7 @@ settings.
97
97
  Material changes will be noted in [CHANGELOG.md](CHANGELOG.md) and reflected
98
98
  here, at the same URL, with the effective date below updated.
99
99
 
100
- _Last updated: 2026-10-03._
100
+ _Last updated: 2026-10-20._
101
101
 
102
102
  ## Contact
103
103
 
package/README.md CHANGED
@@ -130,19 +130,19 @@ Key: **–** no credentials · **K** Steam Web API key.
130
130
 
131
131
  | Tool | Key | Purpose |
132
132
  | ------------------------- | --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
133
- | `search_games` | – | Find games by title → appid (with price) |
133
+ | `search_games` | – | Find games by title → appid (with price, Metacritic, type) — up to 100 matches |
134
134
  | `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements |
135
135
  | `get_items` | – | Batch store card (price, review %, **Deck/SteamOS/Machine/Frame** compat, native **platforms**, **tags**) — up to 50 appids |
136
136
  | `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Deck/SteamOS/Machine/Frame**, **platform**, **tags**, rating |
137
- | `get_game_reviews` | – | Review summary + recent reviews |
137
+ | `get_game_reviews` | – | Review summary + the most helpful (any window up to a year) or newest reviews |
138
138
  | `get_review_histogram` | – | Review trend over time (history + recent) |
139
139
  | `get_prices` | – | Batch current price/discount — up to 250 appids |
140
140
  | `get_specials` | – | Steam front-page discounts |
141
141
  | `get_featured` | – | Featured sections (top sellers, new releases, …) |
142
- | `get_game_news` | – | Recent news / patch notes |
142
+ | `get_game_news` | – | Recent news, or only the developer's posts / patch notes |
143
143
  | `get_global_achievements` | – | Global achievement unlock rates (rarity) — top 200 |
144
144
  | `get_current_players` | – | Live concurrent player count |
145
- | `get_charts` | – | What's popular now: weekly top sellers, most played, live concurrent top 100 (ranks + appids; price/reviews via `get_items`) |
145
+ | `get_charts` | – | What's popular now: weekly top sellers (global or per country, any past week), most played (also on Steam Deck), live concurrent top 100 (ranks + appids) |
146
146
  | `get_wishlist` | – | A player's wishlist — appids, or full cards + on-sale filter with `include_details` (public profiles) |
147
147
  | `get_followed_games` | – | A player's followed games (Steam's "follow" feature, separate from the wishlist) — appids (public profiles) |
148
148
  | `get_game_achievements` | K | Achievement list (names, descriptions) + rarity — first 150, definition order |
@@ -195,7 +195,7 @@ npm run check:api # live upstream health-check (key-gated checks need STEAM_A
195
195
  npm run inspector # run under the MCP Inspector
196
196
  ```
197
197
 
198
- Runtime requires Node ≥ 20.11. Contributor/agent guidance:
198
+ Runtime requires Node ≥ 22.18. Contributor/agent guidance:
199
199
  [AGENTS.md](https://github.com/Grinv/steam-games-mcp/blob/main/AGENTS.md).
200
200
  Security policy: [SECURITY.md](https://github.com/Grinv/steam-games-mcp/blob/main/SECURITY.md).
201
201
  Per-client config and all tunables: