fix: rename searchApps param from term to query, add changelog for MCP fixes

TMHSDigital · TMHSDigital · commit 2de89726d522 · 2026-03-28T16:25:24.000-04:00
Matches steam-mcp server v0.5.1: searchApps param renamed to query across 15 files, changelog updated with MCP tool naming fix and v0.5.1 improvements.

Made-with: Cursor
diff --git a/.cursorrules b/.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_searchApps({ query })` not `{ query }`
 - `steam_getWorkshopItem({ publishedfileid })` not `{ fileid }`
 - `steam_getLeaderboardEntries({ appid, leaderboardid, rangestart?, rangeend? })` not `{ id, range }`
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,14 @@ 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).
 
+## [Unreleased]
+
+### Fixed
+
+- **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.
+- **`steam_searchApps` parameter** — Renamed `term` to `query` across all skills, rules, and docs to match steam-mcp server v0.5.1 schema change
+- **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
+
 ## [0.9.0] - 2026-03-28
 
 ### Added
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -76,7 +76,7 @@ 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_searchApps({ query })` | None | Store API `storesearch` |
 | `steam_getPlayerCount({ appid })` | None | `GetNumberOfCurrentPlayers` |
 | `steam_getAchievementStats({ appid })` | None | `GetGlobalAchievementPercentagesForApp` |
 | `steam_getWorkshopItem({ publishedfileid })` | None | `GetPublishedFileDetails` |
diff --git a/ROADMAP.md b/ROADMAP.md
@@ -34,7 +34,7 @@ Read-only tools:
 | Tool | Description |
 |------|-------------|
 | `steam_getAppDetails({ appid })` | Store data (price, reviews, tags, platforms) |
-| `steam_searchApps({ term })` | App search by name |
+| `steam_searchApps({ query })` | 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) |
diff --git a/rules/steam-api-key-usage.mdc b/rules/steam-api-key-usage.mdc
@@ -29,7 +29,7 @@ When a flagged call matches one of these endpoints, suggest the MCP tool:
 
 | Endpoint Pattern | MCP Tool |
 |-----------------|----------|
-| `/api/storesearch/` | `steam_searchApps({ term })` |
+| `/api/storesearch/` | `steam_searchApps({ query })` |
 | `/api/appdetails` | `steam_getAppDetails({ appid })` |
 | `GetNumberOfCurrentPlayers` | `steam_getPlayerCount({ appid })` |
 | `GetGlobalAchievementPercentagesForApp` | `steam_getAchievementStats({ appid })` |
diff --git a/skills/steam-api-reference/SKILL.md b/skills/steam-api-reference/SKILL.md
@@ -108,7 +108,7 @@ The [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) provides 10 too
 | 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_searchApps({ query, 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) |
diff --git a/skills/steam-dlc-expansion-planning/SKILL.md b/skills/steam-dlc-expansion-planning/SKILL.md
@@ -185,7 +185,7 @@ A season pass bundles multiple future DLCs at a discount.
 | Step | MCP Tool | Auth | Purpose |
 |------|----------|------|---------|
 | Verify base game | `steam_getAppDetails({ appid })` | None | Confirm game exists and check current DLC listings |
-| Competitor DLC research | `steam_searchApps({ term })` | None | Find competitor games to benchmark DLC pricing |
+| Competitor DLC research | `steam_searchApps({ query })` | None | Find competitor games to benchmark DLC pricing |
 
 DLC creation and management require the Steamworks Partner site — not available via MCP.
 
diff --git a/skills/steam-game-comparison/SKILL.md b/skills/steam-game-comparison/SKILL.md
@@ -111,7 +111,7 @@ When the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is configu
 
 | Step | MCP Tool | Auth | Replaces |
 |------|----------|------|----------|
-| Resolve game names | `steam_searchApps({ term })` | None | `curl` to `/api/storesearch/` |
+| Resolve game names | `steam_searchApps({ query })` | None | `curl` to `/api/storesearch/` |
 | Fetch store data (per game) | `steam_getAppDetails({ appid })` | None | `curl` to `/api/appdetails` |
 | Current players (per game) | `steam_getPlayerCount({ appid })` | None | `curl` to `GetNumberOfCurrentPlayers` |
 
diff --git a/skills/steam-market-research/SKILL.md b/skills/steam-market-research/SKILL.md
@@ -147,7 +147,7 @@ Provide an overall recommendation: **Strong**, **Moderate**, **Cautious**, or **
 
 | Step | MCP Tool | Auth | Replaces |
 |------|----------|------|----------|
-| Search for games | `steam_searchApps({ term })` | None | `curl` to `storesearch` |
+| Search for games | `steam_searchApps({ query })` | None | `curl` to `storesearch` |
 | Get game details | `steam_getAppDetails({ appid })` | None | `curl` to `appdetails` |
 | Player counts | `steam_getPlayerCount({ appid })` | None | `curl` to `GetNumberOfCurrentPlayers` |
 
diff --git a/skills/steam-migration-guide/SKILL.md b/skills/steam-migration-guide/SKILL.md
@@ -217,7 +217,7 @@ func _process(_delta: float) -> void:
 | Step | MCP Tool | Auth | Purpose |
 |------|----------|------|---------|
 | Verify App ID | `steam_getAppDetails({ appid })` | None | Check if your App ID is live and configured |
-| Search competitors | `steam_searchApps({ term })` | None | Find similar games already on Steam |
+| Search competitors | `steam_searchApps({ query })` | None | Find similar games already on Steam |
 | Check player counts | `steam_getPlayerCount({ appid })` | None | Benchmark against comparable titles |
 | Test achievements | `steam_setAchievement({ steamid, appid, achievement })` | Publisher key | Verify achievements work via partner API |
 | Test leaderboards | `steam_uploadLeaderboardScore({ appid, leaderboardid, steamid, score })` | Publisher key | Verify leaderboard uploads |
diff --git a/skills/steam-price-history/SKILL.md b/skills/steam-price-history/SKILL.md
@@ -146,7 +146,7 @@ If the user is pricing their own game, provide benchmarks:
 |------|----------|------|----------|
 | Get current pricing | `steam_getAppDetails({ appid })` | None | `curl` to `appdetails` |
 | Multi-region pricing | `steam_getPriceOverview({ appids, cc })` | None | Multiple `curl` calls |
-| Resolve name | `steam_searchApps({ term })` | None | Manual search |
+| 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.
 
diff --git a/skills/steam-pricing-strategy/SKILL.md b/skills/steam-pricing-strategy/SKILL.md
@@ -174,7 +174,7 @@ Bundles dynamically adjust price — players who already own some items pay less
 | Step | MCP Tool | Auth | Purpose |
 |------|----------|------|---------|
 | Competitor pricing | `steam_getAppDetails({ appid })` | None | Check competitor prices and regional variants |
-| Search competitors | `steam_searchApps({ term })` | None | Find competing games for price benchmarking |
+| 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) |
 
 The `steam_getPriceOverview` tool is planned for the MCP server. Until available, use `steam_getAppDetails` with `&cc=` parameter per region.
diff --git a/skills/steam-review-analysis/SKILL.md b/skills/steam-review-analysis/SKILL.md
@@ -136,7 +136,7 @@ When the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is configu
 
 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({ term })` and get store context with `steam_getAppDetails({ appid })` (both already available).
+Resolve game names with `steam_searchApps({ query })` and get store context with `steam_getAppDetails({ appid })` (both already available).
 
 ## Common Pitfalls
 
diff --git a/skills/steam-store-lookup/SKILL.md b/skills/steam-store-lookup/SKILL.md
@@ -92,7 +92,7 @@ When the [Steam MCP server](https://github.com/TMHSDigital/steam-mcp) is configu
 
 | Step | MCP Tool | Replaces |
 |------|----------|----------|
-| Search by name | `steam_searchApps({ term })` | `curl` to `/api/storesearch/` |
+| Search by name | `steam_searchApps({ query })` | `curl` to `/api/storesearch/` |
 | Fetch store data | `steam_getAppDetails({ appid, cc?, l? })` | `curl` to `/api/appdetails` |
 
 Both tools require no API key. Optional `cc` (country code) and `l` (language) params support regional/localized results.
diff --git a/skills/steam-store-page-optimizer/SKILL.md b/skills/steam-store-page-optimizer/SKILL.md
@@ -99,7 +99,7 @@ Tags are the primary discoverability mechanism on Steam.
 **Tag research workflow:**
 1. Search for your genre on Steam
 2. Note which tags the top-performing games use
-3. Use `steam_searchApps({ term })` to find competitors
+3. Use `steam_searchApps({ query })` to find competitors
 4. Use `steam_getAppDetails({ appid })` to inspect their tags
 5. Cross-reference with your game's actual features
 
@@ -196,7 +196,7 @@ For a full audit, verify:
 | Step | MCP Tool | Auth | Purpose |
 |------|----------|------|---------|
 | Current page state | `steam_getAppDetails({ appid })` | None | Check existing description, tags, screenshots, price |
-| Competitor research | `steam_searchApps({ term })` | None | Find competing games in the genre |
+| Competitor research | `steam_searchApps({ query })` | None | Find competing games in the genre |
 | Competitor details | `steam_getAppDetails({ appid })` | None | Inspect competitor tags, descriptions, pricing |
 
 ## Common Pitfalls
diff --git a/skills/steam-wishlist-estimates/SKILL.md b/skills/steam-wishlist-estimates/SKILL.md
@@ -163,7 +163,7 @@ Flag that 10,000+ wishlists at launch is often cited as the threshold for "likel
 |------|----------|------|----------|
 | Get store data | `steam_getAppDetails({ appid })` | None | `curl` to `appdetails` |
 | Current players | `steam_getPlayerCount({ appid })` | None | `curl` to `GetNumberOfCurrentPlayers` |
-| Resolve name | `steam_searchApps({ term })` | None | Manual search |
+| Resolve name | `steam_searchApps({ query })` | None | Manual search |
 
 All required MCP tools are already available. No new MCP tools needed for this skill.
 
