steam-games-mcp 0.6.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,37 @@ 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
+
9
40
  ## [0.6.0] - 2026-07-12
10
41
 
11
42
  ### Added
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)):
@@ -45,6 +46,8 @@ Once it's connected, just ask your agent in natural language.
45
46
  "What's the SteamID64 for the profile name 'gabelogannewell'?"
46
47
  "Which of my friends own Portal 2, and how many hours have they played?"
47
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?"
48
51
  ```
49
52
 
50
53
  ## Install
@@ -112,33 +115,35 @@ need a free API key and a public profile. Three short steps:
112
115
 
113
116
  Key: **–** no credentials · **K** Steam Web API key.
114
117
 
115
- | Tool | Key | Purpose |
116
- | ------------------------- | --- | ------------------------------------------------------------------------------------------------------------ |
117
- | `search_games` | – | Find games by title → appid (with price) |
118
- | `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements |
119
- | `get_items` | – | Batch store card (price, review %, **Deck/SteamOS/Frame** compat, native **platforms**, **tags**) for appids |
120
- | `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Deck/SteamOS/Frame**, **platform**, **tags**, rating |
121
- | `get_game_reviews` | – | Review summary + recent reviews |
122
- | `get_review_histogram` | – | Review trend over time (history + recent) |
123
- | `get_prices` | – | Batch current price/discount for many appids |
124
- | `get_specials` | – | Steam front-page discounts |
125
- | `get_featured` | – | Featured sections (top sellers, new releases, …) |
126
- | `get_game_news` | – | Recent news / patch notes |
127
- | `get_global_achievements` | – | Global achievement unlock rates (rarity) |
128
- | `get_current_players` | – | Live concurrent player count |
129
- | `get_wishlist` | – | A player's wishlist — appids, or full cards + on-sale filter with `include_details` (public profiles) |
130
- | `get_game_achievements` | K | Full achievement list (names, descriptions) + rarity |
131
- | `resolve_vanity_url` | K | Custom profile name → SteamID64 |
132
- | `get_player_summary` | K | Player public profile |
133
- | `get_owned_games` | K | A player's games + playtime (top 50 by playtime — not for checking one specific game) |
134
- | `get_recently_played` | K | Games played in the last two weeks |
135
- | `get_player_achievements` | K | A player's achievement progress in a game |
136
- | `get_friend_list` | K | A player's friends — name, online state, current game (public friends list) |
137
- | `find_friends_who_own` | K | Which friends own given appid(s) + their playtime — checks each friend's FULL library, not just top 50 |
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 |
138
143
 
139
144
  **Two tiers.** Store/search + discovery tools (`store`/`api.steampowered.com`)
140
145
  need **no credentials** — including catalog-wide discovery (`discover_games`:
141
- deals, new releases, Deck / SteamOS / Frame compatibility, tags, rating) and batch
146
+ deals, new releases, Deck / SteamOS / Machine / Frame compatibility, tags, rating) and batch
142
147
  price/review checks (`get_items`).
143
148
  Player tools need a free
144
149
  **`STEAM_API_KEY`** and a **public** profile; they return a clear message when the
@@ -161,7 +166,7 @@ npm run check:api # live upstream health-check (Storefront keyless; player ch
161
166
  npm run inspector # run under the MCP Inspector
162
167
  ```
163
168
 
164
- Runtime requires Node ≥ 18. Contributor/agent guidance: [AGENTS.md](AGENTS.md).
169
+ Runtime requires Node ≥ 20. Contributor/agent guidance: [AGENTS.md](AGENTS.md).
165
170
  Per-client config and all tunables: [docs/clients.md](docs/clients.md).
166
171
 
167
172
  ## Updating