steam-games-mcp 0.12.1 → 0.13.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,85 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.13.0] - 2026-08-13
10
+
11
+ ### Security
12
+
13
+ - Collapse whitespace in the prompts' free-form arguments, so a multi-line value can't render as its own paragraph of agent instructions. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
14
+
15
+ ### Changed
16
+
17
+ - Halve `get_items`' appid cap to 50 and `get_prices`' to 250 — the old caps produced ~56 KB responses MCP clients reject as over their token limit. ([b9539bf](https://github.com/Grinv/steam-games-mcp/commit/b9539bf))
18
+ - Lower `get_game_achievements`' cap to 150 achievements (was 200) — its entries carry description text, making them ~3x heavier than its siblings'. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
19
+ - Cap `get_game`'s `dlc` list at 50 appids and add a `dlc_total` count. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
20
+ - Cap `get_recently_played` at 50 games, most-played first, and add a `returned` count. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
21
+ - Add a `reason` to `get_player_summary`/`get_player_bans`' `found: false` — both read private profiles fine, so it can only mean no such account. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
22
+ - Carry `available: true` on every `get_items` row, so the discriminator is present on all rows like `get_prices`'. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
23
+ - Cap `find_friends_who_own` at 200 friends looked up per call and report `friends_checked` — checking every friend of a 634-friend account ran past an MCP client's 60s request timeout. ([50efbde](https://github.com/Grinv/steam-games-mcp/commit/50efbde))
24
+ - **Breaking:** rename `get_recommended_games`' `count` parameter to `limit`, matching every other tool that caps what it returns. `discover_games` keeps `count`, which means entries to scan. ([038dca0](https://github.com/Grinv/steam-games-mcp/commit/038dca0))
25
+
26
+ ### Fixed
27
+
28
+ - Fix an unrecognized `language` (e.g. 'ru' instead of 'russian') silently making every `tags` filter match nothing instead of failing with an error. ([b9539bf](https://github.com/Grinv/steam-games-mcp/commit/b9539bf))
29
+ - Fix `discover_games`' `released_after` accepting an impossible date ('2026-13-45', '2026-02-31'), which silently disabled or shifted the cutoff. ([b9539bf](https://github.com/Grinv/steam-games-mcp/commit/b9539bf))
30
+ - Fix `get_prices` discarding every already-fetched batch when a single chunk of appids failed, instead of failing only when all of them do. ([51032f0](https://github.com/Grinv/steam-games-mcp/commit/51032f0))
31
+ - Fix `find_friends_who_own` firing one request per friend at once on a large friend list and rate-limiting itself into "unavailable" results. ([51032f0](https://github.com/Grinv/steam-games-mcp/commit/51032f0))
32
+ - Fix `get_friend_list` spending extra round-trips enriching friends it then discarded, on accounts with more than 100 friends. ([51032f0](https://github.com/Grinv/steam-games-mcp/commit/51032f0))
33
+ - Fix `what_should_i_play` re-recommending already-owned games — it now checks ownership with `check_appids` instead of the top-50 `get_owned_games` list. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
34
+ - Fix `deals_digest` accepting a `min_discount`/`min_review` outside 1-100 and rendering a `discover_games` call that then failed validation. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
35
+ - Fix the prompts' `steamid` argument accepting a vanity name and rendering it into tool calls that every tool then rejects. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
36
+ - Fix `what_should_i_play`'s documented `budget: 'free'` rendering as "drop any result priced above free" instead of a free-to-play filter. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
37
+ - Fix a `prompts/get` call with no `arguments` field at all failing validation, even though every prompt argument is optional. ([7d38e57](https://github.com/Grinv/steam-games-mcp/commit/7d38e57))
38
+ - Fix `get_game` reporting a region-blocked appid as a nonexistent one; the error now names the country and both possible causes. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
39
+ - Fix `get_featured` pricing an unreleased title at "0.00 USD" as if it were free; an absent price is `null` now. ([fef888e](https://github.com/Grinv/steam-games-mcp/commit/fef888e))
40
+ - Fix `get_player_achievements` turning a transient 5xx during its game-schema lookup into a definitive "Achievements unavailable." ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
41
+ - Fix a 403 from `get_game_achievements`' keyless achievement lookup being blamed on bad credentials. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
42
+ - Fix `get_game_achievements` not disclosing that an empty list with `total: 0` means the appid has no achievement schema — a DLC, soundtrack, tool or demo, or no such appid. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
43
+ - Fix `get_game_reviews`' `review_language` accepting an empty string, which Steam treats as its own filter rather than 'all'. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
44
+ - Fix `get_game_reviews` not disclosing that `review_language` also rescopes the summary totals to that language. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
45
+ - Fix `get_items`' `price: null` not documenting its three meanings: not sold in that country, not released yet, or no purchase option. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
46
+ - Fix `get_owned_games`' `found: false` branch still advertising the `owns` field it stopped emitting in 0.10.1. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
47
+ - Fix `search_games`' description promising a `type` of "game/dlc/…" when Steam's store search returns "app" for every result. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
48
+ - Fix `check_appids` calling itself reliable without noting that Steam omits free-to-play titles the player has never launched. ([bd98f61](https://github.com/Grinv/steam-games-mcp/commit/bd98f61))
49
+ - Fix `get_player_achievements`' `game`/`name` fields not warning they can be Valve's internal codename, unlike their `get_game_achievements` twins. ([045803e](https://github.com/Grinv/steam-games-mcp/commit/045803e))
50
+ - Fix README claiming every player-data tool needs an API key, contradicting its own table marking `get_wishlist`/`get_followed_games` keyless. ([045803e](https://github.com/Grinv/steam-games-mcp/commit/045803e))
51
+ - Fix README describing `get_game_achievements` as "top 200" — the list is in definition order, not ranked, and the cap is 150. ([045803e](https://github.com/Grinv/steam-games-mcp/commit/045803e))
52
+ - Fix `manifest.json`'s tool summaries predating `get_wishlist`'s `include_details` and contradicting `get_items`'/`get_game_achievements`' caps. ([045803e](https://github.com/Grinv/steam-games-mcp/commit/045803e))
53
+ - Fix SECURITY.md's list of what the TTL cache holds reading as exhaustive while naming three of its six entries. ([045803e](https://github.com/Grinv/steam-games-mcp/commit/045803e))
54
+
55
+ ## [0.12.2] - 2026-07-31
56
+
57
+ ### Security
58
+
59
+ - 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))
60
+ - 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))
61
+ - 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))
62
+
63
+ ### Changed
64
+
65
+ - 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))
66
+ - 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))
67
+ - 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))
68
+ - 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))
69
+ - 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))
70
+ - 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))
71
+
72
+ ### Fixed
73
+
74
+ - 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))
75
+ - 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))
76
+ - 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))
77
+ - 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))
78
+ - 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))
79
+ - 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))
80
+ - 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))
81
+ - 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))
82
+ - 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))
83
+ - 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))
84
+ - 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))
85
+ - 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))
86
+ - 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))
87
+
9
88
  ## [0.12.1] - 2026-07-30
10
89
 
11
90
  ### 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,52 +106,52 @@ 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
125
125
 
126
126
  Key: **–** no credentials · **K** Steam Web API key.
127
127
 
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**) for 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 for many 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 — top 200 |
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 |
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 — checks each friend's FULL library, not just top 50 |
154
- | `compare_players` | K | Games two players both own, with each one's playtime — checks each player's FULL library, not just top 50 |
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 |
155
155
 
156
156
  **Two tiers.** Store/search + discovery tools (`store`/`api.steampowered.com`)
157
157
  need **no credentials** — including catalog-wide discovery (`discover_games`:
@@ -159,7 +159,9 @@ deals, new releases, Deck / SteamOS / Machine / Frame compatibility, tags, ratin
159
159
  price/review checks (`get_items`).
160
160
  Player tools need a free
161
161
  **`STEAM_API_KEY`** and a **public** profile; they return a clear message when the
162
- key is unset. Set **`STEAM_ID`** (a SteamID64 or vanity name) to make those tools
162
+ 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
163
165
  default to you, so "my wishlist / library" works without passing an ID each time.
164
166
 
165
167
  > No third-party services: deal discovery and reviews come from Steam's own
@@ -168,14 +170,14 @@ default to you, so "my wishlist / library" works without passing an ID each time
168
170
 
169
171
  ## Prompts
170
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
+ Guided one-shot prompts that orchestrate several tools for a common question.
174
+ Use these when your client exposes MCP prompts, instead of describing the steps yourself:
173
175
 
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 |
176
+ | Prompt | Args | What it does |
177
+ | -------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------- |
178
+ | `what_should_i_play` | `steamid`, `budget`, `tags` (all optional) | Recommends catalog games from your library/taste, excluding what you own |
179
+ | `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 |
180
+ | `deals_digest` | `min_discount`, `min_review`, `tags` (all optional) | A curated list of well-reviewed discounted games |
179
181
 
180
182
  ## Develop
181
183
 
@@ -204,7 +206,7 @@ Per-client config and all tunables:
204
206
  ## Privacy Policy
205
207
 
206
208
  `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
209
+ its own. See [PRIVACY.md](PRIVACY.md) for exactly what it sends to Steam and
208
210
  what (if anything) it stores locally.
209
211
 
210
212
  ## License