Update to version 0.2.0 of Steam Developer Tools plugin, introducing the steam-api-key-usage rule to guide users towards using MCP tools over raw API calls. Updated all skills to reference the companion Steam MCP server, enhancing documentation in CHANGELOG, README, and various skill files to reflect these changes. Adjusted plugin manifest for versioning consistency.

Author: TMHSDigital

.cursor-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "steam-cursor-plugin",
   "displayName": "Steam Developer Tools",
-  "version": "0.1.0",
-  "description": "Integrates Steam and Steamworks APIs for game developers and power users. 14 skills covering store data, multiplayer networking, cloud saves, leaderboards, input, inventory, social features, profile lookups, and game comparisons - plus 3 rules for App ID validation, secrets detection, and Steam Deck compatibility.",
+  "version": "0.2.0",
+  "description": "Integrates Steam and Steamworks APIs for game developers and power users. 14 skills covering store data, multiplayer networking, cloud saves, leaderboards, input, inventory, social features, profile lookups, and game comparisons - plus 4 rules for App ID validation, secrets detection, Steam Deck compatibility, and MCP tool preference. Companion Steam MCP server provides 10 live API tools.",
   "author": {
     "name": "TMHSDigital",
     "url": "https://github.com/TMHSDigital"

CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to Steam Developer Tools will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-03-27
+
+### Added
+
+- **steam-api-key-usage** rule: when the Steam MCP server is available, flags raw `curl`/`fetch` calls to Steam API endpoints and suggests the equivalent MCP tool
+- Companion [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) referenced across all skills (server lives in separate repo)
+
+### Changed
+
+- All 14 skills updated: replaced `## MCP Integration (Future)` placeholder sections with concrete `## MCP Usage` sections referencing the companion Steam MCP server's actual tool signatures
+- 6 skills with direct MCP replacements now include "Preferred" callouts in their Workflow sections directing users to MCP tools over `curl` commands: steam-store-lookup, steam-player-stats, steam-profile-lookup, steam-game-comparison, steam-workshop-helper, steam-leaderboards
+- **steam-api-reference** skill now includes a full catalog of all 10 available MCP tools with parameter signatures and auth requirements
+- Plugin description updated to reflect MCP support and 4 rules
+- Version bumped to 0.2.0
+
 ## [0.1.0] - 2026-03-26
 
 ### Added
@@ -28,4 +43,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **steam-deck-compat** rule: flags common Steam Deck compatibility issues (hardcoded resolutions, mouse-only input, anti-cheat, Windows-only paths, missing controller support)
 - Plugin manifest, README, CONTRIBUTING guide, and license
 
+[0.2.0]: https://github.com/TMHSDigital/Steam-Cursor-Plugin/releases/tag/v0.2.0
 [0.1.0]: https://github.com/TMHSDigital/Steam-Cursor-Plugin/releases/tag/v0.1.0

CLAUDE.md

@@ -4,11 +4,11 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-**Steam Developer Tools** is a Cursor IDE plugin (v0.1.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, and comparing games.
+**Steam Developer Tools** is a Cursor IDE plugin (v0.2.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, and comparing games.
 
-This is currently a **static, documentation-only plugin** - no build system, no npm, no compiled code. All plugin logic is expressed in Markdown skill files and MDC rule files.
+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 10 read-only API tools for live data access. No build system, no npm, no compiled code in this repo.
 
-The project is on a themed release roadmap toward v1.0.0 (see `ROADMAP.md`). The next major milestone (v0.2.0 "Live Data") introduces a Steam MCP server (separate repo: [steam-mcp](https://github.com/TMHSDigital/steam-mcp)) with read-only API tools. Subsequent releases add analytics/market research skills (v0.3.0), CI/CD automation (v0.4.0), community/monetization skills (v0.5.0), QA rules (v0.6.0), MCP write operations (v0.7.0), and polish (v0.8.0). Target at v1.0.0: 30 skills, 9 rules, 20 MCP tools.
+The project is on a themed release roadmap toward v1.0.0 (see `ROADMAP.md`). The next major milestone (v0.3.0 "Insights") adds analytics and market research skills. Subsequent releases add CI/CD automation (v0.4.0), community/monetization skills (v0.5.0), QA rules (v0.6.0), MCP write operations (v0.7.0), and polish (v0.8.0). Target at v1.0.0: 30 skills, 9 rules, 20 MCP tools.
 
 ## Plugin Architecture
 
@@ -39,13 +39,31 @@ Each `SKILL.md` uses YAML frontmatter followed by markdown sections: **Trigger**
 | `steam-profile-lookup` | Resolve vanity URLs, fetch player summaries, owned games, level/badges |
 | `steam-game-comparison` | Side-by-side comparison of price, reviews, player counts, genres |
 
-### Rules (3 total)
+### Rules (4 total)
 
 | Rule | Scope | Purpose |
 |------|-------|---------|
 | `steam-appid-validation.mdc` | `steam_appid.txt`, `*.vdf`, steamcmd configs | Enforces App ID consistency; warns if `480` (SpaceWar test) is used in production |
 | `steamworks-secrets.mdc` | Global (all files) | Flags Steam API keys (32-char hex), ssfn files, publisher credentials, DRM keys |
 | `steam-deck-compat.mdc` | `*.cpp`, `*.cs`, `*.gd`, `*.vdf`, `*.cfg`, `*.ini`, `*.json` | Flags Steam Deck compat issues: hardcoded resolutions, mouse-only input, anti-cheat, Windows paths |
+| `steam-api-key-usage.mdc` | `*.sh`, `*.ps1`, `*.py`, `*.js`, `*.ts`, `*.yml`, `*.yaml` | Flags raw curl/fetch to Steam APIs when MCP tools are available; suggests equivalent MCP tool |
+
+### Companion MCP Server
+
+The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides 10 read-only tools. 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.
+
+| MCP Tool | Auth | Maps to |
+|----------|------|---------|
+| `steam.getAppDetails({ appid })` | None | Store API `appdetails` |
+| `steam.searchApps({ term })` | None | Store API `storesearch` |
+| `steam.getPlayerCount({ appid })` | None | `GetNumberOfCurrentPlayers` |
+| `steam.getAchievementStats({ appid })` | None | `GetGlobalAchievementPercentagesForApp` |
+| `steam.getWorkshopItem({ publishedfileid })` | None | `GetPublishedFileDetails` |
+| `steam.getPlayerSummary({ steamid })` | Key | `GetPlayerSummaries` |
+| `steam.getOwnedGames({ steamid })` | Key | `GetOwnedGames` |
+| `steam.queryWorkshop({ appid })` | Key | `IPublishedFileService/QueryFiles` |
+| `steam.getLeaderboardEntries({ appid, leaderboardid })` | Key | `ISteamLeaderboards/GetLeaderboardEntries` |
+| `steam.resolveVanityURL({ vanityurl })` | Key | `ResolveVanityURL` |
 
 ## Development Workflow
 

README.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-CC--BY--NC--ND--4.0-blue.svg" alt="License: CC BY-NC-ND 4.0"></a>
-  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-0.1.0-green.svg" alt="Version"></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-0.2.0-green.svg" alt="Version"></a>
   <a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/stargazers"><img src="https://img.shields.io/github/stars/TMHSDigital/Steam-Cursor-Plugin?style=flat" alt="GitHub Stars"></a>
   <a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/commits/main"><img src="https://img.shields.io/github/last-commit/TMHSDigital/Steam-Cursor-Plugin" alt="Last Commit"></a>
   <a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin"><img src="https://img.shields.io/badge/Cursor-Plugin-8B5CF6.svg" alt="Cursor Plugin"></a>
@@ -20,7 +20,7 @@
 
 ---
 
-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. 14 skills and 3 rules covering the full Steam &amp; Steamworks ecosystem.
+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. 14 skills and 4 rules covering the full Steam &amp; Steamworks ecosystem, with 10 live MCP tools via the companion [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp).
 
 > **No API key required** for most features. Store lookups, player counts, global achievement stats, and app searches all work out of the box.
 
@@ -52,12 +52,46 @@ Query Steam store data, manage Steamworks app configurations, build multiplayer
 | **App ID Validation** | Checks that Steam App IDs are consistent across your project (`steam_appid.txt`, VDF files, source code) and warns if `steam_appid.txt` is missing. |
 | **Steamworks Secrets** | Prevents committing API keys, partner credentials, and auth tokens. Flags sensitive patterns and suggests secure alternatives. |
 | **Steam Deck Compatibility** | Flags common Deck compat issues in game code: hardcoded resolutions, mouse-only input, anti-cheat blockers, Windows-only paths, and missing controller support. |
+| **MCP Tool Preference** | When the Steam MCP server is configured, flags raw `curl`/`fetch` calls to Steam APIs and suggests the equivalent MCP tool. |
 
 ## Companion: Steam MCP Server
 
-The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) is the companion project that provides live, structured API tools for this plugin. It exposes Steam store data, player stats, achievements, workshop items, and more as MCP tools that AI-powered IDEs can call directly.
-
-> **Status:** In development - coming in v0.2.0 of this plugin.
+The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) is the companion project that provides live, structured API tools for this plugin. It exposes Steam store data, player stats, achievements, workshop items, and more as MCP tools that Cursor can call directly.
+
+### Setup
+
+Add the Steam MCP server to your Cursor MCP configuration (`.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "steam": {
+      "command": "npx",
+      "args": ["-y", "steam-mcp"],
+      "env": {
+        "STEAM_API_KEY": "your_key_here"
+      }
+    }
+  }
+}
+```
+
+The `STEAM_API_KEY` is only required for tools that access user-specific data (player summaries, owned games, workshop queries, leaderboards, vanity URL resolution). Store lookups, player counts, achievement stats, and workshop item details work without a key.
+
+### Available Tools
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `steam.getAppDetails` | None | Store data (price, reviews, tags, platforms) |
+| `steam.searchApps` | None | Search the Steam store by name |
+| `steam.getPlayerCount` | None | Current concurrent players |
+| `steam.getAchievementStats` | None | Global achievement unlock percentages |
+| `steam.getWorkshopItem` | None | Workshop item details |
+| `steam.getPlayerSummary` | Key | Player profile (name, avatar, status) |
+| `steam.getOwnedGames` | Key | Game library with playtime |
+| `steam.queryWorkshop` | Key | Search/browse Workshop items |
+| `steam.getLeaderboardEntries` | Key | Leaderboard scores and rankings |
+| `steam.resolveVanityURL` | Key | Convert vanity URL to Steam ID |
 
 ## Quick Start
 

ROADMAP.md

@@ -8,8 +8,8 @@ Themed release plan from v0.2.0 through v1.0.0.
 
 | Version | Theme | New Skills | New Rules | MCP Tools | Total Skills | Total Rules |
 |---------|-------|-----------|-----------|-----------|-------------|-------------|
-| v0.1.0 (current) | - | - | - | 0 | 14 | 3 |
-| v0.2.0 | Live Data | 0 (updates) | 1 | 10 | 14 | 4 |
+| v0.1.0 | - | - | - | 0 | 14 | 3 |
+| v0.2.0 (current) | Live Data | 0 (updates) | 1 | 10 | 14 | 4 |
 | v0.3.0 | Insights | 4 | 0 | 2 | 18 | 4 |
 | v0.4.0 | Ship It | 3 | 2 | 0 | 21 | 6 |
 | v0.5.0 | Grow | 4 | 0 | 2 | 25 | 6 |
@@ -212,3 +212,5 @@ Update all 14 existing skills to reference MCP tools where applicable. Replace "
 
 - [x] ~~Steam Deck compatibility checker~~ - added in v0.1.0 as a rule
 - [x] ~~Steamworks SDK code generation~~ - covered by multiplayer, cloud, leaderboard, input, and inventory skills
+- [x] ~~Steam MCP server with 10 read-only tools~~ - companion repo [steam-mcp](https://github.com/TMHSDigital/steam-mcp), skills updated in v0.2.0
+- [x] ~~MCP tool preference rule~~ - `steam-api-key-usage.mdc` added in v0.2.0

rules/steam-api-key-usage.mdc

@@ -0,0 +1,55 @@
+---
+description: When the Steam MCP server is available, guide users to prefer MCP tool calls over raw curl/fetch commands to Steam APIs. Flag direct HTTP calls to Steam endpoints and suggest the equivalent MCP tool.
+alwaysApply: false
+globs:
+  - "**/*.sh"
+  - "**/*.ps1"
+  - "**/*.py"
+  - "**/*.js"
+  - "**/*.ts"
+  - "**/*.yml"
+  - "**/*.yaml"
+---
+
+# Prefer Steam MCP Tools Over Raw API Calls
+
+When editing or reviewing files that make HTTP requests to Steam APIs, suggest using the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) tools instead. MCP tools handle authentication, error handling, rate limiting, and response parsing automatically.
+
+## Patterns to Flag
+
+Flag any `curl`, `fetch`, `requests.get`, `Invoke-WebRequest`, or similar HTTP calls to these Steam API domains:
+
+- `api.steampowered.com`
+- `store.steampowered.com/api/`
+- `partner.steam-api.com` (note: MCP only covers read-only endpoints, not partner write operations)
+
+## MCP Tool Equivalents
+
+When a flagged call matches one of these endpoints, suggest the MCP tool:
+
+| Endpoint Pattern | MCP Tool |
+|-----------------|----------|
+| `/api/storesearch/` | `steam.searchApps({ term })` |
+| `/api/appdetails` | `steam.getAppDetails({ appid })` |
+| `GetNumberOfCurrentPlayers` | `steam.getPlayerCount({ appid })` |
+| `GetGlobalAchievementPercentagesForApp` | `steam.getAchievementStats({ appid })` |
+| `GetPublishedFileDetails` | `steam.getWorkshopItem({ publishedfileid })` |
+| `GetPlayerSummaries` | `steam.getPlayerSummary({ steamid })` |
+| `GetOwnedGames` | `steam.getOwnedGames({ steamid })` |
+| `QueryFiles` (IPublishedFileService) | `steam.queryWorkshop({ appid })` |
+| `GetLeaderboardEntries` | `steam.getLeaderboardEntries({ appid, leaderboardid })` |
+| `ResolveVanityURL` | `steam.resolveVanityURL({ vanityurl })` |
+
+## What to Say
+
+When a matching pattern is found:
+
+> "This file makes a direct HTTP call to a Steam API endpoint. If the Steam MCP server is configured, consider using `{mcp_tool}` instead -- it handles authentication, timeouts, and error responses automatically."
+
+## Exceptions
+
+Do not flag these cases:
+- Calls to Steam API endpoints that have no MCP tool equivalent (e.g., `GetPlayerAchievements`, `GetUserStatsForGame`, `GetNewsForApp`, `ISteamMicroTxn`)
+- Code inside the MCP server itself (the `steam-mcp` project)
+- Documentation or comments explaining the raw API
+- Test files that intentionally test raw API behavior

skills/steam-achievement-designer/SKILL.md

@@ -152,6 +152,14 @@ Always call `StoreStats()` after setting achievements to persist them to Steam s
 4. Provides C++ unlock code snippets for each
 5. Notes icon requirements and suggests consistent naming for icon files
 
-## MCP Integration (Future)
+## MCP Usage
 
-A Steam MCP server could expose `steam.getAchievementSchema({ appid })` to fetch existing achievement definitions. The design guidance, VDF generation, and code examples remain the same.
+When the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is configured, you can fetch existing achievement data to inform new designs:
+
+| Step | MCP Tool | Auth | Purpose |
+|------|----------|------|---------|
+| Get existing achievements | `steam.getAchievementStats({ appid })` | None | Fetch global unlock percentages to see what players actually unlock |
+
+This is useful for reviewing an existing game's achievement distribution before designing new ones, or for auditing unlock rates on your own game.
+
+The design guidance, VDF/JSON generation, naming conventions, icon requirements, and SDK unlock code remain the same regardless of MCP availability.

skills/steam-api-reference/SKILL.md

@@ -97,6 +97,32 @@ Users should store their API key in an environment variable (`STEAM_API_KEY`) an
 3. Shows a `curl` example and explains the response structure
 4. Notes: "For per-player achievements you need the player's Steam ID and an API key. For global unlock percentages, no key is needed."
 
-## MCP Integration (Future)
+## MCP Usage
 
-When a Steam MCP server is available, it should expose tools like `steam.getApiDocs({ interface, method })` to return structured endpoint information. The formatting and example generation logic remains the same.
+The [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) provides 10 tools that call Steam APIs directly, eliminating the need for manual `curl` commands for common operations.
+
+### Available MCP Tools
+
+**No API key required:**
+
+| Tool | Description |
+|------|-------------|
+| `steam.getAppDetails({ appid, cc?, l? })` | Store data: price, reviews, tags, platforms, system requirements |
+| `steam.searchApps({ term, cc?, l? })` | Search the Steam store by name |
+| `steam.getPlayerCount({ appid })` | Current concurrent player count |
+| `steam.getAchievementStats({ appid })` | Global achievement unlock percentages |
+| `steam.getWorkshopItem({ publishedfileid })` | Workshop item details (title, tags, subscribers) |
+
+**Requires `STEAM_API_KEY` environment variable:**
+
+| Tool | Description |
+|------|-------------|
+| `steam.getPlayerSummary({ steamid })` | Player profile: name, avatar, online status |
+| `steam.getOwnedGames({ steamid, include_played_free_games?, include_appinfo? })` | Game library with playtime data |
+| `steam.queryWorkshop({ appid, search_text?, cursor?, numperpage?, query_type?, requiredtags? })` | Search and browse Workshop items |
+| `steam.getLeaderboardEntries({ appid, leaderboardid, rangestart?, rangeend?, datarequest?, steamid? })` | Leaderboard scores and rankings |
+| `steam.resolveVanityURL({ vanityurl, url_type? })` | Convert vanity URL to 64-bit Steam ID |
+
+When an MCP tool exists for a given endpoint, prefer it over raw `curl` calls. For endpoints not covered by MCP tools (per-player achievements, user stats, news, microtransactions), continue using the Web API directly.
+
+The Steamworks SDK documentation and example generation logic remain the same regardless of MCP availability.

skills/steam-cloud-saves/SKILL.md

@@ -144,6 +144,8 @@ When a cloud conflict occurs (local and remote versions differ):
 4. Sets quota recommendation (100MB / 100 files is plenty for a roguelike)
 5. Notes: "Auto-Cloud works without any code changes. Steam syncs the files before launch and after exit."
 
-## MCP Integration (Future)
+## MCP Usage
 
-A Steam MCP server could expose `steam.listCloudFiles({ appid })` and `steam.getCloudQuota({ appid })` via the `ICloudService` Web API. The SDK integration patterns remain documentation-only.
+Steam Cloud uses the in-process Steamworks SDK API (`ISteamRemoteStorage`) for reading and writing save files. Auto-Cloud is configured through the Steamworks Partner site or VDF files. Neither has a publicly available Web API equivalent for the core operations.
+
+This skill remains documentation-only regardless of whether the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is available.