steam-games-mcp 0.5.0 → 0.7.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,60 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.7.0] - 2026-07-16
10
+
11
+ ### Changed
12
+
13
+ - Runtime floor raised to Node ≥ 20 (was ≥ 18).
14
+
15
+ ### Added
16
+
17
+ - `steam_machine` compat field/filter — `get_items`, `discover_games` and
18
+ `get_wishlist` now distinguish Steam Machine support from general `steam_os`.
19
+ - `get_followed_games` tool — a player's Steam store follows list (keyless).
20
+ - `get_player_bans` tool — VAC/game/community/economy ban status.
21
+ - `get_player_summary` now also returns Steam level.
22
+
23
+ ### Fixed
24
+
25
+ - `get_followed_games` no longer errors out if just the count lookup fails.
26
+ - `build-tests.mjs` clears `dist-tests/` before rebuilding, so deleted/renamed
27
+ test files can't leave stale compiled copies behind.
28
+ - Fixed a `RateLimiter` edge case that could misfire under a clock near the
29
+ epoch.
30
+
31
+ ### Internal
32
+
33
+ - Split the grown `clients/web.ts` / `tools/web.ts` into smaller per-concern
34
+ files.
35
+ - Split `steam.test.ts` into per-domain test files with shared fixtures.
36
+ - Tests now use `t.mock` / `t.after` (Node 20's stable `node:test` APIs)
37
+ instead of manual restore/`finally` boilerplate.
38
+ - Integration tests are grouped into `describe()` blocks per tool.
39
+
40
+ ## [0.6.0] - 2026-07-12
41
+
42
+ ### Added
43
+
44
+ - `get_friend_list` tool — a player's Steam friends (name, online state, current
45
+ game, friends-since), enriched via `GetPlayerSummaries`. Requires `STEAM_API_KEY`
46
+ and a public friends list.
47
+ - `find_friends_who_own` tool — which of a player's friends own given appid(s)
48
+ and how many hours they've played, checked against each friend's FULL
49
+ owned-games list (unlike `get_owned_games` / `get_friend_list`, never capped
50
+ to the top 50 by playtime). Friends with a private library are reported
51
+ separately, not counted as non-owners.
52
+
53
+ ### Fixed
54
+
55
+ - `get_wishlist` (`include_details`): Steam's `GetWishlistSortedFiltered` only
56
+ attaches store data to roughly the first 100 entries of a wishlist, no matter
57
+ what pagination params are sent (verified live) — on a bigger wishlist,
58
+ filters were silently only checking that prefix while the tool description
59
+ claimed the whole wishlist was covered. The response now reports `enriched`
60
+ (how many entries actually got store data) alongside `total`, with a `note`
61
+ explaining the gap when Steam truncates it.
62
+
9
63
  ## [0.5.0] - 2026-07-09
10
64
 
11
65
  Richer store cards and catalog/wishlist discovery for the SteamOS / Steam Machine
package/README.md CHANGED
@@ -22,7 +22,8 @@ Once it's connected, just ask your agent in natural language.
22
22
  "Find roguelike deckbuilders on sale."
23
23
  "What discounted games run natively on macOS?"
24
24
  "Which recent, well-reviewed games run on Steam Deck?"
25
- "What well-reviewed games run on the Steam Machine / SteamOS?"
25
+ "What well-reviewed games run on SteamOS?"
26
+ "Any games verified for the Steam Machine on sale?"
26
27
  "Any Steam Frame–Verified VR games on sale?"
27
28
  "What's discounted on Steam's front page right now?"
28
29
  "Show me Steam's top sellers and newest releases."
@@ -30,7 +31,7 @@ Once it's connected, just ask your agent in natural language.
30
31
  "How rare is each achievement in Elden Ring?"
31
32
  "How many people are playing Counter-Strike 2 right now?"
32
33
  "Get current prices for appids 620, 413150 and 1145360."
33
- "For appids 1245620 and 1086940, show price, review % and Deck / SteamOS / Frame status."
34
+ "For appids 1245620 and 1086940, show price, review % and Deck / SteamOS / Machine / Frame status."
34
35
  ```
35
36
 
36
37
  **With a free API key + your `STEAM_ID`** (your account; see [Getting your credentials](#getting-your-credentials)):
@@ -43,6 +44,10 @@ Once it's connected, just ask your agent in natural language.
43
44
  "List Hollow Knight's achievements and how rare each one is."
44
45
  "How far am I through Elden Ring's achievements?"
45
46
  "What's the SteamID64 for the profile name 'gabelogannewell'?"
47
+ "Which of my friends own Portal 2, and how many hours have they played?"
48
+ "Show me my Steam friends list."
49
+ "Is SteamID 76561197960287930 VAC banned?"
50
+ "What games am I following that aren't on my wishlist?"
46
51
  ```
47
52
 
48
53
  ## Install
@@ -110,31 +115,35 @@ need a free API key and a public profile. Three short steps:
110
115
 
111
116
  Key: **–** no credentials · **K** Steam Web API key.
112
117
 
113
- | Tool | Key | Purpose |
114
- | ------------------------- | --- | ------------------------------------------------------------------------------------------------------------ |
115
- | `search_games` | – | Find games by title → appid (with price) |
116
- | `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements |
117
- | `get_items` | – | Batch store card (price, review %, **Deck/SteamOS/Frame** compat, native **platforms**, **tags**) for appids |
118
- | `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Deck/SteamOS/Frame**, **platform**, **tags**, rating |
119
- | `get_game_reviews` | – | Review summary + recent reviews |
120
- | `get_review_histogram` | – | Review trend over time (history + recent) |
121
- | `get_prices` | – | Batch current price/discount for many appids |
122
- | `get_specials` | – | Steam front-page discounts |
123
- | `get_featured` | – | Featured sections (top sellers, new releases, …) |
124
- | `get_game_news` | – | Recent news / patch notes |
125
- | `get_global_achievements` | – | Global achievement unlock rates (rarity) |
126
- | `get_current_players` | – | Live concurrent player count |
127
- | `get_wishlist` | – | A player's wishlist — appids, or full cards + on-sale filter with `include_details` (public profiles) |
128
- | `get_game_achievements` | K | Full achievement list (names, descriptions) + rarity |
129
- | `resolve_vanity_url` | K | Custom profile name → SteamID64 |
130
- | `get_player_summary` | K | Player public profile |
131
- | `get_owned_games` | K | A player's games + playtime |
132
- | `get_recently_played` | K | Games played in the last two weeks |
133
- | `get_player_achievements` | K | A player's achievement progress in a game |
118
+ | Tool | Key | Purpose |
119
+ | ------------------------- | --- | -------------------------------------------------------------------------------------------------------------------- |
120
+ | `search_games` | – | Find games by title → appid (with price) |
121
+ | `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements |
122
+ | `get_items` | – | Batch store card (price, review %, **Deck/SteamOS/Machine/Frame** compat, native **platforms**, **tags**) for appids |
123
+ | `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Deck/SteamOS/Machine/Frame**, **platform**, **tags**, rating |
124
+ | `get_game_reviews` | – | Review summary + recent reviews |
125
+ | `get_review_histogram` | – | Review trend over time (history + recent) |
126
+ | `get_prices` | – | Batch current price/discount for many appids |
127
+ | `get_specials` | – | Steam front-page discounts |
128
+ | `get_featured` | – | Featured sections (top sellers, new releases, …) |
129
+ | `get_game_news` | – | Recent news / patch notes |
130
+ | `get_global_achievements` | – | Global achievement unlock rates (rarity) |
131
+ | `get_current_players` | – | Live concurrent player count |
132
+ | `get_wishlist` | – | A player's wishlist — appids, or full cards + on-sale filter with `include_details` (public profiles) |
133
+ | `get_followed_games` | – | A player's followed games (Steam's "follow" feature, separate from the wishlist) — appids (public profiles) |
134
+ | `get_game_achievements` | K | Full achievement list (names, descriptions) + rarity |
135
+ | `resolve_vanity_url` | K | Custom profile name → SteamID64 |
136
+ | `get_player_summary` | K | Player public profile (incl. Steam level) |
137
+ | `get_player_bans` | K | VAC/game/community/economy ban status (works even on private profiles) |
138
+ | `get_owned_games` | K | A player's games + playtime (top 50 by playtime — not for checking one specific game) |
139
+ | `get_recently_played` | K | Games played in the last two weeks |
140
+ | `get_player_achievements` | K | A player's achievement progress in a game |
141
+ | `get_friend_list` | K | A player's friends — name, online state, current game (public friends list) |
142
+ | `find_friends_who_own` | K | Which friends own given appid(s) + their playtime — checks each friend's FULL library, not just top 50 |
134
143
 
135
144
  **Two tiers.** Store/search + discovery tools (`store`/`api.steampowered.com`)
136
145
  need **no credentials** — including catalog-wide discovery (`discover_games`:
137
- deals, new releases, Deck / SteamOS / Frame compatibility, tags, rating) and batch
146
+ deals, new releases, Deck / SteamOS / Machine / Frame compatibility, tags, rating) and batch
138
147
  price/review checks (`get_items`).
139
148
  Player tools need a free
140
149
  **`STEAM_API_KEY`** and a **public** profile; they return a clear message when the
@@ -157,7 +166,7 @@ npm run check:api # live upstream health-check (Storefront keyless; player ch
157
166
  npm run inspector # run under the MCP Inspector
158
167
  ```
159
168
 
160
- Runtime requires Node ≥ 18. Contributor/agent guidance: [AGENTS.md](AGENTS.md).
169
+ Runtime requires Node ≥ 20. Contributor/agent guidance: [AGENTS.md](AGENTS.md).
161
170
  Per-client config and all tunables: [docs/clients.md](docs/clients.md).
162
171
 
163
172
  ## Updating