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 +31 -0
- package/README.md +32 -27
- package/dist/index.js +11 -11
- package/package.json +2 -2
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
|
|
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
|
-
| `
|
|
131
|
-
| `
|
|
132
|
-
| `
|
|
133
|
-
| `
|
|
134
|
-
| `
|
|
135
|
-
| `
|
|
136
|
-
| `
|
|
137
|
-
| `
|
|
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 ≥
|
|
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
|