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 +39 -0
- package/PRIVACY.md +6 -6
- package/README.md +5 -5
- package/dist/index.js +22 -22
- package/package.json +15 -19
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
|
|
38
|
-
parameters. Backs the classic store tools (`
|
|
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 `
|
|
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-
|
|
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 +
|
|
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
|
|
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 ≥
|
|
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:
|