steam-games-mcp 0.14.0 → 0.16.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 +57 -0
- package/PRIVACY.md +23 -16
- package/README.md +8 -6
- package/dist/index.js +22 -22
- package/package.json +8 -10
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,63 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
|
6
6
|
|
|
7
7
|
## [Unreleased]
|
|
8
8
|
|
|
9
|
+
## [0.16.0] - 2026-10-20
|
|
10
|
+
|
|
11
|
+
### Added
|
|
12
|
+
|
|
13
|
+
- Add `country` and `week` to `get_charts`' `top_sellers`, for a country's own best-sellers and past weeks. ([b763cff](https://github.com/Grinv/steam-games-mcp/commit/b763cff))
|
|
14
|
+
- Add `kind` to `get_game_news`: `official` for the developer's own posts, `patch_notes` for update notes only. ([5318271](https://github.com/Grinv/steam-games-mcp/commit/5318271))
|
|
15
|
+
- Add `order` and `within_days` to `get_game_reviews`, for the newest reviews or the most helpful over any window. ([8495e0e](https://github.com/Grinv/steam-games-mcp/commit/8495e0e))
|
|
16
|
+
- Add a `most_played_deck` chart to `get_charts`: the top 100 played on Steam Deck in the past week. ([591d130](https://github.com/Grinv/steam-games-mcp/commit/591d130))
|
|
17
|
+
- Add `limit` (up to 100) to `search_games`, which returned at most ~10 matches. ([decf45e](https://github.com/Grinv/steam-games-mcp/commit/decf45e))
|
|
18
|
+
|
|
19
|
+
### Changed
|
|
20
|
+
|
|
21
|
+
- **Breaking:** `search_games` returns games only by default (`games_only: false` includes DLC, soundtracks and demos), and drops `price.currency`. ([0084dd2](https://github.com/Grinv/steam-games-mcp/commit/0084dd2), [decf45e](https://github.com/Grinv/steam-games-mcp/commit/decf45e))
|
|
22
|
+
- Report `search_games`' full match count as `total`, the real item `type` instead of `app`, and the game's own price, not a bundle's. ([decf45e](https://github.com/Grinv/steam-games-mcp/commit/decf45e))
|
|
23
|
+
- Filter `discover_games` by tags, hardware, rating and release date catalog-wide, not just within the top `count`; `min_review` skips unrated games. ([5c1c1b2](https://github.com/Grinv/steam-games-mcp/commit/5c1c1b2))
|
|
24
|
+
- Pick `get_recommended_games` candidates from games with the player's favorite tags, not just the most popular ones, which mostly helps niche tastes. ([e03ffcf](https://github.com/Grinv/steam-games-mcp/commit/e03ffcf))
|
|
25
|
+
- Resolve `get_game`'s `name` with the same search as `search_games`, so the two agree ("portal" now finds Portal, not Portal 2). ([002d745](https://github.com/Grinv/steam-games-mcp/commit/002d745))
|
|
26
|
+
- Bump the MCP TypeScript SDK to 2.3.1 and zod to 4.6.7. ([af58a4b](https://github.com/Grinv/steam-games-mcp/commit/af58a4b))
|
|
27
|
+
- Speed up `get_recommended_games` by one upstream round trip. ([3074c37](https://github.com/Grinv/steam-games-mcp/commit/3074c37))
|
|
28
|
+
|
|
29
|
+
### Fixed
|
|
30
|
+
|
|
31
|
+
- Fix `get_charts` rejecting `country` for `top_sellers` as a global-only chart; Steam ranks each country separately. ([b763cff](https://github.com/Grinv/steam-games-mcp/commit/b763cff))
|
|
32
|
+
- Fix `get_wishlist`'s detailed view filtering and pricing only a wishlist's first 100 entries; it now covers the whole wishlist. ([64d5d8e](https://github.com/Grinv/steam-games-mcp/commit/64d5d8e))
|
|
33
|
+
- Fix a bad or revoked API key being reported as a private profile or friends list; it now surfaces as a credentials error. ([e791dcb](https://github.com/Grinv/steam-games-mcp/commit/e791dcb))
|
|
34
|
+
- Fix a request hanging past `HTTP_TIMEOUT_MS` when Steam sent the headers but stalled mid-body. ([630ff5a](https://github.com/Grinv/steam-games-mcp/commit/630ff5a))
|
|
35
|
+
- Fix `get_game_achievements` caching a list without rarity for the full TTL after one failed rarity lookup. ([e791dcb](https://github.com/Grinv/steam-games-mcp/commit/e791dcb))
|
|
36
|
+
- Fix `get_game_achievements` reporting an unknown unlock rate as 0% instead of null, unlike `get_global_achievements`. ([5ae5951](https://github.com/Grinv/steam-games-mcp/commit/5ae5951))
|
|
37
|
+
- Fix `get_charts` occasionally leaving its last row without a name. ([5ae5951](https://github.com/Grinv/steam-games-mcp/commit/5ae5951), [bea0a55](https://github.com/Grinv/steam-games-mcp/commit/bea0a55))
|
|
38
|
+
- Fix tag filters with surrounding spaces silently matching or excluding nothing. ([654727b](https://github.com/Grinv/steam-games-mcp/commit/654727b))
|
|
39
|
+
- Fix `is_it_worth_buying`'s `game` argument letting a newline or quote append instructions to the prompt. ([654727b](https://github.com/Grinv/steam-games-mcp/commit/654727b))
|
|
40
|
+
|
|
41
|
+
## [0.15.0] - 2026-10-04
|
|
42
|
+
|
|
43
|
+
### Added
|
|
44
|
+
|
|
45
|
+
- Add `get_charts`: Steam's weekly top sellers, most-played and live concurrent-players top 100, keyless. ([b10a976](https://github.com/Grinv/steam-games-mcp/commit/b10a976))
|
|
46
|
+
|
|
47
|
+
### Changed
|
|
48
|
+
|
|
49
|
+
- Lower the card cap of `discover_games` and the detailed `get_wishlist` from 60 to 50, keeping responses well under client size limits. ([7500a64](https://github.com/Grinv/steam-games-mcp/commit/7500a64))
|
|
50
|
+
- Format `search_games` prices the way the store does (`$1.99`, `¥1,700`) instead of `1.99 USD`, matching the other price tools. ([e68d714](https://github.com/Grinv/steam-games-mcp/commit/e68d714))
|
|
51
|
+
- Resolve a vanity `STEAM_ID` through `steamcommunity.com` when no key is set — a new outbound host, now listed in PRIVACY.md. ([ea7b8e1](https://github.com/Grinv/steam-games-mcp/commit/ea7b8e1), [04a24ce](https://github.com/Grinv/steam-games-mcp/commit/04a24ce))
|
|
52
|
+
- Bump the MCP TypeScript SDK to 2.3.0, so every prompt renders when called with no `arguments` at all. ([c219dd6](https://github.com/Grinv/steam-games-mcp/commit/c219dd6))
|
|
53
|
+
|
|
54
|
+
### Fixed
|
|
55
|
+
|
|
56
|
+
- Fix Storefront prices naming an upgrade SKU instead of the game (Yakuza Kiwami at Rp 20 000; theHunter: Call of the Wild as free). ([e68d714](https://github.com/Grinv/steam-games-mcp/commit/e68d714), [8f7e8e5](https://github.com/Grinv/steam-games-mcp/commit/8f7e8e5), [a4e0da9](https://github.com/Grinv/steam-games-mcp/commit/a4e0da9), [00e6d8b](https://github.com/Grinv/steam-games-mcp/commit/00e6d8b))
|
|
57
|
+
- Fix store cards pricing a game at a bundle it belongs to, e.g. Rogue Trader at $48.36 for two games instead of its own $49.99. ([e68d714](https://github.com/Grinv/steam-games-mcp/commit/e68d714))
|
|
58
|
+
- Fix `get_wishlist` and `get_followed_games` demanding an API key when `STEAM_ID` is a vanity name. ([ea7b8e1](https://github.com/Grinv/steam-games-mcp/commit/ea7b8e1), [25e1a17](https://github.com/Grinv/steam-games-mcp/commit/25e1a17), [aa9322c](https://github.com/Grinv/steam-games-mcp/commit/aa9322c))
|
|
59
|
+
- Fix `get_featured` listing a bundle among `top_sellers` as if its bundle id were an appid. ([b10a976](https://github.com/Grinv/steam-games-mcp/commit/b10a976))
|
|
60
|
+
- Fix store-card release dates landing a day late for evening (Pacific) releases; `released_after` now cuts at Pacific midnight too. ([dbca8f3](https://github.com/Grinv/steam-games-mcp/commit/dbca8f3), [c580a42](https://github.com/Grinv/steam-games-mcp/commit/c580a42))
|
|
61
|
+
- Fix `find_friends_who_own` counting every owner twice when an appid is listed twice. ([53ceb3b](https://github.com/Grinv/steam-games-mcp/commit/53ceb3b))
|
|
62
|
+
- Decode HTML entities such as `"` in game descriptions, news excerpts and system requirements. ([659e49f](https://github.com/Grinv/steam-games-mcp/commit/659e49f))
|
|
63
|
+
- Fix `what_should_i_play` rejecting a blank `budget` or `steamid`, which a client's prompt form can send for an empty field. ([d72bdc8](https://github.com/Grinv/steam-games-mcp/commit/d72bdc8))
|
|
64
|
+
- Treat quoted values and unfilled `${VAR}`, `$VAR` or `%VAR%` placeholders in the config as intended, instead of sending them to Steam. ([ea7b8e1](https://github.com/Grinv/steam-games-mcp/commit/ea7b8e1), [ba0323f](https://github.com/Grinv/steam-games-mcp/commit/ba0323f))
|
|
65
|
+
|
|
9
66
|
## [0.14.0] - 2026-09-20
|
|
10
67
|
|
|
11
68
|
### Added
|
package/PRIVACY.md
CHANGED
|
@@ -30,25 +30,29 @@ The only inputs it handles are:
|
|
|
30
30
|
|
|
31
31
|
## Usage and third-party sharing
|
|
32
32
|
|
|
33
|
-
Each tool call results in
|
|
34
|
-
|
|
33
|
+
Each tool call results in outbound HTTPS requests to Valve/Steam hosts only,
|
|
34
|
+
carrying only what that specific call needs:
|
|
35
35
|
|
|
36
36
|
- **Steam Storefront API** (`store.steampowered.com`), needs no key. Carries
|
|
37
|
-
only the
|
|
38
|
-
parameters. Backs the classic store tools (`
|
|
37
|
+
only the appid(s) and the `cc`/`l` (country/language) query
|
|
38
|
+
parameters. Backs the classic store tools (`get_game`,
|
|
39
39
|
`get_game_reviews`, `get_review_histogram`, `get_prices`, `get_specials`,
|
|
40
40
|
`get_featured`).
|
|
41
41
|
- **Steam Web API** (`api.steampowered.com`), used for player data
|
|
42
42
|
(profiles, libraries, achievements, friends) and several keyless endpoints:
|
|
43
|
-
news, global achievement rates, current player counts, a player's wishlist
|
|
44
|
-
and followed games, and the modern store-card services behind `
|
|
45
|
-
`discover_games`, `get_recommended_games` and `get_wishlist`'s detailed
|
|
43
|
+
news, global achievement rates, current player counts, the top-sellers / most-played / Steam Deck most-played / live-players charts, a player's wishlist
|
|
44
|
+
and followed games, and the modern store-card services behind `search_games`
|
|
45
|
+
and `get_game`'s name lookup (these carry the search term), `get_items`, `discover_games`, `get_recommended_games` and `get_wishlist`'s detailed
|
|
46
46
|
cards. When `STEAM_API_KEY`
|
|
47
47
|
is set, it travels as a `key` query parameter on every request to this
|
|
48
48
|
host, per Valve's own API convention, never as a header, never logged
|
|
49
49
|
(see Storage and retention below).
|
|
50
|
+
- **Steam Community** (`steamcommunity.com`), only when the server config's
|
|
51
|
+
`STEAM_ID` is a vanity name rather than a SteamID64: its public profile
|
|
52
|
+
page (`/id/<name>/?xml=1`) is read once to resolve that name without a key.
|
|
53
|
+
Carries the vanity name only, never the API key.
|
|
50
54
|
|
|
51
|
-
|
|
55
|
+
All three hosts are operated by Valve Corporation and governed by
|
|
52
56
|
[Steam's own Privacy Policy](https://store.steampowered.com/privacy_agreement/)
|
|
53
57
|
once your request reaches them. `steam-games-mcp` sends data to no other
|
|
54
58
|
destination: no analytics vendor, no logging service, no server operated by
|
|
@@ -69,11 +73,14 @@ settings.
|
|
|
69
73
|
- **Caching**: successful API responses are cached in the server process's
|
|
70
74
|
own memory only (never written to disk), for a short configurable TTL
|
|
71
75
|
(`CACHE_TTL_MS`, default 5 minutes) to cut latency and avoid hammering the
|
|
72
|
-
Storefront/Web APIs. Not every endpoint is cached (e.g. reviews,
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
76
|
+
Storefront/Web APIs. Not every endpoint is cached (e.g. reviews, the
|
|
77
|
+
`get_prices` batch and `get_current_players`' count are always fetched
|
|
78
|
+
fresh, while `get_charts`' rankings, live chart included, can be up to one
|
|
79
|
+
TTL old); player-specific data is never cached, with two exceptions:
|
|
80
|
+
`get_player_summary`'s numeric Steam level is cached for up to
|
|
81
|
+
`CACHE_TTL_MS`, keyed by SteamID, since it's non-sensitive and rarely
|
|
82
|
+
changes; and a vanity-name `STEAM_ID` from the server config is remembered
|
|
83
|
+
as its resolved SteamID64 until the process exits. The cache is cleared entirely when
|
|
77
84
|
the process exits and is never shared across machines or users.
|
|
78
85
|
- **Logging**: operational logs go to stderr only (never a file, never a
|
|
79
86
|
remote endpoint, and there is no MCP `logging` capability wired up), with
|
|
@@ -82,15 +89,15 @@ settings.
|
|
|
82
89
|
plain query parameter on the wire. Log verbosity is controlled by
|
|
83
90
|
`LOG_LEVEL` (default `info`); logs live only as long as your MCP client
|
|
84
91
|
keeps that stderr stream around.
|
|
85
|
-
- Beyond the cache TTL and the
|
|
86
|
-
retains nothing. There is no persistent storage layer of any kind.
|
|
92
|
+
- Beyond the cache TTL (and, for the resolved `STEAM_ID` above, the running
|
|
93
|
+
process's lifetime), `steam-games-mcp` retains nothing. There is no persistent storage layer of any kind.
|
|
87
94
|
|
|
88
95
|
## Changes to this policy
|
|
89
96
|
|
|
90
97
|
Material changes will be noted in [CHANGELOG.md](CHANGELOG.md) and reflected
|
|
91
98
|
here, at the same URL, with the effective date below updated.
|
|
92
99
|
|
|
93
|
-
_Last updated: 2026-
|
|
100
|
+
_Last updated: 2026-10-20._
|
|
94
101
|
|
|
95
102
|
## Contact
|
|
96
103
|
|
package/README.md
CHANGED
|
@@ -37,6 +37,7 @@ Once it's connected, just ask your agent in natural language.
|
|
|
37
37
|
"Any recent patch notes for No Man's Sky?"
|
|
38
38
|
"How rare is each achievement in Elden Ring?"
|
|
39
39
|
"How many people are playing Counter-Strike 2 right now?"
|
|
40
|
+
"What are the most played games on Steam right now?"
|
|
40
41
|
"Get current prices for appids 620, 413150 and 1145360."
|
|
41
42
|
"For appids 1245620 and 1086940, show price, review % and Deck / SteamOS / Machine / Frame status."
|
|
42
43
|
```
|
|
@@ -129,18 +130,19 @@ Key: **–** no credentials · **K** Steam Web API key.
|
|
|
129
130
|
|
|
130
131
|
| Tool | Key | Purpose |
|
|
131
132
|
| ------------------------- | --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
132
|
-
| `search_games` | – | Find games by title → appid (with price)
|
|
133
|
+
| `search_games` | – | Find games by title → appid (with price, Metacritic, type) — up to 100 matches |
|
|
133
134
|
| `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements |
|
|
134
135
|
| `get_items` | – | Batch store card (price, review %, **Deck/SteamOS/Machine/Frame** compat, native **platforms**, **tags**) — up to 50 appids |
|
|
135
136
|
| `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Deck/SteamOS/Machine/Frame**, **platform**, **tags**, rating |
|
|
136
|
-
| `get_game_reviews` | – | Review summary +
|
|
137
|
+
| `get_game_reviews` | – | Review summary + the most helpful (any window up to a year) or newest reviews |
|
|
137
138
|
| `get_review_histogram` | – | Review trend over time (history + recent) |
|
|
138
139
|
| `get_prices` | – | Batch current price/discount — up to 250 appids |
|
|
139
140
|
| `get_specials` | – | Steam front-page discounts |
|
|
140
141
|
| `get_featured` | – | Featured sections (top sellers, new releases, …) |
|
|
141
|
-
| `get_game_news` | – | Recent news / patch notes
|
|
142
|
+
| `get_game_news` | – | Recent news, or only the developer's posts / patch notes |
|
|
142
143
|
| `get_global_achievements` | – | Global achievement unlock rates (rarity) — top 200 |
|
|
143
144
|
| `get_current_players` | – | Live concurrent player count |
|
|
145
|
+
| `get_charts` | – | What's popular now: weekly top sellers (global or per country, any past week), most played (also on Steam Deck), live concurrent top 100 (ranks + appids) |
|
|
144
146
|
| `get_wishlist` | – | A player's wishlist — appids, or full cards + on-sale filter with `include_details` (public profiles) |
|
|
145
147
|
| `get_followed_games` | – | A player's followed games (Steam's "follow" feature, separate from the wishlist) — appids (public profiles) |
|
|
146
148
|
| `get_game_achievements` | K | Achievement list (names, descriptions) + rarity — first 150, definition order |
|
|
@@ -162,8 +164,8 @@ price/review checks (`get_items`).
|
|
|
162
164
|
Player tools need a free
|
|
163
165
|
**`STEAM_API_KEY`** and a **public** profile; they return a clear message when the
|
|
164
166
|
key is unset. The two exceptions are `get_wishlist` and `get_followed_games`,
|
|
165
|
-
marked **–** above:
|
|
166
|
-
|
|
167
|
+
marked **–** above: they work with no key at all. Set **`STEAM_ID`** (a SteamID64
|
|
168
|
+
or vanity name — a vanity name resolves without a key too) to make those tools
|
|
167
169
|
default to you, so "my wishlist / library" works without passing an ID each time.
|
|
168
170
|
|
|
169
171
|
> No third-party services: deal discovery and reviews come from Steam's own
|
|
@@ -189,7 +191,7 @@ npm run build # type-check + bundle to dist/index.js
|
|
|
189
191
|
npm test # node:test (mocked, offline)
|
|
190
192
|
npm run lint
|
|
191
193
|
npm run format
|
|
192
|
-
npm run check:api # live upstream health-check (
|
|
194
|
+
npm run check:api # live upstream health-check (key-gated checks need STEAM_API_KEY; a public STEAM_ID verifies player fields)
|
|
193
195
|
npm run inspector # run under the MCP Inspector
|
|
194
196
|
```
|
|
195
197
|
|