steam-games-mcp 0.2.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 ADDED
@@ -0,0 +1,55 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project are documented here. The format is based on
4
+ [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres
5
+ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
+
7
+ ## [Unreleased]
8
+
9
+ ## [0.2.0]
10
+
11
+ ### Changed
12
+
13
+ - **Renamed the package to `steam-games-mcp`** (npm `steam-mcp` is taken by an
14
+ unrelated project). The GitHub repo, npm package, `.mcpb` and config snippets
15
+ all use `steam-games-mcp`; install with `npx -y steam-games-mcp`.
16
+
17
+ ### Added
18
+
19
+ - `discover_deals` — catalog-wide deal discovery via Steam's own keyless
20
+ `IStoreQueryService/Query` (`price_filters.min_discount_percent`): find all
21
+ games at/above a discount, with discount %, price, review % and release date in
22
+ one call; optional `min_review` / `min_reviews` thresholds. No appids needed.
23
+ - `get_items` — batch store card (price/discount, review % positive, release
24
+ date) for a LIST of appids in one keyless call (`IStoreBrowseService/GetItems`).
25
+ Collapses the previous N-per-game review calls.
26
+
27
+ ### Removed
28
+
29
+ - The IsThereAnyDeal (ITAD) integration and `ITAD_API_KEY`: `get_deals`,
30
+ `get_game_info`, `get_current_prices`, `get_price_history`. Deal discovery,
31
+ batch prices and review scores are now Steam-native and keyless via
32
+ `discover_deals`, `get_items` and `get_prices`, so the third-party dependency
33
+ is gone. **Price history is no longer offered** — Steam exposes no price-history
34
+ API (only SteamDB/ITAD track it), and we chose to stay Steam-only and
35
+ dependency-free.
36
+
37
+ ## [0.1.0]
38
+
39
+ ### Added
40
+
41
+ - Initial release. Steam MCP server on the reusable carcass (`lib/`: http,
42
+ rateLimit, cache, errors, logger, result) with tsup/tsc build, `node:test`,
43
+ `.mcpb` manifest, `server.json`, live `check:api`, and GitHub Actions CI/release.
44
+ - Store/keyless tools: `search_games` (with price), `get_game` (price, genres,
45
+ platforms, Metacritic, age rating, DLC, requirements, highlighted achievements),
46
+ `get_game_reviews` (+ `review_language` / `type`), `get_review_histogram`,
47
+ `get_prices` (batch), `get_specials`, `get_featured`, `get_game_news`,
48
+ `get_global_achievements`, `get_current_players`, `get_wishlist`.
49
+ - Player tools (free `STEAM_API_KEY`): `resolve_vanity_url`, `get_player_summary`
50
+ (with `visibility`), `get_owned_games`, `get_recently_played`,
51
+ `get_player_achievements`, `get_game_achievements` (names + rarity). Private
52
+ profiles return a clear `found: false` reason; `get_player_achievements`
53
+ distinguishes a private profile from a game with no achievements.
54
+ - Region/locale aware via `STEAM_COUNTRY` / `STEAM_LANGUAGE`, with per-call
55
+ `country` / `language` overrides on the store/search/detail tools.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Grinv
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,99 @@
1
+ # steam-games-mcp
2
+
3
+ [![npm version](https://img.shields.io/npm/v/steam-games-mcp.svg)](https://www.npmjs.com/package/steam-games-mcp)
4
+ [![CI](https://github.com/Grinv/steam-games-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Grinv/steam-games-mcp/actions/workflows/ci.yml)
5
+ [![license: MIT](https://img.shields.io/npm/l/steam-games-mcp.svg)](LICENSE)
6
+
7
+ An [MCP](https://modelcontextprotocol.io) server for **Steam**: search games and
8
+ read store details, prices, reviews, discounts and news (no key), plus player
9
+ profiles, libraries and achievements via the official **Steam Web API** (free key).
10
+
11
+ Works with any MCP client (Claude Desktop/Code, Cursor, VS Code, Cline, …) over stdio.
12
+
13
+ ## Install
14
+
15
+ Add it to your MCP client's config. Store/search tools work with **no
16
+ credentials**; player tools need a free Steam Web API key.
17
+
18
+ ```json
19
+ {
20
+ "mcpServers": {
21
+ "steam": {
22
+ "command": "npx",
23
+ "args": ["-y", "steam-games-mcp"],
24
+ "env": {
25
+ "STEAM_API_KEY": "your-steam-web-api-key (optional — enables player tools)",
26
+ "STEAM_COUNTRY": "US (optional — store price region)",
27
+ "STEAM_LANGUAGE": "english (optional — store language)"
28
+ }
29
+ }
30
+ }
31
+ }
32
+ ```
33
+
34
+ > Replace each value with your own; remove the optional lines you don't need.
35
+ > A free key comes from <https://steamcommunity.com/dev/apikey>. **From source:**
36
+ > `npm ci && npm run build`, then use `"command": "node"`,
37
+ > `"args": ["/ABS/PATH/steam-games-mcp/dist/index.js"]`. **As a `.mcpb` bundle:** grab it
38
+ > from the [latest release](https://github.com/Grinv/steam-games-mcp/releases/latest).
39
+
40
+ ## What it does
41
+
42
+ Key: **–** no credentials · **K** Steam Web API key.
43
+
44
+ | Tool | Key | Purpose |
45
+ | ------------------------- | --- | ---------------------------------------------------------------------------------- |
46
+ | `search_games` | – | Find games by title → appid (with price) |
47
+ | `get_game` | – | Store details: price, genres, platforms, Metacritic, age rating, DLC, requirements |
48
+ | `get_items` | – | Batch store card (price, review %, release) for a LIST of appids — one call |
49
+ | `discover_deals` | – | Find catalog-wide discounts by min % (with review %) — no appids needed |
50
+ | `get_game_reviews` | – | Review summary + recent reviews |
51
+ | `get_review_histogram` | – | Review trend over time (history + recent) |
52
+ | `get_prices` | – | Batch current price/discount for many appids |
53
+ | `get_specials` | – | Steam front-page discounts |
54
+ | `get_featured` | – | Featured sections (top sellers, new releases, …) |
55
+ | `get_game_news` | – | Recent news / patch notes |
56
+ | `get_global_achievements` | – | Global achievement unlock rates (rarity) |
57
+ | `get_current_players` | – | Live concurrent player count |
58
+ | `get_wishlist` | – | A player's wishlist appids (public profiles) |
59
+ | `get_game_achievements` | K | Full achievement list (names, descriptions) + rarity |
60
+ | `resolve_vanity_url` | K | Custom profile name → SteamID64 |
61
+ | `get_player_summary` | K | Player public profile |
62
+ | `get_owned_games` | K | A player's games + playtime |
63
+ | `get_recently_played` | K | Games played in the last two weeks |
64
+ | `get_player_achievements` | K | A player's achievement progress in a game |
65
+
66
+ **Two tiers.** Store/search + discovery tools (`store`/`api.steampowered.com`)
67
+ need **no credentials** — including catalog-wide deal discovery (`discover_deals`)
68
+ and batch price/review checks (`get_items`). Player tools need a free
69
+ **`STEAM_API_KEY`** and a **public** profile; they return a clear message when the
70
+ key is unset.
71
+
72
+ > No third-party services: deal discovery and reviews come from Steam's own
73
+ > (keyless) store APIs. SteamDB is not used (no public API + scraping disallowed).
74
+ > Steam has no price-history API, so that isn't offered. Not affiliated with Valve.
75
+
76
+ ## Develop
77
+
78
+ ```sh
79
+ npm install
80
+ npm run build # type-check + bundle to dist/index.js
81
+ npm test # node:test (mocked, offline)
82
+ npm run lint
83
+ npm run format
84
+ npm run check:api # live upstream health-check (Storefront keyless; player check needs STEAM_API_KEY)
85
+ npm run inspector # run under the MCP Inspector
86
+ ```
87
+
88
+ Runtime requires Node ≥ 18. Contributor/agent guidance: [AGENTS.md](AGENTS.md).
89
+ Per-client config and all tunables: [docs/clients.md](docs/clients.md).
90
+
91
+ ## Updating
92
+
93
+ - **npx:** unpinned `npx -y steam-games-mcp` fetches the latest on the next run.
94
+ - **`.mcpb` bundle:** download the new bundle from the releases page and reinstall.
95
+ - **From source:** `git pull && npm ci && npm run build`.
96
+
97
+ ## License
98
+
99
+ [MIT](LICENSE) © Grinv