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 +54 -0
- package/README.md +34 -25
- package/dist/index.js +11 -11
- package/package.json +3 -3
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
|
|
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
|
-
| `
|
|
129
|
-
| `
|
|
130
|
-
| `
|
|
131
|
-
| `
|
|
132
|
-
| `
|
|
133
|
-
| `
|
|
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 ≥
|
|
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
|