steam-games-mcp 0.12.1 → 0.12.2

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,39 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.12.2] - 2026-07-31
10
+
11
+ ### Security
12
+
13
+ - Reject a non-digit `min_discount`/`min_review` in the `deals_digest` prompt, so it can't smuggle directives into the interpolated agent instructions. ([8ec0dc7](https://github.com/Grinv/steam-games-mcp/commit/8ec0dc7))
14
+ - Redact credentials from every tool's error message as a final backstop, so a future change can't leak the Web API key through a thrown error. ([8ec0dc7](https://github.com/Grinv/steam-games-mcp/commit/8ec0dc7))
15
+ - Stop the retry debug log from including request query strings (which can carry a player's `steamid`); log the endpoint path only. ([ff68425](https://github.com/Grinv/steam-games-mcp/commit/ff68425))
16
+
17
+ ### Changed
18
+
19
+ - Standardize the keyless-tool disclosure to one phrasing ("No API key required.") across six Web API tools, replacing five inconsistent phrasings. ([61c7ae7](https://github.com/Grinv/steam-games-mcp/commit/61c7ae7))
20
+ - Remove the inert `allowScripts` field from `package.json` (a pnpm-only feature, no-op under npm) that implied protection it never gave. ([ff68425](https://github.com/Grinv/steam-games-mcp/commit/ff68425))
21
+ - Disclose that `get_recommended_games`'s `min_discount` is re-checked client-side, matching `discover_games`. ([dbde08d](https://github.com/Grinv/steam-games-mcp/commit/dbde08d))
22
+ - Note in `get_wishlist`/`get_followed_games` that `resolve_vanity_url` needs `STEAM_API_KEY`, even though both tools are otherwise keyless. ([dbde08d](https://github.com/Grinv/steam-games-mcp/commit/dbde08d))
23
+ - Name `get_recommended_games`'s fixed scan sizes (30 played games sampled, 300-entry pool) instead of a vague "fixed-size scan". ([86a459d](https://github.com/Grinv/steam-games-mcp/commit/86a459d))
24
+ - Disclose `get_recommended_games`'s second `found:false` case: too few played games with resolvable tags. ([86a459d](https://github.com/Grinv/steam-games-mcp/commit/86a459d))
25
+
26
+ ### Fixed
27
+
28
+ - Fix `discover_games`/`get_recommended_games` returning the full catalog at `min_discount: 100` (Steam's filter no-ops there); backstop it client-side. ([ff68425](https://github.com/Grinv/steam-games-mcp/commit/ff68425))
29
+ - Fix `get_global_achievements`/`get_game_achievements` throwing on a non-numeric upstream percent instead of falling back to a safe default. ([8ec0dc7](https://github.com/Grinv/steam-games-mcp/commit/8ec0dc7))
30
+ - Fix `get_player_bans`'s `days_since_last_ban` reporting `0` ("banned today") for a never-banned player, instead of `null`. ([ff68425](https://github.com/Grinv/steam-games-mcp/commit/ff68425))
31
+ - Fix `discover_games`'s `min_review: 0` excluding games that carry no review summary yet, instead of treating 0 as "no minimum". ([ff68425](https://github.com/Grinv/steam-games-mcp/commit/ff68425))
32
+ - Fix `get_game_reviews`'s `positive_pct` reporting `null` instead of `0` for an all-negative game, no longer conflating 0% positive with no data. ([b97a91a](https://github.com/Grinv/steam-games-mcp/commit/b97a91a))
33
+ - Fix `get_game` emitting duplicate `genres`/`categories` entries that Steam repeats in its store payload. ([ff68425](https://github.com/Grinv/steam-games-mcp/commit/ff68425))
34
+ - Fix `steamid`/`other_steamid` failing on a value with stray whitespace instead of trimming it first, matching `vanity`/`STEAM_ID`. ([b97a91a](https://github.com/Grinv/steam-games-mcp/commit/b97a91a))
35
+ - Fix a 17-digit `steamid`/`other_steamid` below the individual-account base (e.g. all zeros) being sent upstream instead of rejected up front. ([b97a91a](https://github.com/Grinv/steam-games-mcp/commit/b97a91a))
36
+ - Fix `get_game_achievements`'s `game` field not warning it may be Valve's internal codename (e.g. 'Fiber' for Persona 5 Royal), not the store title. ([b97a91a](https://github.com/Grinv/steam-games-mcp/commit/b97a91a))
37
+ - Fix `get_wishlist` not disclosing that its platform/Deck/OS/Machine/Frame filters also imply `include_details`, same as country/language. ([61c7ae7](https://github.com/Grinv/steam-games-mcp/commit/61c7ae7))
38
+ - Fix `get_game`'s description missing its highlighted-achievements sample (`achievements_highlighted`) from the category list. ([61c7ae7](https://github.com/Grinv/steam-games-mcp/commit/61c7ae7))
39
+ - Fix `search_games`'s description omitting that it also returns `store_url` and `type` in its output. ([ff68425](https://github.com/Grinv/steam-games-mcp/commit/ff68425))
40
+ - Fix `search_games` not disclosing it returns only Steam's first page of matches (~10, no pagination), so `total` isn't the full match count. ([86a459d](https://github.com/Grinv/steam-games-mcp/commit/86a459d))
41
+
9
42
  ## [0.12.1] - 2026-07-30
10
43
 
11
44
  ### Changed
package/PRIVACY.md CHANGED
@@ -3,7 +3,7 @@
3
3
  `steam-games-mcp` is a local [Model Context Protocol](https://modelcontextprotocol.io)
4
4
  server: it runs as a process on your own machine (via `npx` or a local clone),
5
5
  speaking stdio to your MCP client (Claude Desktop, Claude Code, etc.). It has
6
- no server component of its own, no telemetry, and no analytics — this policy
6
+ no server component of its own, no telemetry, and no analytics. This policy
7
7
  covers exactly what it does with data, in full, because there isn't more to
8
8
  say beyond it.
9
9
 
@@ -17,9 +17,9 @@ The only inputs it handles are:
17
17
 
18
18
  - **Credentials/preferences you supply**, via environment variables in your
19
19
  MCP client's own config (e.g. `claude_desktop_config.json`):
20
- `STEAM_API_KEY` (optional — a free key from
20
+ `STEAM_API_KEY` (optional, a free key from
21
21
  [steamcommunity.com/dev/apikey](https://steamcommunity.com/dev/apikey) that
22
- unlocks the player-data tools), `STEAM_ID` (optional — your own SteamID64 or
22
+ unlocks the player-data tools), `STEAM_ID` (optional, your own SteamID64 or
23
23
  vanity name, so player tools can default to you), and non-secret store
24
24
  preferences `STEAM_COUNTRY`/`STEAM_LANGUAGE`. These stay in your client's
25
25
  local config file; `steam-games-mcp` never transmits them anywhere except
@@ -33,24 +33,24 @@ The only inputs it handles are:
33
33
  Each tool call results in an outbound HTTPS request to exactly one of two
34
34
  Valve/Steam hosts, carrying only what that specific call needs:
35
35
 
36
- - **Steam Storefront API** (`store.steampowered.com`) — needs no key. Carries
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
38
38
  parameters. Backs the classic store tools (`search_games`, `get_game`,
39
39
  `get_game_reviews`, `get_review_histogram`, `get_prices`, `get_specials`,
40
40
  `get_featured`).
41
- - **Steam Web API** (`api.steampowered.com`) — used for player data
41
+ - **Steam Web API** (`api.steampowered.com`), used for player data
42
42
  (profiles, libraries, achievements, friends) and several keyless endpoints:
43
43
  news, global achievement rates, current player counts, a player's wishlist
44
44
  and followed games, and the modern store-card services behind `get_items`,
45
45
  `discover_games` and `get_wishlist`'s detailed cards. When `STEAM_API_KEY`
46
46
  is set, it travels as a `key` query parameter on every request to this
47
- host, per Valve's own API convention — never as a header, never logged
47
+ host, per Valve's own API convention, never as a header, never logged
48
48
  (see Storage and retention below).
49
49
 
50
50
  Both hosts are operated by Valve Corporation and governed by
51
51
  [Steam's own Privacy Policy](https://store.steampowered.com/privacy_agreement/)
52
52
  once your request reaches them. `steam-games-mcp` sends data to no other
53
- destination — no analytics vendor, no logging service, no server operated by
53
+ destination: no analytics vendor, no logging service, no server operated by
54
54
  its maintainer.
55
55
 
56
56
  **Public-profile caveat:** several player tools (`get_wishlist`,
@@ -58,7 +58,7 @@ its maintainer.
58
58
  `get_recently_played`, `get_player_achievements`, `find_friends_who_own`,
59
59
  `compare_players`, `get_recommended_games`) only return data for a Steam
60
60
  profile whose relevant visibility setting (profile / game details / friends
61
- list) is set to **Public** — this is enforced by Steam itself, not by this
61
+ list) is set to **Public**. This is enforced by Steam itself, not by this
62
62
  server. A private profile makes the tool report a clear "private" reason
63
63
  instead of the requested data; it never bypasses Steam's own privacy
64
64
  settings.
@@ -70,13 +70,13 @@ settings.
70
70
  (`CACHE_TTL_MS`, default 5 minutes) to cut latency and avoid hammering the
71
71
  Storefront/Web APIs. Not every endpoint is cached (e.g. reviews, batch
72
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
73
+ data is never cached, with one exception: `get_player_summary`'s numeric
74
74
  Steam level is cached for up to `CACHE_TTL_MS`, keyed by SteamID, since
75
75
  it's non-sensitive and rarely changes. The cache is cleared entirely when
76
76
  the process exits and is never shared across machines or users.
77
77
  - **Logging**: operational logs go to stderr only (never a file, never a
78
78
  remote endpoint, and there is no MCP `logging` capability wired up), with
79
- credentials redacted before anything is written — `STEAM_API_KEY` is
79
+ credentials redacted before anything is written: `STEAM_API_KEY` is
80
80
  stripped from any logged URL or error message even though it travels as a
81
81
  plain query parameter on the wire. Log verbosity is controlled by
82
82
  `LOG_LEVEL` (default `info`); logs live only as long as your MCP client
package/README.md CHANGED
@@ -31,7 +31,7 @@ Once it's connected, just ask your agent in natural language.
31
31
  "Which recent, well-reviewed games run on Steam Deck?"
32
32
  "What well-reviewed games run on SteamOS?"
33
33
  "Any games verified for the Steam Machine on sale?"
34
- "Any Steam Frame–Verified VR games on sale?"
34
+ "Any Steam Frame-Verified VR games on sale?"
35
35
  "What's discounted on Steam's front page right now?"
36
36
  "Show me Steam's top sellers and newest releases."
37
37
  "Any recent patch notes for No Man's Sky?"
@@ -90,7 +90,7 @@ credentials**; player tools need a free Steam Web API key.
90
90
  ### One-click install (Claude Desktop)
91
91
 
92
92
  Download [**`steam-games-mcp.mcpb`**](https://github.com/Grinv/steam-games-mcp/releases/latest/download/steam-games-mcp.mcpb)
93
- (always the latest release) and open it in Claude Desktop — **Settings → Extensions** — then
93
+ (always the latest release) and open it in Claude Desktop (**Settings → Extensions**), then
94
94
  fill the optional fields (API key, Steam ID, country, language) in the install form. No JSON editing.
95
95
 
96
96
  Also listed in the [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.Grinv/steam-games-mcp&version=latest)
@@ -98,7 +98,7 @@ as `io.github.Grinv/steam-games-mcp`.
98
98
 
99
99
  ## Getting your credentials
100
100
 
101
- Store, search and discovery tools need **nothing** — skip this section if that's
101
+ Store, search and discovery tools need **nothing**; skip this section if that's
102
102
  all you want. The **player** tools (profile, library, achievements, your wishlist)
103
103
  need a free API key and a public profile. Three short steps:
104
104
 
@@ -106,19 +106,19 @@ need a free API key and a public profile. Three short steps:
106
106
  <https://steamcommunity.com/dev/apikey>, enter any domain (e.g. `localhost`),
107
107
  and copy the key into `STEAM_API_KEY`.
108
108
  2. **Find your Steam ID.** Set `STEAM_ID` to either:
109
- - your **vanity name** — the custom part of your profile URL
109
+ - your **vanity name**: the custom part of your profile URL
110
110
  `steamcommunity.com/id/YOUR_NAME` → `YOUR_NAME` (resolved automatically), or
111
111
  - your **17-digit SteamID64** (`steamcommunity.com/profiles/7656…`; or look it
112
112
  up at <https://steamid.io>).
113
113
 
114
- With `STEAM_ID` set you can just ask "_my_ wishlist / library" — without it,
114
+ With `STEAM_ID` set you can just ask "_my_ wishlist / library"; without it,
115
115
  give the agent a SteamID64 each time (use `resolve_vanity_url` to convert a name).
116
116
 
117
117
  3. **Make your profile public** (for your own library/achievements): Steam →
118
118
  profile → **Edit Profile** → **Privacy Settings** → set **My profile** and
119
119
  **Game details** to **Public**.
120
120
 
121
- > The key and Steam ID go in your MCP client config (the `env` block above) — see
121
+ > The key and Steam ID go in your MCP client config (the `env` block above). See
122
122
  > [docs/clients.md](https://github.com/Grinv/steam-games-mcp/blob/main/docs/clients.md) for per-client examples. Never commit them.
123
123
 
124
124
  ## Tools
@@ -168,14 +168,14 @@ default to you, so "my wishlist / library" works without passing an ID each time
168
168
 
169
169
  ## Prompts
170
170
 
171
- Guided one-shot prompts that orchestrate several tools for a common question —
172
- use these when your client exposes MCP prompts, instead of describing the steps yourself:
171
+ Guided one-shot prompts that orchestrate several tools for a common question.
172
+ Use these when your client exposes MCP prompts, instead of describing the steps yourself:
173
173
 
174
- | Prompt | Args | What it does |
175
- | -------------------- | ------------------------------------------------------------------ | -------------------------------------------------------------------------- |
176
- | `what_should_i_play` | `steamid`, `budget`, `tags` (all optional) | Recommends catalog games from your library/taste, excluding what you own |
177
- | `is_it_worth_buying` | `game` (title or appid, optional — autocompletes; asks if omitted) | Price, review trend and Steam Deck compatibility → a buy/wait/skip verdict |
178
- | `deals_digest` | `min_discount`, `min_review`, `tags` (all optional) | A curated list of well-reviewed discounted games |
174
+ | Prompt | Args | What it does |
175
+ | -------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------- |
176
+ | `what_should_i_play` | `steamid`, `budget`, `tags` (all optional) | Recommends catalog games from your library/taste, excluding what you own |
177
+ | `is_it_worth_buying` | `game` (title or appid, optional, autocompletes; asks if omitted) | Price, review trend and Steam Deck compatibility → a buy/wait/skip verdict |
178
+ | `deals_digest` | `min_discount`, `min_review`, `tags` (all optional) | A curated list of well-reviewed discounted games |
179
179
 
180
180
  ## Develop
181
181
 
@@ -204,7 +204,7 @@ Per-client config and all tunables:
204
204
  ## Privacy Policy
205
205
 
206
206
  `steam-games-mcp` runs entirely on your own machine and collects no data of
207
- its own — see [PRIVACY.md](PRIVACY.md) for exactly what it sends to Steam and
207
+ its own. See [PRIVACY.md](PRIVACY.md) for exactly what it sends to Steam and
208
208
  what (if anything) it stores locally.
209
209
 
210
210
  ## License