steam-games-mcp 0.13.1 → 0.15.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,63 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.15.0] - 2026-10-04
10
+
11
+ ### Added
12
+
13
+ - 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))
14
+
15
+ ### Changed
16
+
17
+ - 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))
18
+ - 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))
19
+ - 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))
20
+ - 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))
21
+
22
+ ### Fixed
23
+
24
+ - 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))
25
+ - 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))
26
+ - 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))
27
+ - 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))
28
+ - 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))
29
+ - 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))
30
+ - Decode HTML entities such as `"` in game descriptions, news excerpts and system requirements. ([659e49f](https://github.com/Grinv/steam-games-mcp/commit/659e49f))
31
+ - 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))
32
+ - 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))
33
+
34
+ ## [0.14.0] - 2026-09-20
35
+
36
+ ### Added
37
+
38
+ - Add `limit` (1-300) and `sort` to `get_owned_games`, so the never-played tail can survive the 50-entry cap. ([459bec7](https://github.com/Grinv/steam-games-mcp/commit/459bec7), [032cb22](https://github.com/Grinv/steam-games-mcp/commit/032cb22))
39
+
40
+ ### Changed
41
+
42
+ - **Breaking:** replace `get_prices`' `is_free: true` row with `priced: false` — it was reporting unreleased paid games as free. ([8e8edcb](https://github.com/Grinv/steam-games-mcp/commit/8e8edcb))
43
+ - Bump zod to 4.6.5; nullable output fields now emit `type: ["string", "null"]` instead of an equivalent `anyOf`. ([d614e34](https://github.com/Grinv/steam-games-mcp/commit/d614e34))
44
+ - Warn on every `language` field that an unrecognized value answers in English and empties `tags` rather than erroring. ([9550cc9](https://github.com/Grinv/steam-games-mcp/commit/9550cc9), [7543bcb](https://github.com/Grinv/steam-games-mcp/commit/7543bcb), [ed44f09](https://github.com/Grinv/steam-games-mcp/commit/ed44f09))
45
+ - Warn on every `country` field that an unrecognized two-letter code returns US prices rather than erroring. ([a3f162b](https://github.com/Grinv/steam-games-mcp/commit/a3f162b))
46
+ - Drop the "target profile must also be public" note from the key-gate error of the four tools that read private profiles fine. ([afeb88d](https://github.com/Grinv/steam-games-mcp/commit/afeb88d))
47
+ - Report one validation error instead of two for a bad `discover_games` `released_after`, and advertise `format: "date"`. ([f436189](https://github.com/Grinv/steam-games-mcp/commit/f436189))
48
+
49
+ ### Fixed
50
+
51
+ - Fix `get_global_achievements`/`get_game_achievements` caching the empty list they fall back to on a 403, over any good list already stored. ([3d6f3a3](https://github.com/Grinv/steam-games-mcp/commit/3d6f3a3))
52
+ - Fix `get_friend_list`/`find_friends_who_own` blaming privacy when the SteamID64 has no account behind it. ([e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca))
53
+ - Fix `what_should_i_play` rendering a non-numeric `budget` into "drop anything priced above cheap". ([4856ddc](https://github.com/Grinv/steam-games-mcp/commit/4856ddc))
54
+ - Disclose that `get_prices`' `available:false` also covers a transiently failed batch chunk, not just an unknown or region-locked appid. ([1ef401d](https://github.com/Grinv/steam-games-mcp/commit/1ef401d))
55
+ - Disclose `get_game`'s two failure modes (no such appid vs. not sold in that country) and its DLC cap. ([8127081](https://github.com/Grinv/steam-games-mcp/commit/8127081), [e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca))
56
+ - Disclose that a card's `tags` array is a display sample, while tag filters match the game's full list. ([e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca))
57
+ - Disclose that `get_items` preserves the order of the appids passed to it, as `get_prices` already did. ([8127081](https://github.com/Grinv/steam-games-mcp/commit/8127081))
58
+ - Disclose which 200 friends `find_friends_who_own` checks, and that an unknown appid reads as "nobody owns it". ([e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca))
59
+ - Disclose that `discover_games` and `get_recommended_games` return base games only. ([e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca), [4fd509b](https://github.com/Grinv/steam-games-mcp/commit/4fd509b))
60
+ - Disclose the empty-vs-private and nonexistent-appid cases the player, wishlist and review tools collapsed into one result. ([e5bd5ca](https://github.com/Grinv/steam-games-mcp/commit/e5bd5ca), [9550cc9](https://github.com/Grinv/steam-games-mcp/commit/9550cc9), [4fd509b](https://github.com/Grinv/steam-games-mcp/commit/4fd509b))
61
+ - Fix `get_owned_games`' description promising "most-played first" unconditionally, which `sort='playtime_asc'` contradicts. ([032cb22](https://github.com/Grinv/steam-games-mcp/commit/032cb22))
62
+ - Fix `discover_games` not documenting that `released_after` overrides `released_within_days`. ([9550cc9](https://github.com/Grinv/steam-games-mcp/commit/9550cc9))
63
+ - Fix `discover_games`' `min_review` claiming it applies over the returned page, not the scanned `count` window. ([4fd509b](https://github.com/Grinv/steam-games-mcp/commit/4fd509b))
64
+ - Fix PRIVACY.md omitting `get_recommended_games` from the tools backed by Steam's store-card services. ([c96d7a2](https://github.com/Grinv/steam-games-mcp/commit/c96d7a2))
65
+
9
66
  ## [0.13.1] - 2026-08-13
10
67
 
11
68
  ### Changed
package/PRIVACY.md CHANGED
@@ -30,8 +30,8 @@ The only inputs it handles are:
30
30
 
31
31
  ## Usage and third-party sharing
32
32
 
33
- Each tool call results in an outbound HTTPS request to exactly one of two
34
- Valve/Steam hosts, carrying only what that specific call needs:
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
37
  only the search term/appid(s) and the `cc`/`l` (country/language) query
@@ -40,14 +40,19 @@ Valve/Steam hosts, carrying only what that specific call needs:
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
43
+ news, global achievement rates, current player counts, the top-sellers / most-played / live-players charts, a player's wishlist
44
44
  and followed games, and the modern store-card services behind `get_items`,
45
- `discover_games` and `get_wishlist`'s detailed cards. When `STEAM_API_KEY`
45
+ `discover_games`, `get_recommended_games` and `get_wishlist`'s detailed
46
+ cards. When `STEAM_API_KEY`
46
47
  is set, it travels as a `key` query parameter on every request to this
47
48
  host, per Valve's own API convention, never as a header, never logged
48
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.
49
54
 
50
- Both hosts are operated by Valve Corporation and governed by
55
+ All three hosts are operated by Valve Corporation and governed by
51
56
  [Steam's own Privacy Policy](https://store.steampowered.com/privacy_agreement/)
52
57
  once your request reaches them. `steam-games-mcp` sends data to no other
53
58
  destination: no analytics vendor, no logging service, no server operated by
@@ -68,11 +73,14 @@ settings.
68
73
  - **Caching**: successful API responses are cached in the server process's
69
74
  own memory only (never written to disk), for a short configurable TTL
70
75
  (`CACHE_TTL_MS`, default 5 minutes) to cut latency and avoid hammering the
71
- Storefront/Web APIs. Not every endpoint is cached (e.g. reviews, batch
72
- prices and live player counts are always fetched fresh); player-specific
73
- data is never cached, with one exception: `get_player_summary`'s numeric
74
- Steam level is cached for up to `CACHE_TTL_MS`, keyed by SteamID, since
75
- it's non-sensitive and rarely changes. The cache is cleared entirely when
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
76
84
  the process exits and is never shared across machines or users.
77
85
  - **Logging**: operational logs go to stderr only (never a file, never a
78
86
  remote endpoint, and there is no MCP `logging` capability wired up), with
@@ -81,15 +89,15 @@ settings.
81
89
  plain query parameter on the wire. Log verbosity is controlled by
82
90
  `LOG_LEVEL` (default `info`); logs live only as long as your MCP client
83
91
  keeps that stderr stream around.
84
- - Beyond the cache TTL and the running process's lifetime, `steam-games-mcp`
85
- 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.
86
94
 
87
95
  ## Changes to this policy
88
96
 
89
97
  Material changes will be noted in [CHANGELOG.md](CHANGELOG.md) and reflected
90
98
  here, at the same URL, with the effective date below updated.
91
99
 
92
- _Last updated: 2026-07-30._
100
+ _Last updated: 2026-10-03._
93
101
 
94
102
  ## Contact
95
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
  ```
@@ -99,8 +100,10 @@ as `io.github.Grinv/steam-games-mcp`.
99
100
  ## Getting your credentials
100
101
 
101
102
  Store, search and discovery tools need **nothing**; skip this section if that's
102
- all you want. The **player** tools (profile, library, achievements, your wishlist)
103
- need a free API key and a public profile. Three short steps:
103
+ all you want. The **player** tools (profile, library, achievements)
104
+ need a free API key, and most also need a public profile — though `get_wishlist`
105
+ and `get_followed_games` need no key, and profile/ban lookups work on private
106
+ profiles. Three short steps:
104
107
 
105
108
  1. **Get a free Steam Web API key.** Sign in at
106
109
  <https://steamcommunity.com/dev/apikey>, enter any domain (e.g. `localhost`),
@@ -125,33 +128,34 @@ need a free API key and a public profile. Three short steps:
125
128
 
126
129
  Key: **–** no credentials · **K** Steam Web API key.
127
130
 
128
- | Tool | Key | Purpose |
129
- | ------------------------- | --- | --------------------------------------------------------------------------------------------------------------------------- |
130
- | `search_games` | – | Find games by title → appid (with price) |
131
- | `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements |
132
- | `get_items` | – | Batch store card (price, review %, **Deck/SteamOS/Machine/Frame** compat, native **platforms**, **tags**) — up to 50 appids |
133
- | `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Deck/SteamOS/Machine/Frame**, **platform**, **tags**, rating |
134
- | `get_game_reviews` | – | Review summary + recent reviews |
135
- | `get_review_histogram` | – | Review trend over time (history + recent) |
136
- | `get_prices` | – | Batch current price/discount — up to 250 appids |
137
- | `get_specials` | – | Steam front-page discounts |
138
- | `get_featured` | – | Featured sections (top sellers, new releases, …) |
139
- | `get_game_news` | – | Recent news / patch notes |
140
- | `get_global_achievements` | – | Global achievement unlock rates (rarity) — top 200 |
141
- | `get_current_players` | – | Live concurrent player count |
142
- | `get_wishlist` | – | A player's wishlist — appids, or full cards + on-sale filter with `include_details` (public profiles) |
143
- | `get_followed_games` | – | A player's followed games (Steam's "follow" feature, separate from the wishlist) — appids (public profiles) |
144
- | `get_game_achievements` | K | Achievement list (names, descriptions) + rarity — first 150, definition order |
145
- | `resolve_vanity_url` | K | Custom profile name → SteamID64 |
146
- | `get_player_summary` | K | Player public profile (incl. Steam level) |
147
- | `get_player_bans` | K | VAC/game/community/economy ban status (works even on private profiles) |
148
- | `get_owned_games` | K | A player's games + playtime (top 50 by playtime; `check_appids` reliably checks specific appids past that cap) |
149
- | `get_recently_played` | K | Games played in the last two weeks (top 50 by recent playtime) |
150
- | `get_recommended_games` | K | Personalized picks from playtime-weighted tags + review quality, excluding owned games |
151
- | `get_player_achievements` | K | A player's achievement progress in a game — achievement list capped at top 200, unlocked first |
152
- | `get_friend_list` | K | A player's friends — name, online state, current game (public friends list) |
153
- | `find_friends_who_own` | K | Which friends own given appid(s) + their playtime — each friend's FULL library, first 200 friends (`friends_checked`) |
154
- | `compare_players` | K | Games two players both own, with each one's playtime — checks each player's FULL library, not just top 50 |
131
+ | Tool | Key | Purpose |
132
+ | ------------------------- | --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
133
+ | `search_games` | – | Find games by title → appid (with price) |
134
+ | `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements |
135
+ | `get_items` | – | Batch store card (price, review %, **Deck/SteamOS/Machine/Frame** compat, native **platforms**, **tags**) — up to 50 appids |
136
+ | `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Deck/SteamOS/Machine/Frame**, **platform**, **tags**, rating |
137
+ | `get_game_reviews` | – | Review summary + recent reviews |
138
+ | `get_review_histogram` | – | Review trend over time (history + recent) |
139
+ | `get_prices` | – | Batch current price/discount — up to 250 appids |
140
+ | `get_specials` | – | Steam front-page discounts |
141
+ | `get_featured` | – | Featured sections (top sellers, new releases, …) |
142
+ | `get_game_news` | – | Recent news / patch notes |
143
+ | `get_global_achievements` | – | Global achievement unlock rates (rarity) — top 200 |
144
+ | `get_current_players` | – | Live concurrent player count |
145
+ | `get_charts` | – | What's popular now: weekly top sellers, most played, live concurrent top 100 (ranks + appids; price/reviews via `get_items`) |
146
+ | `get_wishlist` | – | A player's wishlist — appids, or full cards + on-sale filter with `include_details` (public profiles) |
147
+ | `get_followed_games` | – | A player's followed games (Steam's "follow" feature, separate from the wishlist) — appids (public profiles) |
148
+ | `get_game_achievements` | K | Achievement list (names, descriptions) + rarity — first 150, definition order |
149
+ | `resolve_vanity_url` | K | Custom profile name → SteamID64 |
150
+ | `get_player_summary` | K | Player public profile (incl. Steam level) |
151
+ | `get_player_bans` | K | VAC/game/community/economy ban status (works even on private profiles) |
152
+ | `get_owned_games` | K | A player's games + playtime (50 by playtime, `limit` widens to 300 and `sort` flips which end is kept; `check_appids` reliably checks specific appids past that) |
153
+ | `get_recently_played` | K | Games played in the last two weeks (top 50 by recent playtime) |
154
+ | `get_recommended_games` | K | Personalized picks from playtime-weighted tags + review quality, excluding owned games |
155
+ | `get_player_achievements` | K | A player's achievement progress in a game — achievement list capped at top 200, unlocked first |
156
+ | `get_friend_list` | K | A player's friends — name, online state, current game (public friends list) |
157
+ | `find_friends_who_own` | K | Which friends own given appid(s) + their playtime — each friend's FULL library, first 200 friends (`friends_checked`) |
158
+ | `compare_players` | K | Games two players both own, with each one's playtime — checks each player's FULL library, not just top 50 |
155
159
 
156
160
  **Two tiers.** Store/search + discovery tools (`store`/`api.steampowered.com`)
157
161
  need **no credentials** — including catalog-wide discovery (`discover_games`:
@@ -160,8 +164,8 @@ price/review checks (`get_items`).
160
164
  Player tools need a free
161
165
  **`STEAM_API_KEY`** and a **public** profile; they return a clear message when the
162
166
  key is unset. The two exceptions are `get_wishlist` and `get_followed_games`,
163
- marked **–** above: given a raw SteamID64 they work with no key at all (only
164
- resolving a vanity name to an ID needs one). Set **`STEAM_ID`** (a SteamID64 or vanity name) to make those tools
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
165
169
  default to you, so "my wishlist / library" works without passing an ID each time.
166
170
 
167
171
  > No third-party services: deal discovery and reviews come from Steam's own
@@ -187,7 +191,7 @@ npm run build # type-check + bundle to dist/index.js
187
191
  npm test # node:test (mocked, offline)
188
192
  npm run lint
189
193
  npm run format
190
- npm run check:api # live upstream health-check (Storefront keyless; player check needs STEAM_API_KEY)
194
+ npm run check:api # live upstream health-check (key-gated checks need STEAM_API_KEY; a public STEAM_ID verifies player fields)
191
195
  npm run inspector # run under the MCP Inspector
192
196
  ```
193
197