steam-games-mcp 0.10.5 → 0.12.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,8 +6,55 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.12.0] - 2026-07-30
10
+
11
+ ### Added
12
+
13
+ - Add a privacy policy (`PRIVACY.md`) covering data handling and caching, linked from README and manifest.json's `privacy_policies`. ([91ee519](https://github.com/Grinv/steam-games-mcp/commit/91ee519))
14
+ - Add an original gamepad icon, in Steam's own color gradient, for the MCPB/Connectors Directory submission. ([f18dc23](https://github.com/Grinv/steam-games-mcp/commit/f18dc23), [3b5d8d0](https://github.com/Grinv/steam-games-mcp/commit/3b5d8d0), [081001f](https://github.com/Grinv/steam-games-mcp/commit/081001f), [4409607](https://github.com/Grinv/steam-games-mcp/commit/4409607))
15
+
16
+ ### Changed
17
+
18
+ - Raise runtime floor to Node ≥ 20.11 (was ≥ 20).
19
+
20
+ ### Fixed
21
+
22
+ - Fix a 403 from a keyless Web API tool being blamed on bad credentials whenever `STEAM_API_KEY` is configured, even though it doesn't need one. ([839649d](https://github.com/Grinv/steam-games-mcp/commit/839649d), [09df3cd](https://github.com/Grinv/steam-games-mcp/commit/09df3cd))
23
+ - Fix `find_friends_who_own`'s description wrongly crediting its FULL-library comparison to `get_friend_list` instead of `get_owned_games`. ([fc003b5](https://github.com/Grinv/steam-games-mcp/commit/fc003b5))
24
+ - Fix `discover_games`/`get_wishlist`'s `tags` and `get_recommended_games`'s `exclude_tags` not disclosing that a misspelled/unrecognized tag name isn't an error — it just silently matches (or drops) nothing. ([fc003b5](https://github.com/Grinv/steam-games-mcp/commit/fc003b5))
25
+ - Fix `discover_games`'s and `get_recommended_games`'s `count` fields not stating their own max (200 and 25). ([fc003b5](https://github.com/Grinv/steam-games-mcp/commit/fc003b5))
26
+ - Fix `get_friend_list` leaking a raw 404 error for a syntactically valid but nonexistent SteamID64, instead of the graceful `found:false` every sibling tool already gives the exact same id. ([cd67c0f](https://github.com/Grinv/steam-games-mcp/commit/cd67c0f))
27
+ - Fix `is_it_worth_buying`, `what_should_i_play` and `deals_digest` not trimming whitespace-only optional arguments, defeating their blank-value fallbacks and defaults. ([e4d1160](https://github.com/Grinv/steam-games-mcp/commit/e4d1160))
28
+ - Fix `compare_players` sinking the whole call with a generic error when just one player's own library lookup hit a transient error (rate-limited/network/5xx) — the message now names which player's lookup actually failed. ([2cc0452](https://github.com/Grinv/steam-games-mcp/commit/2cc0452))
29
+ - Fix the shipped `.mcpb` bundle including dev-only files (skill docs tripled via symlinks, contributor-only docs, tooling configs) instead of just the ~9 files actually needed at runtime. ([49a9959](https://github.com/Grinv/steam-games-mcp/commit/49a9959))
30
+ - Fix README's links to dev/contributor docs excluded from the bundle (`docs/`, `AGENTS.md`, `SECURITY.md`) breaking when read from an installed extension instead of GitHub. ([37154c9](https://github.com/Grinv/steam-games-mcp/commit/37154c9))
31
+ - Fix `PRIVACY.md`/`SECURITY.md` claiming player-specific data is never cached (missing the `get_player_summary` Steam-level exception) and miscrediting cached data to `get_game_reviews` instead of the review histogram. ([93924d9](https://github.com/Grinv/steam-games-mcp/commit/93924d9))
32
+
33
+ ## [0.11.0] - 2026-07-29
34
+
35
+ ### Added
36
+
37
+ - Advertise a 1-hour, publicly-shareable cache hint (protocol revision 2026-07-28's `cacheHints`) for `tools/list`/`prompts/list`/`server/discover`, since the tool and prompt list never changes for the life of the process — lets a modern-era client skip re-fetching them on every reconnect. No effect on 2025-era clients.
38
+
39
+ ### Changed
40
+
41
+ - Bump the MCP TypeScript SDK (`@modelcontextprotocol/{server,client,core,codemod}`) from `2.0.0-beta.5` to the `2.0.0` stable release.
42
+ - Advertise `get_player_summary`/`get_friend_list`'s `state` field as an enum of its 7 possible values in the output schema, instead of an open string. ([47989fc](https://github.com/Grinv/steam-games-mcp/commit/47989fc))
43
+ - Advertise each schema field's default value (e.g. `get_game_reviews`'s `limit`, `discover_games`'s `count`/`start`) directly in its inputSchema instead of only in prose. ([e86eb29](https://github.com/Grinv/steam-games-mcp/commit/e86eb29))
44
+
45
+ ### Fixed
46
+
47
+ - Fix every tool silently dropping an unrecognized parameter name and running with defaults instead of rejecting it — every tool's input schema is now `.strict()`. ([e86eb29](https://github.com/Grinv/steam-games-mcp/commit/e86eb29))
48
+ - Fix `resolve_vanity_url`/`STEAM_ID` silently resolving to "not found" instead of the intended profile when the vanity name/SteamID carries stray whitespace (Steam's vanity lookup is an exact match). ([e86eb29](https://github.com/Grinv/steam-games-mcp/commit/e86eb29))
49
+ - Fix a padded per-call `country`/`language` override (e.g. `country: " RU "`) failing validation outright instead of being accepted like the trimmed value. ([61fe40a](https://github.com/Grinv/steam-games-mcp/commit/61fe40a))
50
+ - Fix `compare_players`/`find_friends_who_own` silently missing a played free-to-play game (e.g. Path of Exile, Warframe) instead of reporting it as owned/shared. ([465b302](https://github.com/Grinv/steam-games-mcp/commit/465b302))
51
+ - Fix HTTP 420 responses from Steam (observed live under rate limiting) being classified as a generic non-retryable error instead of the same retryable rate limit as HTTP 429. ([63e7893](https://github.com/Grinv/steam-games-mcp/commit/63e7893))
52
+ - Fix `get_recently_played` reporting `found:false` ("profile is private") for a public profile that simply hasn't played anything in the last 2 weeks. ([80dc459](https://github.com/Grinv/steam-games-mcp/commit/80dc459), fixes [#2](https://github.com/Grinv/steam-games-mcp/issues/2))
53
+
9
54
  ## [0.10.5] - 2026-07-28
10
55
 
56
+ Everything below is one commit: [37cafb8](https://github.com/Grinv/steam-games-mcp/commit/37cafb8).
57
+
11
58
  ### Fixed
12
59
 
13
60
  - Fix `get_followed_games` (200-item cap), `get_wishlist`'s light default list (100-item cap), `compare_players` (top-50 cap on returned shared games) and `get_review_histogram` (24/30-entry caps) descriptions not disclosing their own fixed output caps.
@@ -27,13 +74,15 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
27
74
 
28
75
  ### Fixed
29
76
 
30
- - Fix `find_friends_who_own` failing entirely when just one friend's own library lookup hit a transient error (rate-limited/network/5xx) — that friend now lands in a new `unavailable_friends` list (with a sanitized reason) instead of sinking every other friend's results.
31
- - Fix `get_friend_list`/`find_friends_who_own` failing entirely when just one `GetPlayerSummaries` chunk (friend lists over 100) hit a transient error — the other chunks' names still come through.
32
- - Fix every tool's 401/403 error message blaming (or hedging about) "the credentials" even once the client already knows none were sent for that request — the message is now precise instead of guessing.
33
- - Fix `get_game_achievements`, `get_global_achievements` and `get_player_achievements` returning a huge achievement list (e.g. PAYDAY 2's 1,328) uncapped, blowing past the response size limit — each is now capped at 200 like their sibling tools.
77
+ - Fix `find_friends_who_own` failing entirely when just one friend's own library lookup hit a transient error (rate-limited/network/5xx) — that friend now lands in a new `unavailable_friends` list (with a sanitized reason) instead of sinking every other friend's results. ([6caa333](https://github.com/Grinv/steam-games-mcp/commit/6caa333))
78
+ - Fix `get_friend_list`/`find_friends_who_own` failing entirely when just one `GetPlayerSummaries` chunk (friend lists over 100) hit a transient error — the other chunks' names still come through. ([18df4ea](https://github.com/Grinv/steam-games-mcp/commit/18df4ea))
79
+ - Fix every tool's 401/403 error message blaming (or hedging about) "the credentials" even once the client already knows none were sent for that request — the message is now precise instead of guessing. ([c3a4ea7](https://github.com/Grinv/steam-games-mcp/commit/c3a4ea7), [18df4ea](https://github.com/Grinv/steam-games-mcp/commit/18df4ea))
80
+ - Fix `get_game_achievements`, `get_global_achievements` and `get_player_achievements` returning a huge achievement list (e.g. PAYDAY 2's 1,328) uncapped, blowing past the response size limit — each is now capped at 200 like their sibling tools. ([66595d9](https://github.com/Grinv/steam-games-mcp/commit/66595d9))
34
81
 
35
82
  ## [0.10.2] - 2026-07-22
36
83
 
84
+ Everything below is one commit: [6ead972](https://github.com/Grinv/steam-games-mcp/commit/6ead972).
85
+
37
86
  ### Fixed
38
87
 
39
88
  - Fix `get_owned_games`, `get_recently_played`, `get_recommended_games`, `compare_players`, `get_friend_list`, `find_friends_who_own`, `get_wishlist` and `get_followed_games` leaking a raw upstream HTML error instead of a clean `found:false` for a handful of malformed/out-of-range SteamID64s (e.g. accountid 0) that Steam itself answers with a raw HTTP 400 for.
@@ -42,19 +91,19 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
42
91
 
43
92
  ### Fixed
44
93
 
45
- - Fix `get_specials`/`get_featured` listing the same game twice within a section.
46
- - Fix `get_game`/`get_current_players` hiding the invalid appid behind a generic "not found" message.
47
- - Fix `get_current_players` treating Steam's 404 response for an unknown appid as a transport error instead of a clean not-found.
48
- - Fix `get_owned_games`'s `check_appids` reporting a private profile's games as `owned:false` instead of unknown.
94
+ - Fix `get_specials`/`get_featured` listing the same game twice within a section. ([877ff59](https://github.com/Grinv/steam-games-mcp/commit/877ff59))
95
+ - Fix `get_game`/`get_current_players` hiding the invalid appid behind a generic "not found" message. ([877ff59](https://github.com/Grinv/steam-games-mcp/commit/877ff59))
96
+ - Fix `get_current_players` treating Steam's 404 response for an unknown appid as a transport error instead of a clean not-found. ([877ff59](https://github.com/Grinv/steam-games-mcp/commit/877ff59))
97
+ - Fix `get_owned_games`'s `check_appids` reporting a private profile's games as `owned:false` instead of unknown. ([877ff59](https://github.com/Grinv/steam-games-mcp/commit/877ff59))
49
98
 
50
99
  ### Changed
51
100
 
52
- - Clarify `discover_games`'s `total_matching`, `get_wishlist`'s count fields, `get_recommended_games`'s `match_score`, and `get_review_histogram`'s `rollup_type` — each was easy to misread.
53
- - Correct `discover_games`'s claim that only `min_discount` filters server-side.
54
- - Correct `get_player_summary`/`get_recently_played`/`get_player_achievements`'s stated privacy requirements.
55
- - Document `get_recommended_games`'s empty-library case and `get_friend_list`'s 100-friend cap.
56
- - Cross-reference `get_game_reviews`/`get_review_histogram` and disclose `get_game_reviews`'s review-text truncation.
57
- - Fix the `what_should_i_play` prompt instructing a non-existent `discover_games` budget filter.
101
+ - Clarify `discover_games`'s `total_matching`, `get_wishlist`'s count fields, `get_recommended_games`'s `match_score`, and `get_review_histogram`'s `rollup_type` — each was easy to misread. ([0521ffb](https://github.com/Grinv/steam-games-mcp/commit/0521ffb))
102
+ - Correct `discover_games`'s claim that only `min_discount` filters server-side. ([0521ffb](https://github.com/Grinv/steam-games-mcp/commit/0521ffb))
103
+ - Correct `get_player_summary`/`get_recently_played`/`get_player_achievements`'s stated privacy requirements. ([0521ffb](https://github.com/Grinv/steam-games-mcp/commit/0521ffb))
104
+ - Document `get_recommended_games`'s empty-library case and `get_friend_list`'s 100-friend cap. ([0521ffb](https://github.com/Grinv/steam-games-mcp/commit/0521ffb))
105
+ - Cross-reference `get_game_reviews`/`get_review_histogram` and disclose `get_game_reviews`'s review-text truncation. ([0521ffb](https://github.com/Grinv/steam-games-mcp/commit/0521ffb))
106
+ - Fix the `what_should_i_play` prompt instructing a non-existent `discover_games` budget filter. ([0521ffb](https://github.com/Grinv/steam-games-mcp/commit/0521ffb))
58
107
 
59
108
  ## [0.10.0] - 2026-07-21
60
109
 
@@ -82,6 +131,8 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
82
131
 
83
132
  ## [0.9.0] - 2026-07-18
84
133
 
134
+ Everything below is one commit: [99d56dc](https://github.com/Grinv/steam-games-mcp/commit/99d56dc).
135
+
85
136
  ### Added
86
137
 
87
138
  - Add `get_recommended_games` — personalized picks derived from the player's own playtime-weighted tag preferences, ranked with a review-quality discount, and `exclude_tags`/`min_discount` options, excluding owned games.
package/PRIVACY.md ADDED
@@ -0,0 +1,99 @@
1
+ # Privacy Policy
2
+
3
+ `steam-games-mcp` is a local [Model Context Protocol](https://modelcontextprotocol.io)
4
+ server: it runs as a process on your own machine (via `npx` or a local clone),
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
7
+ covers exactly what it does with data, in full, because there isn't more to
8
+ say beyond it.
9
+
10
+ ## Data collection
11
+
12
+ `steam-games-mcp` collects no data of its own. It has no database, no
13
+ accounts, and sends nothing to its maintainer or to any analytics/telemetry
14
+ service.
15
+
16
+ The only inputs it handles are:
17
+
18
+ - **Credentials/preferences you supply**, via environment variables in your
19
+ MCP client's own config (e.g. `claude_desktop_config.json`):
20
+ `STEAM_API_KEY` (optional — a free key from
21
+ [steamcommunity.com/dev/apikey](https://steamcommunity.com/dev/apikey) that
22
+ unlocks the player-data tools), `STEAM_ID` (optional — your own SteamID64 or
23
+ vanity name, so player tools can default to you), and non-secret store
24
+ preferences `STEAM_COUNTRY`/`STEAM_LANGUAGE`. These stay in your client's
25
+ local config file; `steam-games-mcp` never transmits them anywhere except
26
+ as described below.
27
+ - **Tool call arguments**, generated by the AI model you're using (e.g. a
28
+ game title or appid, a SteamID64, a vanity profile name) as it calls one of
29
+ this server's tools on your behalf.
30
+
31
+ ## Usage and third-party sharing
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:
35
+
36
+ - **Steam Storefront API** (`store.steampowered.com`) — needs no key. Carries
37
+ only the search term/appid(s) and the `cc`/`l` (country/language) query
38
+ parameters. Backs the classic store tools (`search_games`, `get_game`,
39
+ `get_game_reviews`, `get_review_histogram`, `get_prices`, `get_specials`,
40
+ `get_featured`).
41
+ - **Steam Web API** (`api.steampowered.com`) — used for player data
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 `get_items`,
45
+ `discover_games` and `get_wishlist`'s detailed cards. When `STEAM_API_KEY`
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
48
+ (see Storage and retention below).
49
+
50
+ Both hosts are operated by Valve Corporation and governed by
51
+ [Steam's own Privacy Policy](https://store.steampowered.com/privacy_agreement/)
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
54
+ its maintainer.
55
+
56
+ **Public-profile caveat:** several player tools (`get_wishlist`,
57
+ `get_followed_games`, `get_friend_list`, `get_owned_games`,
58
+ `get_recently_played`, `get_player_achievements`, `find_friends_who_own`,
59
+ `compare_players`, `get_recommended_games`) only return data for a Steam
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
62
+ server. A private profile makes the tool report a clear "private" reason
63
+ instead of the requested data; it never bypasses Steam's own privacy
64
+ settings.
65
+
66
+ ## Storage and retention
67
+
68
+ - **Caching**: successful API responses are cached in the server process's
69
+ own memory only (never written to disk), for a short configurable TTL
70
+ (`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
+ the process exits and is never shared across machines or users.
77
+ - **Logging**: operational logs go to stderr only (never a file, never a
78
+ remote endpoint, and there is no MCP `logging` capability wired up), with
79
+ credentials redacted before anything is written — `STEAM_API_KEY` is
80
+ stripped from any logged URL or error message even though it travels as a
81
+ plain query parameter on the wire. Log verbosity is controlled by
82
+ `LOG_LEVEL` (default `info`); logs live only as long as your MCP client
83
+ 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.
86
+
87
+ ## Changes to this policy
88
+
89
+ Material changes will be noted in [CHANGELOG.md](CHANGELOG.md) and reflected
90
+ here, at the same URL, with the effective date below updated.
91
+
92
+ _Last updated: 2026-07-30._
93
+
94
+ ## Contact
95
+
96
+ Questions about this policy or `steam-games-mcp`'s data handling:
97
+ [open a GitHub issue](https://github.com/Grinv/steam-games-mcp/issues) or
98
+ email
99
+ [4070730+Grinv@users.noreply.github.com](mailto:4070730+Grinv@users.noreply.github.com).
package/README.md CHANGED
@@ -11,6 +11,7 @@ read store details, prices, reviews, discounts and news (no key), plus player
11
11
  profiles, libraries and achievements via the official **Steam Web API** (free key).
12
12
 
13
13
  **Read-only · official Steam APIs only · most tools need no key · open source.**
14
+
14
15
  Nobody logs in; the only credential is a free Steam Web API key you set yourself,
15
16
  and the server never writes, trades, posts, launches games, or makes purchases.
16
17
 
@@ -118,7 +119,7 @@ need a free API key and a public profile. Three short steps:
118
119
  **Game details** to **Public**.
119
120
 
120
121
  > The key and Steam ID go in your MCP client config (the `env` block above) — see
121
- > [docs/clients.md](docs/clients.md) for per-client examples. Never commit them.
122
+ > [docs/clients.md](https://github.com/Grinv/steam-games-mcp/blob/main/docs/clients.md) for per-client examples. Never commit them.
122
123
 
123
124
  ## Tools
124
125
 
@@ -188,9 +189,11 @@ npm run check:api # live upstream health-check (Storefront keyless; player ch
188
189
  npm run inspector # run under the MCP Inspector
189
190
  ```
190
191
 
191
- Runtime requires Node ≥ 20. Contributor/agent guidance: [AGENTS.md](AGENTS.md).
192
- Security policy: [SECURITY.md](SECURITY.md).
193
- Per-client config and all tunables: [docs/clients.md](docs/clients.md).
192
+ Runtime requires Node ≥ 20.11. Contributor/agent guidance:
193
+ [AGENTS.md](https://github.com/Grinv/steam-games-mcp/blob/main/AGENTS.md).
194
+ Security policy: [SECURITY.md](https://github.com/Grinv/steam-games-mcp/blob/main/SECURITY.md).
195
+ Per-client config and all tunables:
196
+ [docs/clients.md](https://github.com/Grinv/steam-games-mcp/blob/main/docs/clients.md).
194
197
 
195
198
  ## Updating
196
199
 
@@ -198,6 +201,12 @@ Per-client config and all tunables: [docs/clients.md](docs/clients.md).
198
201
  - **`.mcpb` bundle:** download the new bundle from the releases page and reinstall.
199
202
  - **From source:** `git pull && npm ci && npm run build`.
200
203
 
204
+ ## Privacy Policy
205
+
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
208
+ what (if anything) it stores locally.
209
+
201
210
  ## License
202
211
 
203
212
  [MIT](LICENSE) © Grinv