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 +79 -0
- package/PRIVACY.md +10 -10
- package/README.md +44 -42
- package/dist/index.js +20 -20
- package/package.json +6 -10
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
|
|
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,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
|
|
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
|
|
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**)
|
|
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
|
|
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 —
|
|
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 —
|
|
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.
|
|
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
|
-
|
|
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
|
|
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)
|
|
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
|
|
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
|