steam-games-mcp 0.12.2 → 0.13.1
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 +58 -0
- package/README.md +30 -28
- package/dist/index.js +20 -20
- package/package.json +6 -6
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,64 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
|
6
6
|
|
|
7
7
|
## [Unreleased]
|
|
8
8
|
|
|
9
|
+
## [0.13.1] - 2026-08-13
|
|
10
|
+
|
|
11
|
+
### Changed
|
|
12
|
+
|
|
13
|
+
- Cap `discover_games` at 60 results per call, best discount first, and report the pre-cap count as `matched` — at its own advertised `count: 200` the response was ~104 KB, which MCP clients reject outright. ([aee1c31](https://github.com/Grinv/steam-games-mcp/commit/aee1c31))
|
|
14
|
+
|
|
15
|
+
### Fixed
|
|
16
|
+
|
|
17
|
+
- Fix `get_recently_played`'s description claiming most-recently-played ordering when it sorts by two-week playtime — the ordering decides what the new cap discards. ([aee1c31](https://github.com/Grinv/steam-games-mcp/commit/aee1c31))
|
|
18
|
+
- Fix `find_friends_who_own` picking its 200 checked friends in Steam's raw payload order, which barely overlapped the 100 `get_friend_list` shows for the same account. ([aee1c31](https://github.com/Grinv/steam-games-mcp/commit/aee1c31))
|
|
19
|
+
- Fix `get_game_reviews`' `review_language` not warning that an ISO code like 'ru' makes Steam report zero reviews instead of erroring. ([aee1c31](https://github.com/Grinv/steam-games-mcp/commit/aee1c31))
|
|
20
|
+
|
|
21
|
+
## [0.13.0] - 2026-08-13
|
|
22
|
+
|
|
23
|
+
### Security
|
|
24
|
+
|
|
25
|
+
- Collapse whitespace in the prompts' free-form arguments, so a multi-line value can't render as its own paragraph of agent instructions. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
|
|
26
|
+
|
|
27
|
+
### Changed
|
|
28
|
+
|
|
29
|
+
- Halve `get_items`' appid cap to 50 and `get_prices`' to 250 — the old caps produced ~56 KB responses MCP clients reject as over their token limit. ([b9539bf](https://github.com/Grinv/steam-games-mcp/commit/b9539bf))
|
|
30
|
+
- Lower `get_game_achievements`' cap to 150 achievements (was 200) — its entries carry description text, making them ~3x heavier than its siblings'. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
31
|
+
- Cap `get_game`'s `dlc` list at 50 appids and add a `dlc_total` count. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
32
|
+
- Cap `get_recently_played` at 50 games, most-played first, and add a `returned` count. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
33
|
+
- Add a `reason` to `get_player_summary`/`get_player_bans`' `found: false` — both read private profiles fine, so it can only mean no such account. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
34
|
+
- Carry `available: true` on every `get_items` row, so the discriminator is present on all rows like `get_prices`'. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
35
|
+
- Cap `find_friends_who_own` at 200 friends looked up per call and report `friends_checked` — checking every friend of a 634-friend account ran past an MCP client's 60s request timeout. ([50efbde](https://github.com/Grinv/steam-games-mcp/commit/50efbde))
|
|
36
|
+
- **Breaking:** rename `get_recommended_games`' `count` parameter to `limit`, matching every other tool that caps what it returns. `discover_games` keeps `count`, which means entries to scan. ([038dca0](https://github.com/Grinv/steam-games-mcp/commit/038dca0))
|
|
37
|
+
|
|
38
|
+
### Fixed
|
|
39
|
+
|
|
40
|
+
- Fix an unrecognized `language` (e.g. 'ru' instead of 'russian') silently making every `tags` filter match nothing instead of failing with an error. ([b9539bf](https://github.com/Grinv/steam-games-mcp/commit/b9539bf))
|
|
41
|
+
- Fix `discover_games`' `released_after` accepting an impossible date ('2026-13-45', '2026-02-31'), which silently disabled or shifted the cutoff. ([b9539bf](https://github.com/Grinv/steam-games-mcp/commit/b9539bf))
|
|
42
|
+
- Fix `get_prices` discarding every already-fetched batch when a single chunk of appids failed, instead of failing only when all of them do. ([51032f0](https://github.com/Grinv/steam-games-mcp/commit/51032f0))
|
|
43
|
+
- Fix `find_friends_who_own` firing one request per friend at once on a large friend list and rate-limiting itself into "unavailable" results. ([51032f0](https://github.com/Grinv/steam-games-mcp/commit/51032f0))
|
|
44
|
+
- Fix `get_friend_list` spending extra round-trips enriching friends it then discarded, on accounts with more than 100 friends. ([51032f0](https://github.com/Grinv/steam-games-mcp/commit/51032f0))
|
|
45
|
+
- Fix `what_should_i_play` re-recommending already-owned games — it now checks ownership with `check_appids` instead of the top-50 `get_owned_games` list. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
|
|
46
|
+
- Fix `deals_digest` accepting a `min_discount`/`min_review` outside 1-100 and rendering a `discover_games` call that then failed validation. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
|
|
47
|
+
- Fix the prompts' `steamid` argument accepting a vanity name and rendering it into tool calls that every tool then rejects. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
|
|
48
|
+
- Fix `what_should_i_play`'s documented `budget: 'free'` rendering as "drop any result priced above free" instead of a free-to-play filter. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
|
|
49
|
+
- Fix a `prompts/get` call with no `arguments` field at all failing validation, even though every prompt argument is optional. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
|
|
50
|
+
- Fix `get_game` reporting a region-blocked appid as a nonexistent one; the error now names the country and both possible causes. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
51
|
+
- Fix `get_featured` pricing an unreleased title at "0.00 USD" as if it were free; an absent price is `null` now. ([fef888e](https://github.com/Grinv/steam-games-mcp/commit/fef888e))
|
|
52
|
+
- Fix `get_player_achievements` turning a transient 5xx during its game-schema lookup into a definitive "Achievements unavailable." ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
53
|
+
- Fix a 403 from `get_game_achievements`' keyless achievement lookup being blamed on bad credentials. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
54
|
+
- Fix `get_game_achievements` not disclosing that an empty list with `total: 0` means the appid has no achievement schema — a DLC, soundtrack, tool or demo, or no such appid. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
55
|
+
- Fix `get_game_reviews`' `review_language` accepting an empty string, which Steam treats as its own filter rather than 'all'. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
56
|
+
- Fix `get_game_reviews` not disclosing that `review_language` also rescopes the summary totals to that language. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
57
|
+
- Fix `get_items`' `price: null` not documenting its three meanings: not sold in that country, not released yet, or no purchase option. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
58
|
+
- Fix `get_owned_games`' `found: false` branch still advertising the `owns` field it stopped emitting in 0.10.1. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
59
|
+
- Fix `search_games`' description promising a `type` of "game/dlc/…" when Steam's store search returns "app" for every result. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
60
|
+
- Fix `check_appids` calling itself reliable without noting that Steam omits free-to-play titles the player has never launched. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
|
|
61
|
+
- Fix `get_player_achievements`' `game`/`name` fields not warning they can be Valve's internal codename, unlike their `get_game_achievements` twins. ([045803e](https://github.com/Grinv/steam-games-mcp/commit/045803e))
|
|
62
|
+
- Fix README claiming every player-data tool needs an API key, contradicting its own table marking `get_wishlist`/`get_followed_games` keyless. ([045803e](https://github.com/Grinv/steam-games-mcp/commit/045803e))
|
|
63
|
+
- Fix README describing `get_game_achievements` as "top 200" — the list is in definition order, not ranked, and the cap is 150. ([045803e](https://github.com/Grinv/steam-games-mcp/commit/045803e))
|
|
64
|
+
- Fix `manifest.json`'s tool summaries predating `get_wishlist`'s `include_details` and contradicting `get_items`'/`get_game_achievements`' caps. ([045803e](https://github.com/Grinv/steam-games-mcp/commit/045803e))
|
|
65
|
+
- Fix SECURITY.md's list of what the TTL cache holds reading as exhaustive while naming three of its six entries. ([045803e](https://github.com/Grinv/steam-games-mcp/commit/045803e))
|
|
66
|
+
|
|
9
67
|
## [0.12.2] - 2026-07-31
|
|
10
68
|
|
|
11
69
|
### Security
|
package/README.md
CHANGED
|
@@ -125,33 +125,33 @@ need a free API key and a public profile. Three short steps:
|
|
|
125
125
|
|
|
126
126
|
Key: **–** no credentials · **K** Steam Web API key.
|
|
127
127
|
|
|
128
|
-
| Tool | Key | Purpose
|
|
129
|
-
| ------------------------- | --- |
|
|
130
|
-
| `search_games` | – | Find games by title → appid (with price)
|
|
131
|
-
| `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements
|
|
132
|
-
| `get_items` | – | Batch store card (price, review %, **Deck/SteamOS/Machine/Frame** compat, native **platforms**, **tags**)
|
|
133
|
-
| `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Deck/SteamOS/Machine/Frame**, **platform**, **tags**, rating
|
|
134
|
-
| `get_game_reviews` | – | Review summary + recent reviews
|
|
135
|
-
| `get_review_histogram` | – | Review trend over time (history + recent)
|
|
136
|
-
| `get_prices` | – | Batch current price/discount
|
|
137
|
-
| `get_specials` | – | Steam front-page discounts
|
|
138
|
-
| `get_featured` | – | Featured sections (top sellers, new releases, …)
|
|
139
|
-
| `get_game_news` | – | Recent news / patch notes
|
|
140
|
-
| `get_global_achievements` | – | Global achievement unlock rates (rarity) — top 200
|
|
141
|
-
| `get_current_players` | – | Live concurrent player count
|
|
142
|
-
| `get_wishlist` | – | A player's wishlist — appids, or full cards + on-sale filter with `include_details` (public profiles)
|
|
143
|
-
| `get_followed_games` | – | A player's followed games (Steam's "follow" feature, separate from the wishlist) — appids (public profiles)
|
|
144
|
-
| `get_game_achievements` | K | Achievement list (names, descriptions) + rarity —
|
|
145
|
-
| `resolve_vanity_url` | K | Custom profile name → SteamID64
|
|
146
|
-
| `get_player_summary` | K | Player public profile (incl. Steam level)
|
|
147
|
-
| `get_player_bans` | K | VAC/game/community/economy ban status (works even on private profiles)
|
|
148
|
-
| `get_owned_games` | K | A player's games + playtime (top 50 by playtime; `check_appids` reliably checks specific appids past that cap)
|
|
149
|
-
| `get_recently_played` | K | Games played in the last two weeks
|
|
150
|
-
| `get_recommended_games` | K | Personalized picks from playtime-weighted tags + review quality, excluding owned games
|
|
151
|
-
| `get_player_achievements` | K | A player's achievement progress in a game — achievement list capped at top 200, unlocked first
|
|
152
|
-
| `get_friend_list` | K | A player's friends — name, online state, current game (public friends list)
|
|
153
|
-
| `find_friends_who_own` | K | Which friends own given appid(s) + their playtime —
|
|
154
|
-
| `compare_players` | K | Games two players both own, with each one's playtime — checks each player's FULL library, not just top 50
|
|
128
|
+
| Tool | Key | Purpose |
|
|
129
|
+
| ------------------------- | --- | --------------------------------------------------------------------------------------------------------------------------- |
|
|
130
|
+
| `search_games` | – | Find games by title → appid (with price) |
|
|
131
|
+
| `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements |
|
|
132
|
+
| `get_items` | – | Batch store card (price, review %, **Deck/SteamOS/Machine/Frame** compat, native **platforms**, **tags**) — up to 50 appids |
|
|
133
|
+
| `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Deck/SteamOS/Machine/Frame**, **platform**, **tags**, rating |
|
|
134
|
+
| `get_game_reviews` | – | Review summary + recent reviews |
|
|
135
|
+
| `get_review_histogram` | – | Review trend over time (history + recent) |
|
|
136
|
+
| `get_prices` | – | Batch current price/discount — up to 250 appids |
|
|
137
|
+
| `get_specials` | – | Steam front-page discounts |
|
|
138
|
+
| `get_featured` | – | Featured sections (top sellers, new releases, …) |
|
|
139
|
+
| `get_game_news` | – | Recent news / patch notes |
|
|
140
|
+
| `get_global_achievements` | – | Global achievement unlock rates (rarity) — top 200 |
|
|
141
|
+
| `get_current_players` | – | Live concurrent player count |
|
|
142
|
+
| `get_wishlist` | – | A player's wishlist — appids, or full cards + on-sale filter with `include_details` (public profiles) |
|
|
143
|
+
| `get_followed_games` | – | A player's followed games (Steam's "follow" feature, separate from the wishlist) — appids (public profiles) |
|
|
144
|
+
| `get_game_achievements` | K | Achievement list (names, descriptions) + rarity — first 150, definition order |
|
|
145
|
+
| `resolve_vanity_url` | K | Custom profile name → SteamID64 |
|
|
146
|
+
| `get_player_summary` | K | Player public profile (incl. Steam level) |
|
|
147
|
+
| `get_player_bans` | K | VAC/game/community/economy ban status (works even on private profiles) |
|
|
148
|
+
| `get_owned_games` | K | A player's games + playtime (top 50 by playtime; `check_appids` reliably checks specific appids past that cap) |
|
|
149
|
+
| `get_recently_played` | K | Games played in the last two weeks (top 50 by recent playtime) |
|
|
150
|
+
| `get_recommended_games` | K | Personalized picks from playtime-weighted tags + review quality, excluding owned games |
|
|
151
|
+
| `get_player_achievements` | K | A player's achievement progress in a game — achievement list capped at top 200, unlocked first |
|
|
152
|
+
| `get_friend_list` | K | A player's friends — name, online state, current game (public friends list) |
|
|
153
|
+
| `find_friends_who_own` | K | Which friends own given appid(s) + their playtime — each friend's FULL library, first 200 friends (`friends_checked`) |
|
|
154
|
+
| `compare_players` | K | Games two players both own, with each one's playtime — checks each player's FULL library, not just top 50 |
|
|
155
155
|
|
|
156
156
|
**Two tiers.** Store/search + discovery tools (`store`/`api.steampowered.com`)
|
|
157
157
|
need **no credentials** — including catalog-wide discovery (`discover_games`:
|
|
@@ -159,7 +159,9 @@ deals, new releases, Deck / SteamOS / Machine / Frame compatibility, tags, ratin
|
|
|
159
159
|
price/review checks (`get_items`).
|
|
160
160
|
Player tools need a free
|
|
161
161
|
**`STEAM_API_KEY`** and a **public** profile; they return a clear message when the
|
|
162
|
-
key is unset.
|
|
162
|
+
key is unset. The two exceptions are `get_wishlist` and `get_followed_games`,
|
|
163
|
+
marked **–** above: given a raw SteamID64 they work with no key at all (only
|
|
164
|
+
resolving a vanity name to an ID needs one). Set **`STEAM_ID`** (a SteamID64 or vanity name) to make those tools
|
|
163
165
|
default to you, so "my wishlist / library" works without passing an ID each time.
|
|
164
166
|
|
|
165
167
|
> No third-party services: deal discovery and reviews come from Steam's own
|