Skip to content

Commit eb9a281

Browse files
committed
feat: add 5 new MCP tools from steam-mcp v0.6.0 (25 total)
New tools: steam_getNewsForApp, steam_getSchemaForGame, steam_getPlayerAchievements, steam_getLeaderboardsForGame, steam_clearAchievement. Updated tool counts, tables, skill references, and rules across 12 files. Made-with: Cursor
1 parent 2de8972 commit eb9a281

12 files changed

Lines changed: 67 additions & 24 deletions

File tree

CHANGELOG.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10+
### Added
11+
12+
- **5 new MCP tools** in companion Steam MCP server (v0.6.0), reaching 25 total tools:
13+
- `steam_getNewsForApp` — Fetch recent news and announcements for a game (no auth)
14+
- `steam_getSchemaForGame` — Achievement/stat schema with display names, descriptions, and icons (API key)
15+
- `steam_getPlayerAchievements` — Per-player achievement unlock status and timestamps (API key)
16+
- `steam_getLeaderboardsForGame` — List all leaderboards with numeric IDs (publisher key)
17+
- `steam_clearAchievement` — Re-lock/clear an achievement for QA testing (publisher key)
18+
- Skills updated with new tool references: steam-api-reference, steam-achievement-designer, steam-player-stats, steam-leaderboards, steam-community-management, steam-testing-sandbox
19+
- `steam-api-key-usage` rule updated with `GetNewsForApp`, `GetSchemaForGame`, `GetPlayerAchievements` equivalents
20+
1021
### Fixed
1122

1223
- **MCP tool naming** — Renamed all 20 MCP tool references from dot notation (`steam.getAppDetails`) to underscore notation (`steam_getAppDetails`) across 34 files. Dots conflicted with Cursor's internal MCP bridge routing. Companion steam-mcp server v0.5.0 has the matching rename.
1324
- **`steam_searchApps` parameter** — Renamed `term` to `query` across all skills, rules, and docs to match steam-mcp server v0.5.1 schema change
1425
- **Companion steam-mcp server v0.5.1**`steam_getLeaderboardEntries` description clarified (numeric ID required), write tools (`steam_setAchievement`, `steam_uploadLeaderboardScore`, `steam_grantInventoryItem`) now return clear error messages when publisher key is missing
26+
- **Companion steam-mcp server v0.6.0** — Fixed POST body encoding on publisher tools (params now sent as `application/x-www-form-urlencoded` body instead of URL query string), removed dead variable in `grantInventoryItem`
1527

1628
## [0.9.0] - 2026-03-28
1729

CLAUDE.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
66

77
**Steam Developer Tools** is a Cursor IDE plugin (v0.9.0) that integrates Steam and Steamworks APIs for game developers and power users. It provides AI-assisted workflows for querying Steam store data, managing Steamworks configurations, building multiplayer networking, implementing cloud saves, leaderboards, input, inventory/economy, social features, looking up API docs, fetching player statistics, integrating Workshop UGC, designing achievements, looking up player profiles, comparing games, analyzing reviews, researching pricing, evaluating market fit, estimating wishlists, automating builds, validating release readiness, scripting steamcmd, managing communities, optimizing store pages, planning pricing strategy, configuring DLC, setting up playtests, creating bug report workflows, integrating anti-cheat, providing a testing sandbox, and guiding platform migration.
88

9-
This plugin uses Markdown skill files and MDC rule files for AI guidance, paired with the companion [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) (separate repo) which provides 20 API tools (14 read-only + 6 write/guidance) for live data access. No build system, no npm, no compiled code in this repo.
9+
This plugin uses Markdown skill files and MDC rule files for AI guidance, paired with the companion [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) (separate repo) which provides 25 API tools (17 read-only + 8 write/guidance) for live data access. No build system, no npm, no compiled code in this repo.
1010

11-
The project is on a themed release roadmap toward v1.0.0 (see `ROADMAP.md`). The next milestone is v1.0.0 "Stable" — the production release. Target at v1.0.0: 30 skills, 9 rules, 20 MCP tools.
11+
The project is on a themed release roadmap toward v1.0.0 (see `ROADMAP.md`). The next milestone is v1.0.0 "Stable" — the production release. Target at v1.0.0: 30 skills, 9 rules, 25 MCP tools.
1212

1313
## Plugin Architecture
1414

@@ -71,7 +71,7 @@ Each `SKILL.md` uses YAML frontmatter followed by markdown sections: **Trigger**
7171

7272
### Companion MCP Server
7373

74-
The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides 20 tools (14 read-only + 6 write/guidance). Skills reference these tools in their `## MCP Usage` sections. When the MCP server is configured in Cursor, skills prefer MCP tool calls over shell `curl` commands.
74+
The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides 25 tools (17 read-only + 8 write/guidance). Skills reference these tools in their `## MCP Usage` sections. When the MCP server is configured in Cursor, skills prefer MCP tool calls over shell `curl` commands.
7575

7676
| MCP Tool | Auth | Maps to |
7777
|----------|------|---------|
@@ -84,15 +84,20 @@ The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides 20 too
8484
| `steam_getPriceOverview({ appids, cc })` | None | Store API `appdetails` (price filter) |
8585
| `steam_getAppReviewSummary({ appid })` | None | Store API `appreviews` (summary only) |
8686
| `steam_getRegionalPricing({ appid, countries })` | None | Store API `appdetails` (multi-region) |
87+
| `steam_getNewsForApp({ appid, count?, maxlength? })` | None | `ISteamNews/GetNewsForApp` |
8788
| `steam_getPlayerSummary({ steamid })` | Key | `GetPlayerSummaries` |
8889
| `steam_getOwnedGames({ steamid })` | Key | `GetOwnedGames` |
8990
| `steam_queryWorkshop({ appid })` | Key | `IPublishedFileService/QueryFiles` |
9091
| `steam_getLeaderboardEntries({ appid, leaderboardid })` | Key | `ISteamLeaderboards/GetLeaderboardEntries` |
9192
| `steam_resolveVanityURL({ vanityurl })` | Key | `ResolveVanityURL` |
93+
| `steam_getSchemaForGame({ appid })` | Key | `ISteamUserStats/GetSchemaForGame` |
94+
| `steam_getPlayerAchievements({ steamid, appid })` | Key | `ISteamUserStats/GetPlayerAchievements` |
95+
| `steam_getLeaderboardsForGame({ appid })` | Publisher key | `ISteamLeaderboards/GetLeaderboardsForGame` |
9296
| `steam_createLobby({ type, max_members, metadata })` | SDK guide | ISteamMatchmaking code examples |
9397
| `steam_uploadWorkshopItem({ appid, title, ... })` | SDK guide | ISteamUGC upload code examples |
9498
| `steam_updateWorkshopItem({ publishedfileid, ... })` | Publisher key | `IPublishedFileService/UpdateDetails` |
9599
| `steam_setAchievement({ steamid, appid, achievement })` | Publisher key | `ISteamUserStats/SetUserStatsForGame` |
100+
| `steam_clearAchievement({ steamid, appid, achievement })` | Publisher key | `ISteamUserStats/SetUserStatsForGame` (value 0) |
96101
| `steam_uploadLeaderboardScore({ appid, leaderboardid, ... })` | Publisher key | `ISteamLeaderboards/SetLeaderboardScore` |
97102
| `steam_grantInventoryItem({ appid, steamid, itemdefid })` | Publisher key | `IInventoryService/AddItem` |
98103

README.md

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
---
2323

2424
<p align="center">
25-
<strong>30 skills</strong> &nbsp;&bull;&nbsp; <strong>9 rules</strong> &nbsp;&bull;&nbsp; <strong>20 MCP tools</strong>
25+
<strong>30 skills</strong> &nbsp;&bull;&nbsp; <strong>9 rules</strong> &nbsp;&bull;&nbsp; <strong>25 MCP tools</strong>
2626
</p>
2727

2828
Query Steam store data, manage Steamworks app configurations, build multiplayer networking, implement cloud saves, design achievements, compare games, and look up player profiles — all from within Cursor's AI chat. Covers the full Steam &amp; Steamworks ecosystem with live data via the companion [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp).
@@ -54,7 +54,7 @@ That's it. No configuration needed for basic usage.
5454
flowchart LR
5555
A["You ask Cursor\na Steam question"] --> B["Cursor loads\na Skill"]
5656
B --> C{"MCP server\navailable?"}
57-
C -- Yes --> D["Steam MCP Server\n(20 tools)"]
57+
C -- Yes --> D["Steam MCP Server\n(25 tools)"]
5858
C -- No --> E["curl to\nSteam Web API"]
5959
D --> F["Steam API"]
6060
E --> F
@@ -163,11 +163,11 @@ The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides live,
163163
</details>
164164

165165
<details>
166-
<summary><strong>Available Tools (20)</strong></summary>
166+
<summary><strong>Available Tools (25)</strong></summary>
167167

168168
&nbsp;
169169

170-
**Read-only (no auth) — 9 tools:**
170+
**Read-only (no auth) — 10 tools:**
171171

172172
| Tool | Description |
173173
|------|-------------|
@@ -180,8 +180,9 @@ The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides live,
180180
| `steam_getPriceOverview` | Batch price check for multiple apps in a region |
181181
| `steam_getAppReviewSummary` | Review score, totals, and positive percentage |
182182
| `steam_getRegionalPricing` | Pricing breakdown across multiple countries |
183+
| `steam_getNewsForApp` | Recent news and announcements for a game |
183184

184-
**Read-only (API key) — 5 tools:**
185+
**Read-only (API key) — 7 tools:**
185186

186187
| Tool | Description |
187188
|------|-------------|
@@ -190,6 +191,8 @@ The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides live,
190191
| `steam_queryWorkshop` | Search/browse Workshop items |
191192
| `steam_getLeaderboardEntries` | Leaderboard scores and rankings |
192193
| `steam_resolveVanityURL` | Convert vanity URL to Steam ID |
194+
| `steam_getSchemaForGame` | Achievement/stat schema with display names and icons |
195+
| `steam_getPlayerAchievements` | Per-player achievement unlock status and timestamps |
193196

194197
**Write / guidance (publisher key):**
195198

@@ -199,8 +202,10 @@ The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides live,
199202
| `steam_uploadWorkshopItem` | SDK guide | Code examples for ISteamUGC Workshop uploads |
200203
| `steam_updateWorkshopItem` | HTTP POST | Update Workshop item metadata via partner API |
201204
| `steam_setAchievement` | HTTP POST | Set/unlock achievements (dev/test) |
205+
| `steam_clearAchievement` | HTTP POST | Clear/re-lock achievements (dev/test) |
202206
| `steam_uploadLeaderboardScore` | HTTP POST | Upload leaderboard scores |
203207
| `steam_grantInventoryItem` | HTTP POST | Grant inventory items |
208+
| `steam_getLeaderboardsForGame` | HTTP GET | List all leaderboards with numeric IDs |
204209

205210
</details>
206211

@@ -447,8 +452,8 @@ See [ROADMAP.md](ROADMAP.md) for the full themed release plan toward v1.0.0.
447452
| **v0.6.0** | Quality | Playtest setup, bug reporting, anti-cheat, save compat / network security / error handling rules | Done |
448453
| **v0.7.0** | Full Power | Testing sandbox, 6 MCP write tools (lobbies, workshop, achievements, leaderboards, inventory) | Done |
449454
| **v0.8.0** | Polish | Migration guide, common pitfalls across all 30 skills | Done |
450-
| **v0.9.0** | Complete | 4 new MCP read tools (reviews, pricing, regional) — 20 MCP tools total | **Current** |
451-
| v1.0.0 | Stable | Production release: 30 skills, 9 rules, 20 MCP tools | Planned |
455+
| **v0.9.0** | Complete | 4 new MCP read tools (reviews, pricing, regional) — 25 MCP tools total | **Current** |
456+
| v1.0.0 | Stable | Production release: 30 skills, 9 rules, 25 MCP tools | Planned |
452457

453458
</details>
454459

ROADMAP.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22

33
Themed release plan toward v1.0.0.
44

5-
**Current:** v0.9.0 - 30 skills, 9 rules, companion [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) with 20 tools (14 read-only + 6 write/guidance).
5+
**Current:** v0.9.0 - 30 skills, 9 rules, companion [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) with 25 tools (17 read-only + 8 write/guidance).
66

7-
**Target:** v1.0.0 - 30 skills, 9 rules, 20 MCP tools.
7+
**Target:** v1.0.0 - 30 skills, 9 rules, 25 MCP tools.
88

99
| Version | Theme | New Skills | New Rules | MCP Tools | Total Skills | Total Rules |
1010
|---------|-------|-----------|-----------|-----------|-------------|-------------|
@@ -196,7 +196,7 @@ Update all 14 existing skills to reference MCP tools where applicable. Replace "
196196

197197
## v0.9.0 - "Complete" (Final MCP Tools)
198198

199-
**Theme:** Reach the target of 20 MCP tools by adding the 4 remaining read-only tools.
199+
**Theme:** Reach the target of 25 MCP tools by adding the 4 remaining read-only tools.
200200

201201
### New MCP Tools (Read-Only, No Auth)
202202

@@ -216,7 +216,7 @@ Update all 14 existing skills to reference MCP tools where applicable. Replace "
216216
### Release Checklist
217217

218218
- [ ] All 30 skills reviewed and tested
219-
- [ ] All 20 MCP tools documented and stable
219+
- [ ] All 25 MCP tools documented and stable
220220
- [ ] All 9 rules validated against real projects
221221
- [ ] CHANGELOG fully up to date
222222
- [ ] README reflects final feature set
@@ -258,3 +258,8 @@ Update all 14 existing skills to reference MCP tools where applicable. Replace "
258258
- [x] ~~getPriceOverview MCP tool~~ - `steam_getPriceOverview` added in v0.9.0
259259
- [x] ~~getAppReviewSummary MCP tool~~ - `steam_getAppReviewSummary` added in v0.9.0
260260
- [x] ~~getRegionalPricing MCP tool~~ - `steam_getRegionalPricing` added in v0.9.0
261+
- [x] ~~getSchemaForGame MCP tool~~ - `steam_getSchemaForGame` added in steam-mcp v0.6.0
262+
- [x] ~~getNewsForApp MCP tool~~ - `steam_getNewsForApp` added in steam-mcp v0.6.0
263+
- [x] ~~getLeaderboardsForGame MCP tool~~ - `steam_getLeaderboardsForGame` added in steam-mcp v0.6.0
264+
- [x] ~~getPlayerAchievements MCP tool~~ - `steam_getPlayerAchievements` added in steam-mcp v0.6.0
265+
- [x] ~~clearAchievement MCP tool~~ - `steam_clearAchievement` added in steam-mcp v0.6.0

docs/index.html

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@
44
<meta charset="UTF-8">
55
<meta name="viewport" content="width=device-width, initial-scale=1.0">
66
<title>Steam Developer Tools — Cursor IDE Plugin</title>
7-
<meta name="description" content="30 AI skills, 9 code rules, and 20 MCP tools for Steam and Steamworks game development inside Cursor IDE.">
7+
<meta name="description" content="30 AI skills, 9 code rules, and 25 MCP tools for Steam and Steamworks game development inside Cursor IDE.">
88
<meta property="og:title" content="Steam Developer Tools — Cursor IDE Plugin">
9-
<meta property="og:description" content="30 AI skills, 9 code rules, and 20 MCP tools for Steam and Steamworks game development inside Cursor IDE.">
9+
<meta property="og:description" content="30 AI skills, 9 code rules, and 25 MCP tools for Steam and Steamworks game development inside Cursor IDE.">
1010
<meta property="og:type" content="website">
1111
<meta property="og:url" content="https://tmhsdigital.github.io/Steam-Cursor-Plugin/">
1212
<link rel="icon" href="assets/logo.png" type="image/png">
@@ -234,7 +234,7 @@ <h1>Steam Developer Tools</h1>
234234
<div class="stats">
235235
<div class="stat"><div class="stat-number">30</div><div class="stat-label">Skills</div></div>
236236
<div class="stat"><div class="stat-number">9</div><div class="stat-label">Rules</div></div>
237-
<div class="stat"><div class="stat-number">20</div><div class="stat-label">MCP Tools</div></div>
237+
<div class="stat"><div class="stat-number">25</div><div class="stat-label">MCP Tools</div></div>
238238
</div>
239239

240240
<!-- HOW IT WORKS -->
@@ -299,7 +299,7 @@ <h3>Formatted answer</h3>
299299
<section id="tools" style="background:var(--bg-primary)">
300300
<div class="container reveal">
301301
<div class="section-label">Companion MCP Server</div>
302-
<div class="section-title">20 structured API tools</div>
302+
<div class="section-title">25 structured API tools</div>
303303
<div class="section-desc">The <a href="https://github.com/TMHSDigital/steam-mcp">Steam MCP Server</a> provides live, typed tools that Cursor calls directly &mdash; no shell commands needed.</div>
304304

305305
<div class="tools-group">
@@ -314,6 +314,7 @@ <h3>Read-only <span class="tools-badge tools-badge-none">No auth</span></h3>
314314
<tr><td class="tool-name">steam_getPriceOverview</td><td>Batch price check for multiple apps in a region</td></tr>
315315
<tr><td class="tool-name">steam_getAppReviewSummary</td><td>Review score, totals, and positive percentage</td></tr>
316316
<tr><td class="tool-name">steam_getRegionalPricing</td><td>Pricing breakdown across multiple countries</td></tr>
317+
<tr><td class="tool-name">steam_getNewsForApp</td><td>Recent news and announcements for a game</td></tr>
317318
</tbody></table>
318319
</div>
319320

@@ -325,6 +326,8 @@ <h3>Read-only <span class="tools-badge tools-badge-key">API key</span></h3>
325326
<tr><td class="tool-name">steam_queryWorkshop</td><td>Search and browse Workshop items</td></tr>
326327
<tr><td class="tool-name">steam_getLeaderboardEntries</td><td>Leaderboard scores and rankings</td></tr>
327328
<tr><td class="tool-name">steam_resolveVanityURL</td><td>Convert vanity URL to Steam ID</td></tr>
329+
<tr><td class="tool-name">steam_getSchemaForGame</td><td>Achievement/stat schema with display names and icons</td></tr>
330+
<tr><td class="tool-name">steam_getPlayerAchievements</td><td>Per-player achievement unlock status and timestamps</td></tr>
328331
</tbody></table>
329332
</div>
330333

@@ -335,8 +338,10 @@ <h3>Write / Guidance <span class="tools-badge tools-badge-pub">Publisher key</sp
335338
<tr><td class="tool-name">steam_uploadWorkshopItem</td><td><span class="tool-type">SDK guide</span></td><td>Code examples for ISteamUGC Workshop uploads</td></tr>
336339
<tr><td class="tool-name">steam_updateWorkshopItem</td><td><span class="tool-type">HTTP POST</span></td><td>Update Workshop item metadata via partner API</td></tr>
337340
<tr><td class="tool-name">steam_setAchievement</td><td><span class="tool-type">HTTP POST</span></td><td>Set/unlock achievements (dev/test)</td></tr>
341+
<tr><td class="tool-name">steam_clearAchievement</td><td><span class="tool-type">HTTP POST</span></td><td>Clear/re-lock achievements (dev/test)</td></tr>
338342
<tr><td class="tool-name">steam_uploadLeaderboardScore</td><td><span class="tool-type">HTTP POST</span></td><td>Upload leaderboard scores</td></tr>
339343
<tr><td class="tool-name">steam_grantInventoryItem</td><td><span class="tool-type">HTTP POST</span></td><td>Grant inventory items</td></tr>
344+
<tr><td class="tool-name">steam_getLeaderboardsForGame</td><td><span class="tool-type">HTTP GET</span></td><td>List all leaderboards with numeric IDs</td></tr>
340345
</tbody></table>
341346
</div>
342347
</div>
@@ -421,8 +426,8 @@ <h3>Add MCP server <span style="color:var(--text-muted);font-weight:400;font-siz
421426
<div class="tl-item"><div class="tl-dot tl-dot-done"></div><span class="tl-version">v0.6.0</span><span class="tl-theme">Quality</span><span class="tl-tag tl-tag-done">Done</span><div class="tl-desc">Playtest, bug reporting, anti-cheat, 3 code quality rules</div></div>
422427
<div class="tl-item"><div class="tl-dot tl-dot-done"></div><span class="tl-version">v0.7.0</span><span class="tl-theme">Full Power</span><span class="tl-tag tl-tag-done">Done</span><div class="tl-desc">Testing sandbox, 6 MCP write tools</div></div>
423428
<div class="tl-item"><div class="tl-dot tl-dot-done"></div><span class="tl-version">v0.8.0</span><span class="tl-theme">Polish</span><span class="tl-tag tl-tag-done">Done</span><div class="tl-desc">Migration guide, common pitfalls across all 30 skills</div></div>
424-
<div class="tl-item"><div class="tl-dot tl-dot-current"></div><span class="tl-version">v0.9.0</span><span class="tl-theme">Complete</span><span class="tl-tag tl-tag-current">Current</span><div class="tl-desc">4 new MCP read tools — reviews, pricing, regional — 20 total</div></div>
425-
<div class="tl-item"><div class="tl-dot tl-dot-planned"></div><span class="tl-version">v1.0.0</span><span class="tl-theme">Stable</span><span class="tl-tag tl-tag-planned">Planned</span><div class="tl-desc">Production release: 30 skills, 9 rules, 20 MCP tools</div></div>
429+
<div class="tl-item"><div class="tl-dot tl-dot-current"></div><span class="tl-version">v0.9.0</span><span class="tl-theme">Complete</span><span class="tl-tag tl-tag-current">Current</span><div class="tl-desc">4 new MCP read tools — reviews, pricing, regional — 25 total</div></div>
430+
<div class="tl-item"><div class="tl-dot tl-dot-planned"></div><span class="tl-version">v1.0.0</span><span class="tl-theme">Stable</span><span class="tl-tag tl-tag-planned">Planned</span><div class="tl-desc">Production release: 30 skills, 9 rules, 25 MCP tools</div></div>
426431
</div>
427432
</div>
428433
</section>

0 commit comments

Comments
 (0)