fix: rename MCP tool names from dots to underscores for Cursor compatibility

Cursor's MCP bridge can't route tool calls with dots in the name (e.g. steam.getAppDetails) because dots conflict with its internal server-id.toolName routing. Renamed all 20 MCP tool references from dot notation to underscore notation across 34 files: skills, rules, docs, config.

The companion steam-mcp server needs a matching rename in its server.tool() registrations (separate repo).

Made-with: Cursor

Author: 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({ term })` not `{ query }`
-- `steam.getWorkshopItem({ publishedfileid })` not `{ fileid }`
-- `steam.getLeaderboardEntries({ appid, leaderboardid, rangestart?, rangeend? })` not `{ id, range }`
+- `steam_searchApps({ term })` not `{ query }`
+- `steam_getWorkshopItem({ publishedfileid })` not `{ fileid }`
+- `steam_getLeaderboardEntries({ appid, leaderboardid, rangestart?, rangeend? })` not `{ id, range }`

CHANGELOG.md

@@ -10,10 +10,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - **4 new MCP read tools** in companion Steam MCP server (v0.4.0), reaching the target of 20 total tools:
-  - `steam.getReviews` — Fetch user reviews with filters for language, sentiment, purchase type, and pagination (no auth)
-  - `steam.getPriceOverview` — Batch price check for multiple apps in a specific region (no auth)
-  - `steam.getAppReviewSummary` — Review score, total counts, and positive percentage without individual reviews (no auth)
-  - `steam.getRegionalPricing` — Pricing breakdown across multiple countries/regions (no auth)
+  - `steam_getReviews` — Fetch user reviews with filters for language, sentiment, purchase type, and pagination (no auth)
+  - `steam_getPriceOverview` — Batch price check for multiple apps in a specific region (no auth)
+  - `steam_getAppReviewSummary` — Review score, total counts, and positive percentage without individual reviews (no auth)
+  - `steam_getRegionalPricing` — Pricing breakdown across multiple countries/regions (no auth)
 
 ### Changed
 
@@ -40,16 +40,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **steam-testing-sandbox** skill: development sandbox guide — App ID 480 (SpaceWar) usage, test account setup, Steam client console commands, partner test environments, and dev-to-production checklist
 - **6 new MCP write tools** in companion Steam MCP server (v0.3.0):
-  - `steam.createLobby` — SDK guidance for ISteamMatchmaking lobby creation (C++/C#/GDScript)
-  - `steam.uploadWorkshopItem` — SDK guidance for ISteamUGC Workshop uploads (C++/GDScript)
-  - `steam.updateWorkshopItem` — HTTP POST to update Workshop item metadata via partner API
-  - `steam.setAchievement` — HTTP POST to set/unlock achievements via partner API (dev/test)
-  - `steam.uploadLeaderboardScore` — HTTP POST to upload scores via partner API
-  - `steam.grantInventoryItem` — HTTP POST to grant inventory items via partner API
+  - `steam_createLobby` — SDK guidance for ISteamMatchmaking lobby creation (C++/C#/GDScript)
+  - `steam_uploadWorkshopItem` — SDK guidance for ISteamUGC Workshop uploads (C++/GDScript)
+  - `steam_updateWorkshopItem` — HTTP POST to update Workshop item metadata via partner API
+  - `steam_setAchievement` — HTTP POST to set/unlock achievements via partner API (dev/test)
+  - `steam_uploadLeaderboardScore` — HTTP POST to upload scores via partner API
+  - `steam_grantInventoryItem` — HTTP POST to grant inventory items via partner API
 
 ### Changed
 
-- `steam-appid-validation` rule enhanced with MCP live validation — suggests `steam.getAppDetails()` to verify App IDs exist
+- `steam-appid-validation` rule enhanced with MCP live validation — suggests `steam_getAppDetails()` to verify App IDs exist
 - Plugin version bumped to 0.7.0
 - Plugin description updated to reflect 29 skills and 16 MCP tools
 - All documentation updated: README, CLAUDE.md, CONTRIBUTING.md, ROADMAP.md
@@ -88,8 +88,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### MCP Roadmap
 
-- `steam.getAppReviewSummary({ appid })` - review histogram and summary (planned for MCP server)
-- `steam.getRegionalPricing({ appid, countries })` - pricing by region (planned for MCP server)
+- `steam_getAppReviewSummary({ appid })` - review histogram and summary (planned for MCP server)
+- `steam_getRegionalPricing({ appid, countries })` - pricing by region (planned for MCP server)
 
 ## [0.4.0] - 2026-03-28
 
@@ -124,8 +124,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### MCP Roadmap
 
-- `steam.getReviews({ appid, filter, language, count })` - planned for MCP server v0.3.0 (review analysis skill uses curl fallback until available)
-- `steam.getPriceOverview({ appids, cc })` - planned for MCP server v0.3.0 (price history skill uses getAppDetails with cc parameter until available)
+- `steam_getReviews({ appid, filter, language, count })` - planned for MCP server v0.3.0 (review analysis skill uses curl fallback until available)
+- `steam_getPriceOverview({ appids, cc })` - planned for MCP server v0.3.0 (price history skill uses getAppDetails with cc parameter until available)
 
 ## [0.2.0] - 2026-03-27
 

CLAUDE.md

@@ -75,26 +75,26 @@ The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides 20 too
 
 | 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.getReviews({ appid, filter, language })` | None | Store API `appreviews` |
-| `steam.getPriceOverview({ appids, cc })` | None | Store API `appdetails` (price filter) |
-| `steam.getAppReviewSummary({ appid })` | None | Store API `appreviews` (summary only) |
-| `steam.getRegionalPricing({ appid, countries })` | None | Store API `appdetails` (multi-region) |
-| `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` |
-| `steam.createLobby({ type, max_members, metadata })` | SDK guide | ISteamMatchmaking code examples |
-| `steam.uploadWorkshopItem({ appid, title, ... })` | SDK guide | ISteamUGC upload code examples |
-| `steam.updateWorkshopItem({ publishedfileid, ... })` | Publisher key | `IPublishedFileService/UpdateDetails` |
-| `steam.setAchievement({ steamid, appid, achievement })` | Publisher key | `ISteamUserStats/SetUserStatsForGame` |
-| `steam.uploadLeaderboardScore({ appid, leaderboardid, ... })` | Publisher key | `ISteamLeaderboards/SetLeaderboardScore` |
-| `steam.grantInventoryItem({ appid, steamid, itemdefid })` | Publisher key | `IInventoryService/AddItem` |
+| `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_getReviews({ appid, filter, language })` | None | Store API `appreviews` |
+| `steam_getPriceOverview({ appids, cc })` | None | Store API `appdetails` (price filter) |
+| `steam_getAppReviewSummary({ appid })` | None | Store API `appreviews` (summary only) |
+| `steam_getRegionalPricing({ appid, countries })` | None | Store API `appdetails` (multi-region) |
+| `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` |
+| `steam_createLobby({ type, max_members, metadata })` | SDK guide | ISteamMatchmaking code examples |
+| `steam_uploadWorkshopItem({ appid, title, ... })` | SDK guide | ISteamUGC upload code examples |
+| `steam_updateWorkshopItem({ publishedfileid, ... })` | Publisher key | `IPublishedFileService/UpdateDetails` |
+| `steam_setAchievement({ steamid, appid, achievement })` | Publisher key | `ISteamUserStats/SetUserStatsForGame` |
+| `steam_uploadLeaderboardScore({ appid, leaderboardid, ... })` | Publisher key | `ISteamLeaderboards/SetLeaderboardScore` |
+| `steam_grantInventoryItem({ appid, steamid, itemdefid })` | Publisher key | `IInventoryService/AddItem` |
 
 ## Development Workflow
 

README.md

@@ -171,36 +171,36 @@ The [Steam MCP Server](https://github.com/TMHSDigital/steam-mcp) provides live,
 
 | Tool | Description |
 |------|-------------|
-| `steam.getAppDetails` | Store data — price, reviews, tags, platforms |
-| `steam.searchApps` | Search the Steam store by name |
-| `steam.getPlayerCount` | Current concurrent players |
-| `steam.getAchievementStats` | Global achievement unlock percentages |
-| `steam.getWorkshopItem` | Workshop item details |
-| `steam.getReviews` | User reviews with filters for language, sentiment, purchase type |
-| `steam.getPriceOverview` | Batch price check for multiple apps in a region |
-| `steam.getAppReviewSummary` | Review score, totals, and positive percentage |
-| `steam.getRegionalPricing` | Pricing breakdown across multiple countries |
+| `steam_getAppDetails` | Store data — price, reviews, tags, platforms |
+| `steam_searchApps` | Search the Steam store by name |
+| `steam_getPlayerCount` | Current concurrent players |
+| `steam_getAchievementStats` | Global achievement unlock percentages |
+| `steam_getWorkshopItem` | Workshop item details |
+| `steam_getReviews` | User reviews with filters for language, sentiment, purchase type |
+| `steam_getPriceOverview` | Batch price check for multiple apps in a region |
+| `steam_getAppReviewSummary` | Review score, totals, and positive percentage |
+| `steam_getRegionalPricing` | Pricing breakdown across multiple countries |
 
 **Read-only (API key) — 5 tools:**
 
 | Tool | Description |
 |------|-------------|
-| `steam.getPlayerSummary` | Player profile — name, avatar, status |
-| `steam.getOwnedGames` | Game library with playtime |
-| `steam.queryWorkshop` | Search/browse Workshop items |
-| `steam.getLeaderboardEntries` | Leaderboard scores and rankings |
-| `steam.resolveVanityURL` | Convert vanity URL to Steam ID |
+| `steam_getPlayerSummary` | Player profile — name, avatar, status |
+| `steam_getOwnedGames` | Game library with playtime |
+| `steam_queryWorkshop` | Search/browse Workshop items |
+| `steam_getLeaderboardEntries` | Leaderboard scores and rankings |
+| `steam_resolveVanityURL` | Convert vanity URL to Steam ID |
 
 **Write / guidance (publisher key):**
 
 | Tool | Type | Description |
 |------|------|-------------|
-| `steam.createLobby` | SDK guide | Code examples for ISteamMatchmaking lobby creation |
-| `steam.uploadWorkshopItem` | SDK guide | Code examples for ISteamUGC Workshop uploads |
-| `steam.updateWorkshopItem` | HTTP POST | Update Workshop item metadata via partner API |
-| `steam.setAchievement` | HTTP POST | Set/unlock achievements (dev/test) |
-| `steam.uploadLeaderboardScore` | HTTP POST | Upload leaderboard scores |
-| `steam.grantInventoryItem` | HTTP POST | Grant inventory items |
+| `steam_createLobby` | SDK guide | Code examples for ISteamMatchmaking lobby creation |
+| `steam_uploadWorkshopItem` | SDK guide | Code examples for ISteamUGC Workshop uploads |
+| `steam_updateWorkshopItem` | HTTP POST | Update Workshop item metadata via partner API |
+| `steam_setAchievement` | HTTP POST | Set/unlock achievements (dev/test) |
+| `steam_uploadLeaderboardScore` | HTTP POST | Upload leaderboard scores |
+| `steam_grantInventoryItem` | HTTP POST | Grant inventory items |
 
 </details>
 

ROADMAP.md

@@ -33,16 +33,16 @@ Read-only tools:
 
 | Tool | Description |
 |------|-------------|
-| `steam.getAppDetails({ appid })` | Store data (price, reviews, tags, platforms) |
-| `steam.searchApps({ term })` | App search by name |
-| `steam.getPlayerCount({ appid })` | Current concurrent players |
-| `steam.getAchievementStats({ appid })` | Global achievement unlock percentages |
-| `steam.getPlayerSummary({ steamid })` | Profile data (name, avatar, status) |
-| `steam.getOwnedGames({ steamid })` | Game library with playtime |
-| `steam.getWorkshopItem({ publishedfileid })` | Workshop item details |
-| `steam.queryWorkshop({ appid, query_type, count })` | Workshop search/browse |
-| `steam.getLeaderboardEntries({ appid, leaderboardid, rangestart?, rangeend? })` | Leaderboard data |
-| `steam.resolveVanityURL({ vanity })` | Vanity URL to 64-bit Steam ID |
+| `steam_getAppDetails({ appid })` | Store data (price, reviews, tags, platforms) |
+| `steam_searchApps({ term })` | App search by name |
+| `steam_getPlayerCount({ appid })` | Current concurrent players |
+| `steam_getAchievementStats({ appid })` | Global achievement unlock percentages |
+| `steam_getPlayerSummary({ steamid })` | Profile data (name, avatar, status) |
+| `steam_getOwnedGames({ steamid })` | Game library with playtime |
+| `steam_getWorkshopItem({ publishedfileid })` | Workshop item details |
+| `steam_queryWorkshop({ appid, query_type, count })` | Workshop search/browse |
+| `steam_getLeaderboardEntries({ appid, leaderboardid, rangestart?, rangeend? })` | Leaderboard data |
+| `steam_resolveVanityURL({ vanity })` | Vanity URL to 64-bit Steam ID |
 
 ### Skill Updates
 
@@ -71,8 +71,8 @@ Update all 14 existing skills to reference MCP tools where applicable. Replace "
 
 | Tool | Description |
 |------|-------------|
-| `steam.getReviews({ appid, filter, language, count })` | Fetch user reviews |
-| `steam.getPriceOverview({ appids, cc })` | Batch price check across regions |
+| `steam_getReviews({ appid, filter, language, count })` | Fetch user reviews |
+| `steam_getPriceOverview({ appids, cc })` | Batch price check across regions |
 
 ---
 
@@ -114,8 +114,8 @@ Update all 14 existing skills to reference MCP tools where applicable. Replace "
 
 | Tool | Description |
 |------|-------------|
-| `steam.getAppReviewSummary({ appid })` | Review histogram and summary |
-| `steam.getRegionalPricing({ appid, countries })` | Pricing by region |
+| `steam_getAppReviewSummary({ appid })` | Review histogram and summary |
+| `steam_getRegionalPricing({ appid, countries })` | Pricing by region |
 
 ---
 
@@ -149,12 +149,12 @@ Update all 14 existing skills to reference MCP tools where applicable. Replace "
 
 | Tool | Description |
 |------|-------------|
-| `steam.createLobby({ type, maxPlayers, metadata })` | Create multiplayer lobbies |
-| `steam.uploadWorkshopItem({ appid, title, content_path })` | Upload new Workshop items |
-| `steam.updateWorkshopItem({ fileid, changes })` | Update existing Workshop items |
-| `steam.setAchievement({ steamid, achievement })` | Unlock achievements (dev/test) |
-| `steam.uploadLeaderboardScore({ appid, leaderboard, score })` | Upload leaderboard scores |
-| `steam.grantInventoryItem({ steamid, itemdef })` | Grant inventory items (dev/test) |
+| `steam_createLobby({ type, maxPlayers, metadata })` | Create multiplayer lobbies |
+| `steam_uploadWorkshopItem({ appid, title, content_path })` | Upload new Workshop items |
+| `steam_updateWorkshopItem({ fileid, changes })` | Update existing Workshop items |
+| `steam_setAchievement({ steamid, achievement })` | Unlock achievements (dev/test) |
+| `steam_uploadLeaderboardScore({ appid, leaderboard, score })` | Upload leaderboard scores |
+| `steam_grantInventoryItem({ steamid, itemdef })` | Grant inventory items (dev/test) |
 
 ### New Skill
 
@@ -202,10 +202,10 @@ Update all 14 existing skills to reference MCP tools where applicable. Replace "
 
 | Tool | Description |
 |------|-------------|
-| `steam.getReviews({ appid, filter, language, review_type, purchase_type })` | Fetch user reviews with pagination and filters |
-| `steam.getPriceOverview({ appids, cc })` | Batch price check for multiple apps in a region |
-| `steam.getAppReviewSummary({ appid })` | Review score, totals, and positive percentage (no individual reviews) |
-| `steam.getRegionalPricing({ appid, countries })` | Pricing breakdown across multiple countries |
+| `steam_getReviews({ appid, filter, language, review_type, purchase_type })` | Fetch user reviews with pagination and filters |
+| `steam_getPriceOverview({ appids, cc })` | Batch price check for multiple apps in a region |
+| `steam_getAppReviewSummary({ appid })` | Review score, totals, and positive percentage (no individual reviews) |
+| `steam_getRegionalPricing({ appid, countries })` | Pricing breakdown across multiple countries |
 
 ---
 
@@ -254,7 +254,7 @@ Update all 14 existing skills to reference MCP tools where applicable. Replace "
 - [x] ~~App ID validation MCP enhancement~~ - `steam-appid-validation.mdc` updated with live validation via MCP in v0.7.0
 - [x] ~~Migration guide skill~~ - `steam-migration-guide` added in v0.8.0
 - [x] ~~Common Pitfalls sections~~ - added to all 30 skills in v0.8.0
-- [x] ~~getReviews MCP tool~~ - `steam.getReviews` added in v0.9.0
-- [x] ~~getPriceOverview MCP tool~~ - `steam.getPriceOverview` added in v0.9.0
-- [x] ~~getAppReviewSummary MCP tool~~ - `steam.getAppReviewSummary` added in v0.9.0
-- [x] ~~getRegionalPricing MCP tool~~ - `steam.getRegionalPricing` added in v0.9.0
+- [x] ~~getReviews MCP tool~~ - `steam_getReviews` added in v0.9.0
+- [x] ~~getPriceOverview MCP tool~~ - `steam_getPriceOverview` added in v0.9.0
+- [x] ~~getAppReviewSummary MCP tool~~ - `steam_getAppReviewSummary` added in v0.9.0
+- [x] ~~getRegionalPricing MCP tool~~ - `steam_getRegionalPricing` added in v0.9.0