docs: fix stale references, add cross-repo badges

- Fix plugin.json description: 20 -> 25 MCP tools

- Remove stale 'planned for vX.X' language in 4 skills (review-analysis, price-history, pricing-strategy, multiplayer-networking)

- Update steam-api-reference MCP tables to list all 25 tools (was 13)

- Fix .cursorrules searchApps example (bad example was identical to good)

- Add MCP Usage, Key References, Common Pitfalls, See Also to CONTRIBUTING.md skill section list

- Fix README v0.9.0 release history row (20 tools, not 25)

- Add npm version and downloads badges to README badge row and Companion section

- Add npm link to docs/index.html footer

Made-with: Cursor

Author: TMHSDigital

.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "steam-cursor-plugin",
   "displayName": "Steam Developer Tools",
   "version": "0.9.0",
-  "description": "Integrates Steam and Steamworks APIs for game developers and power users. 30 skills covering store data, multiplayer, cloud saves, leaderboards, input, inventory, social, profiles, comparisons, reviews, pricing, market research, wishlists, CI/CD, release checklists, steamcmd, community, store pages, pricing strategy, DLC, playtesting, bug reporting, anti-cheat, testing sandbox, and platform migration - plus 9 rules. Companion Steam MCP server provides 20 API tools.",
+  "description": "Integrates Steam and Steamworks APIs for game developers and power users. 30 skills covering store data, multiplayer, cloud saves, leaderboards, input, inventory, social, profiles, comparisons, reviews, pricing, market research, wishlists, CI/CD, release checklists, steamcmd, community, store pages, pricing strategy, DLC, playtesting, bug reporting, anti-cheat, testing sandbox, and platform migration - plus 9 rules. Companion Steam MCP server provides 25 MCP tools.",
   "author": {
     "name": "TMHSDigital",
     "url": "https://github.com/TMHSDigital"

.cursorrules

@@ -27,6 +27,6 @@
 ## MCP Tool Signatures
 
 When referencing MCP tools in documentation, use the canonical parameter names from the skill files:
-- `steam_searchApps({ query })` not `{ query }`
+- `steam_searchApps({ query })` not `{ term }`
 - `steam_getWorkshopItem({ publishedfileid })` not `{ fileid }`
 - `steam_getLeaderboardEntries({ appid, leaderboardid, rangestart?, rangeend? })` not `{ id, range }`

CONTRIBUTING.md

@@ -58,11 +58,15 @@ rules/                 # 9 rule files
    description: One-line description of what the skill does and when to use it.
    ---
    ```
-3. Structure the body with these sections:
+3. Structure the body with these sections (in order):
    - **Trigger** - when Cursor should load this skill
    - **Required Inputs** - what the user must provide
    - **Workflow** - step-by-step instructions for the agent
+   - **Key References** - links to official Steamworks/Steam docs
    - **Example Interaction** - sample prompt and response
+   - **MCP Usage** - table mapping workflow steps to MCP tools (required even for SDK-only skills)
+   - **Common Pitfalls** - numbered list of mistakes to avoid
+   - **See Also** - links to related skills
 
 ## Adding a Rule
 

README.md

@@ -12,6 +12,8 @@
   <a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/actions/workflows/validate.yml"><img src="https://img.shields.io/github/actions/workflow/status/TMHSDigital/Steam-Cursor-Plugin/validate.yml?label=CI" alt="CI"></a>
   <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.9.0-green.svg" alt="Version"></a>
+  <a href="https://www.npmjs.com/package/@tmhs/steam-mcp"><img src="https://img.shields.io/npm/v/@tmhs/steam-mcp?label=MCP%20server" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@tmhs/steam-mcp"><img src="https://img.shields.io/npm/dw/@tmhs/steam-mcp?label=MCP%20downloads" alt="npm downloads"></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>
@@ -135,6 +137,8 @@ flowchart LR
 
 ## Companion: Steam MCP Server
 
+[![npm version](https://img.shields.io/npm/v/@tmhs/steam-mcp)](https://www.npmjs.com/package/@tmhs/steam-mcp) [![npm downloads](https://img.shields.io/npm/dw/@tmhs/steam-mcp)](https://www.npmjs.com/package/@tmhs/steam-mcp) [![GitHub stars](https://img.shields.io/github/stars/TMHSDigital/Steam-MCP?style=flat)](https://github.com/TMHSDigital/Steam-MCP/stargazers)
+
 The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides live, structured API tools that Cursor can call directly — no shell commands needed.
 
 <details open>
@@ -452,7 +456,7 @@ See [ROADMAP.md](ROADMAP.md) for the full themed release plan toward v1.0.0.
 | **v0.6.0** | Quality | Playtest setup, bug reporting, anti-cheat, save compat / network security / error handling rules | Done |
 | **v0.7.0** | Full Power | Testing sandbox, 6 MCP write tools (lobbies, workshop, achievements, leaderboards, inventory) | Done |
 | **v0.8.0** | Polish | Migration guide, common pitfalls across all 30 skills | Done |
-| **v0.9.0** | Complete | 4 new MCP read tools (reviews, pricing, regional) — 25 MCP tools total | **Current** |
+| **v0.9.0** | Complete | 4 new MCP read tools (reviews, pricing, regional) — 20 MCP tools at release | **Current** |
 | v1.0.0 | Stable | Production release: 30 skills, 9 rules, 25 MCP tools | Planned |
 
 </details>

docs/index.html

@@ -437,6 +437,7 @@ <h3>Add MCP server <span style="color:var(--text-muted);font-weight:400;font-siz
   <div class="footer-links">
     <a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin">GitHub</a>
     <a href="https://github.com/TMHSDigital/steam-mcp">MCP Server</a>
+    <a href="https://www.npmjs.com/package/@tmhs/steam-mcp">npm</a>
     <a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/blob/main/CHANGELOG.md">Changelog</a>
     <a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/blob/main/CONTRIBUTING.md">Contributing</a>
     <a href="https://github.com/TMHSDigital/Steam-Cursor-Plugin/blob/main/LICENSE">License</a>

skills/steam-api-reference/SKILL.md

@@ -101,9 +101,9 @@ Users should store their API key in an environment variable (`STEAM_API_KEY`) an
 
 The [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) provides 25 tools that call Steam APIs directly, eliminating the need for manual `curl` commands for common operations.
 
-### Available MCP Tools
+### Available MCP Tools (25)
 
-**No API key required:**
+**No API key required (10 tools):**
 
 | Tool | Description |
 |------|-------------|
@@ -112,9 +112,13 @@ The [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) provides 25 too
 | `steam_getPlayerCount({ appid })` | Current concurrent player count |
 | `steam_getAchievementStats({ appid })` | Global achievement unlock percentages |
 | `steam_getWorkshopItem({ publishedfileid })` | Workshop item details (title, tags, subscribers) |
+| `steam_getReviews({ appid, filter?, language?, review_type?, purchase_type? })` | User reviews with filters and pagination |
+| `steam_getPriceOverview({ appids, cc })` | Batch price check for multiple apps in a region |
+| `steam_getAppReviewSummary({ appid })` | Review score, totals, and positive percentage |
+| `steam_getRegionalPricing({ appid, countries })` | Pricing breakdown across multiple countries |
 | `steam_getNewsForApp({ appid, count?, maxlength? })` | Recent news and announcements |
 
-**Requires `STEAM_API_KEY` environment variable:**
+**Requires `STEAM_API_KEY` environment variable (7 tools):**
 
 | Tool | Description |
 |------|-------------|
@@ -126,6 +130,19 @@ The [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) provides 25 too
 | `steam_getSchemaForGame({ appid })` | Achievement/stat schema with display names, descriptions, icons |
 | `steam_getPlayerAchievements({ steamid, appid })` | Per-player achievement unlock status and timestamps |
 
+**SDK guidance / publisher key (8 tools):**
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `steam_createLobby({ type, max_members, metadata })` | SDK guide | ISteamMatchmaking lobby creation code examples |
+| `steam_uploadWorkshopItem({ appid, title, ... })` | SDK guide | ISteamUGC Workshop upload code examples |
+| `steam_updateWorkshopItem({ publishedfileid, ... })` | Publisher key | Update Workshop item metadata via partner API |
+| `steam_setAchievement({ steamid, appid, achievement })` | Publisher key | Unlock an achievement (dev/test) |
+| `steam_clearAchievement({ steamid, appid, achievement })` | Publisher key | Re-lock an achievement (dev/test) |
+| `steam_uploadLeaderboardScore({ appid, leaderboardid, ... })` | Publisher key | Upload leaderboard scores |
+| `steam_grantInventoryItem({ appid, steamid, itemdefid })` | Publisher key | Grant inventory items |
+| `steam_getLeaderboardsForGame({ appid })` | Publisher key | List all leaderboards with numeric IDs |
+
 When an MCP tool exists for a given endpoint, prefer it over raw `curl` calls. For endpoints not covered by MCP tools (user stats, microtransactions), continue using the Web API directly.
 
 The Steamworks SDK documentation and example generation logic remain the same regardless of MCP availability.

skills/steam-multiplayer-networking/SKILL.md

@@ -138,9 +138,15 @@ Steam does not provide built-in Elo/MMR. Recommended pattern:
 
 ## MCP Usage
 
-Multiplayer networking uses in-process Steamworks SDK APIs (`ISteamMatchmaking`, `ISteamNetworkingSockets`, `ISteamGameServer`) with no Web API equivalents for lobby creation, P2P connections, or dedicated server management. This skill remains documentation-only regardless of whether the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is available.
+Multiplayer networking uses in-process Steamworks SDK APIs (`ISteamMatchmaking`, `ISteamNetworkingSockets`, `ISteamGameServer`) with no Web API equivalents for P2P connections or dedicated server management.
 
-Write-operation MCP tools for lobby management are planned for v0.7.0.
+| Step | MCP Tool | Auth | Purpose |
+|------|----------|------|---------|
+| Lobby code examples | `steam_createLobby({ type, max_members, metadata })` | SDK guide | Get C++/C#/GDScript code for lobby creation |
+
+The `steam_createLobby` tool returns SDK code examples and documentation, not an HTTP API call. The actual lobby creation happens in-process via the Steamworks SDK.
+
+If the MCP server is not available, use the SDK code examples in the Workflow section above.
 
 ## Common Pitfalls
 

skills/steam-price-history/SKILL.md

@@ -148,7 +148,9 @@ If the user is pricing their own game, provide benchmarks:
 | Multi-region pricing | `steam_getPriceOverview({ appids, cc })` | None | Multiple `curl` calls |
 | Resolve name | `steam_searchApps({ query })` | None | Manual search |
 
-The `steam_getPriceOverview` tool is planned for v0.3.0 of the MCP server. Until available, use `steam_getAppDetails({ appid })` with the `&cc=` parameter for each region.
+For regional pricing across multiple countries in a single call, use `steam_getRegionalPricing({ appid, countries })`.
+
+If the MCP server is not available, fall back to the `curl`-based workflow above.
 
 ## Common Pitfalls
 

skills/steam-pricing-strategy/SKILL.md

@@ -175,9 +175,10 @@ Bundles dynamically adjust price — players who already own some items pay less
 |------|----------|------|---------|
 | Competitor pricing | `steam_getAppDetails({ appid })` | None | Check competitor prices and regional variants |
 | Search competitors | `steam_searchApps({ query })` | None | Find competing games for price benchmarking |
-| Regional pricing | `steam_getPriceOverview({ appids, cc })` | None | Batch price check (planned MCP tool) |
+| Regional pricing | `steam_getPriceOverview({ appids, cc })` | None | Batch price check for multiple apps |
+| Regional breakdown | `steam_getRegionalPricing({ appid, countries })` | None | Pricing across multiple countries |
 
-The `steam_getPriceOverview` tool is planned for the MCP server. Until available, use `steam_getAppDetails` with `&cc=` parameter per region.
+If the MCP server is not available, fall back to `steam_getAppDetails` with `&cc=` parameter per region.
 
 ## Common Pitfalls
 

skills/steam-review-analysis/SKILL.md

@@ -23,7 +23,7 @@ Use this skill when the user:
 
 ## Workflow
 
-> **Preferred:** If the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is available and includes `steam_getReviews()`, use it instead of the `curl` commands below. See [MCP Usage](#mcp-usage).
+> **Preferred:** If the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is available, use `steam_getReviews()` instead of the `curl` commands below. See [MCP Usage](#mcp-usage).
 
 ### 1. Resolve the App ID
 
@@ -128,15 +128,16 @@ Present a structured breakdown:
 
 ## MCP Usage
 
-When the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is configured and includes the review tool:
+When the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is configured:
 
 | Step | MCP Tool | Auth | Replaces |
 |------|----------|------|----------|
-| Fetch reviews | `steam_getReviews({ appid, filter?, language?, count? })` | None | `curl` to `/appreviews/` |
+| Fetch reviews | `steam_getReviews({ appid, filter?, language?, review_type?, purchase_type? })` | None | `curl` to `/appreviews/` |
+| Review summary | `steam_getAppReviewSummary({ appid })` | None | `curl` for score/totals only |
+| Resolve name | `steam_searchApps({ query })` | None | Manual search |
+| Get store context | `steam_getAppDetails({ appid })` | None | `curl` to `appdetails` |
 
-The `steam_getReviews` tool is planned for v0.3.0 of the MCP server. Until available, use the `curl`-based workflow above.
-
-Resolve game names with `steam_searchApps({ query })` and get store context with `steam_getAppDetails({ appid })` (both already available).
+If the MCP server is not available, fall back to the `curl`-based workflow above.
 
 ## Common Pitfalls