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 +33 -0
- package/PRIVACY.md +10 -10
- package/README.md +14 -14
- package/dist/index.js +13 -13
- package/package.json +1 -5
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
|
|
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
|
|
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
|
|
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`)
|
|
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`)
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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"
|
|
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)
|
|
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
|
-
|
|
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
|
|
175
|
-
| -------------------- |
|
|
176
|
-
| `what_should_i_play` | `steamid`, `budget`, `tags` (all optional)
|
|
177
|
-
| `is_it_worth_buying` | `game` (title or appid, optional
|
|
178
|
-
| `deals_digest` | `min_discount`, `min_review`, `tags` (all optional)
|
|
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
|
|
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
|