steam-games-mcp 0.13.1 → 0.14.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 +32 -0
- package/PRIVACY.md +2 -1
- package/README.md +31 -29
- package/dist/index.js +60 -63
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,38 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
|
6
6
|
|
|
7
7
|
## [Unreleased]
|
|
8
8
|
|
|
9
|
+
## [0.14.0] - 2026-09-20
|
|
10
|
+
|
|
11
|
+
### Added
|
|
12
|
+
|
|
13
|
+
- Add `limit` (1-300) and `sort` to `get_owned_games`, so the never-played tail can survive the 50-entry cap. ([459bec7](https://github.com/Grinv/steam-games-mcp/commit/459bec7), [032cb22](https://github.com/Grinv/steam-games-mcp/commit/032cb22))
|
|
14
|
+
|
|
15
|
+
### Changed
|
|
16
|
+
|
|
17
|
+
- **Breaking:** replace `get_prices`' `is_free: true` row with `priced: false` — it was reporting unreleased paid games as free. ([8e8edcb](https://github.com/Grinv/steam-games-mcp/commit/8e8edcb))
|
|
18
|
+
- Bump zod to 4.6.5; nullable output fields now emit `type: ["string", "null"]` instead of an equivalent `anyOf`. ([d614e34](https://github.com/Grinv/steam-games-mcp/commit/d614e34))
|
|
19
|
+
- Warn on every `language` field that an unrecognized value answers in English and empties `tags` rather than erroring. ([9550cc9](https://github.com/Grinv/steam-games-mcp/commit/9550cc9), [7543bcb](https://github.com/Grinv/steam-games-mcp/commit/7543bcb), [ed44f09](https://github.com/Grinv/steam-games-mcp/commit/ed44f09))
|
|
20
|
+
- Warn on every `country` field that an unrecognized two-letter code returns US prices rather than erroring. ([a3f162b](https://github.com/Grinv/steam-games-mcp/commit/a3f162b))
|
|
21
|
+
- Drop the "target profile must also be public" note from the key-gate error of the four tools that read private profiles fine. ([afeb88d](https://github.com/Grinv/steam-games-mcp/commit/afeb88d))
|
|
22
|
+
- Report one validation error instead of two for a bad `discover_games` `released_after`, and advertise `format: "date"`. ([f436189](https://github.com/Grinv/steam-games-mcp/commit/f436189))
|
|
23
|
+
|
|
24
|
+
### Fixed
|
|
25
|
+
|
|
26
|
+
- Fix `get_global_achievements`/`get_game_achievements` caching the empty list they fall back to on a 403, over any good list already stored. ([3d6f3a3](https://github.com/Grinv/steam-games-mcp/commit/3d6f3a3))
|
|
27
|
+
- Fix `get_friend_list`/`find_friends_who_own` blaming privacy when the SteamID64 has no account behind it. ([e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca))
|
|
28
|
+
- Fix `what_should_i_play` rendering a non-numeric `budget` into "drop anything priced above cheap". ([4856ddc](https://github.com/Grinv/steam-games-mcp/commit/4856ddc))
|
|
29
|
+
- Disclose that `get_prices`' `available:false` also covers a transiently failed batch chunk, not just an unknown or region-locked appid. ([1ef401d](https://github.com/Grinv/steam-games-mcp/commit/1ef401d))
|
|
30
|
+
- Disclose `get_game`'s two failure modes (no such appid vs. not sold in that country) and its DLC cap. ([8127081](https://github.com/Grinv/steam-games-mcp/commit/8127081), [e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca))
|
|
31
|
+
- Disclose that a card's `tags` array is a display sample, while tag filters match the game's full list. ([e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca))
|
|
32
|
+
- Disclose that `get_items` preserves the order of the appids passed to it, as `get_prices` already did. ([8127081](https://github.com/Grinv/steam-games-mcp/commit/8127081))
|
|
33
|
+
- Disclose which 200 friends `find_friends_who_own` checks, and that an unknown appid reads as "nobody owns it". ([e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca))
|
|
34
|
+
- Disclose that `discover_games` and `get_recommended_games` return base games only. ([e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca), [4fd509b](https://github.com/Grinv/steam-games-mcp/commit/4fd509b))
|
|
35
|
+
- Disclose the empty-vs-private and nonexistent-appid cases the player, wishlist and review tools collapsed into one result. ([e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca), [9550cc9](https://github.com/Grinv/steam-games-mcp/commit/9550cc9), [4fd509b](https://github.com/Grinv/steam-games-mcp/commit/4fd509b))
|
|
36
|
+
- Fix `get_owned_games`' description promising "most-played first" unconditionally, which `sort='playtime_asc'` contradicts. ([032cb22](https://github.com/Grinv/steam-games-mcp/commit/032cb22))
|
|
37
|
+
- Fix `discover_games` not documenting that `released_after` overrides `released_within_days`. ([9550cc9](https://github.com/Grinv/steam-games-mcp/commit/9550cc9))
|
|
38
|
+
- Fix `discover_games`' `min_review` claiming it applies over the returned page, not the scanned `count` window. ([4fd509b](https://github.com/Grinv/steam-games-mcp/commit/4fd509b))
|
|
39
|
+
- Fix PRIVACY.md omitting `get_recommended_games` from the tools backed by Steam's store-card services. ([c96d7a2](https://github.com/Grinv/steam-games-mcp/commit/c96d7a2))
|
|
40
|
+
|
|
9
41
|
## [0.13.1] - 2026-08-13
|
|
10
42
|
|
|
11
43
|
### Changed
|
package/PRIVACY.md
CHANGED
|
@@ -42,7 +42,8 @@ Valve/Steam hosts, carrying only what that specific call needs:
|
|
|
42
42
|
(profiles, libraries, achievements, friends) and several keyless endpoints:
|
|
43
43
|
news, global achievement rates, current player counts, a player's wishlist
|
|
44
44
|
and followed games, and the modern store-card services behind `get_items`,
|
|
45
|
-
`discover_games` and `get_wishlist`'s detailed
|
|
45
|
+
`discover_games`, `get_recommended_games` and `get_wishlist`'s detailed
|
|
46
|
+
cards. When `STEAM_API_KEY`
|
|
46
47
|
is set, it travels as a `key` query parameter on every request to this
|
|
47
48
|
host, per Valve's own API convention, never as a header, never logged
|
|
48
49
|
(see Storage and retention below).
|
package/README.md
CHANGED
|
@@ -99,8 +99,10 @@ as `io.github.Grinv/steam-games-mcp`.
|
|
|
99
99
|
## Getting your credentials
|
|
100
100
|
|
|
101
101
|
Store, search and discovery tools need **nothing**; skip this section if that's
|
|
102
|
-
all you want. The **player** tools (profile, library, achievements
|
|
103
|
-
need a free API key and a public profile
|
|
102
|
+
all you want. The **player** tools (profile, library, achievements)
|
|
103
|
+
need a free API key, and most also need a public profile — though `get_wishlist`
|
|
104
|
+
and `get_followed_games` need no key, and profile/ban lookups work on private
|
|
105
|
+
profiles. Three short steps:
|
|
104
106
|
|
|
105
107
|
1. **Get a free Steam Web API key.** Sign in at
|
|
106
108
|
<https://steamcommunity.com/dev/apikey>, enter any domain (e.g. `localhost`),
|
|
@@ -125,33 +127,33 @@ need a free API key and a public profile. Three short steps:
|
|
|
125
127
|
|
|
126
128
|
Key: **–** no credentials · **K** Steam Web API key.
|
|
127
129
|
|
|
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 (
|
|
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
|
|
130
|
+
| Tool | Key | Purpose |
|
|
131
|
+
| ------------------------- | --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
132
|
+
| `search_games` | – | Find games by title → appid (with price) |
|
|
133
|
+
| `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements |
|
|
134
|
+
| `get_items` | – | Batch store card (price, review %, **Deck/SteamOS/Machine/Frame** compat, native **platforms**, **tags**) — up to 50 appids |
|
|
135
|
+
| `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Deck/SteamOS/Machine/Frame**, **platform**, **tags**, rating |
|
|
136
|
+
| `get_game_reviews` | – | Review summary + recent reviews |
|
|
137
|
+
| `get_review_histogram` | – | Review trend over time (history + recent) |
|
|
138
|
+
| `get_prices` | – | Batch current price/discount — up to 250 appids |
|
|
139
|
+
| `get_specials` | – | Steam front-page discounts |
|
|
140
|
+
| `get_featured` | – | Featured sections (top sellers, new releases, …) |
|
|
141
|
+
| `get_game_news` | – | Recent news / patch notes |
|
|
142
|
+
| `get_global_achievements` | – | Global achievement unlock rates (rarity) — top 200 |
|
|
143
|
+
| `get_current_players` | – | Live concurrent player count |
|
|
144
|
+
| `get_wishlist` | – | A player's wishlist — appids, or full cards + on-sale filter with `include_details` (public profiles) |
|
|
145
|
+
| `get_followed_games` | – | A player's followed games (Steam's "follow" feature, separate from the wishlist) — appids (public profiles) |
|
|
146
|
+
| `get_game_achievements` | K | Achievement list (names, descriptions) + rarity — first 150, definition order |
|
|
147
|
+
| `resolve_vanity_url` | K | Custom profile name → SteamID64 |
|
|
148
|
+
| `get_player_summary` | K | Player public profile (incl. Steam level) |
|
|
149
|
+
| `get_player_bans` | K | VAC/game/community/economy ban status (works even on private profiles) |
|
|
150
|
+
| `get_owned_games` | K | A player's games + playtime (50 by playtime, `limit` widens to 300 and `sort` flips which end is kept; `check_appids` reliably checks specific appids past that) |
|
|
151
|
+
| `get_recently_played` | K | Games played in the last two weeks (top 50 by recent playtime) |
|
|
152
|
+
| `get_recommended_games` | K | Personalized picks from playtime-weighted tags + review quality, excluding owned games |
|
|
153
|
+
| `get_player_achievements` | K | A player's achievement progress in a game — achievement list capped at top 200, unlocked first |
|
|
154
|
+
| `get_friend_list` | K | A player's friends — name, online state, current game (public friends list) |
|
|
155
|
+
| `find_friends_who_own` | K | Which friends own given appid(s) + their playtime — each friend's FULL library, first 200 friends (`friends_checked`) |
|
|
156
|
+
| `compare_players` | K | Games two players both own, with each one's playtime — checks each player's FULL library, not just top 50 |
|
|
155
157
|
|
|
156
158
|
**Two tiers.** Store/search + discovery tools (`store`/`api.steampowered.com`)
|
|
157
159
|
need **no credentials** — including catalog-wide discovery (`discover_games`:
|