docs: improve tool descriptions for accuracy and clarity

- Add phased_release_id hint to update_phased_release description
- Add territory schedules note to app_events_update
- Clarify beta_testers_search: exact email match only
- Add locale format guidance to apps_create_localization
- Clarify territory param as ISO 3166-1 alpha-2 in reviews_list
- Add expired builds hint (90+ days) to encryption error message

Author: zelentsov-dev

Sources/asc-mcp/Workers/AppEventsWorker/AppEventsWorker+ToolDefinitions.swift

@@ -94,7 +94,7 @@ extension AppEventsWorker {
     func updateAppEventTool() -> Tool {
         return Tool(
             name: "app_events_update",
-            description: "Update an existing in-app event",
+            description: "Update an existing in-app event. Territory schedules are NOT modified by this tool.",
             inputSchema: .object([
                 "type": .string("object"),
                 "properties": .object([

Sources/asc-mcp/Workers/AppLifecycleWorker/AppLifecycleWorker+ToolDefinitions.swift

@@ -236,7 +236,7 @@ extension AppLifecycleWorker {
     func updatePhasedReleaseTool() -> Tool {
         Tool(
             name: "app_versions_update_phased_release",
-            description: "Update phased release state (pause/resume/complete)",
+            description: "Update phased release state (pause/resume/complete). Get phased_release_id from app_versions_create_phased_release response.",
             inputSchema: .object([
                 "type": .string("object"),
                 "properties": .object([

Sources/asc-mcp/Workers/AppsWorker/AppsWorker+ToolDefinitions.swift

@@ -188,7 +188,7 @@ extension AppsWorker {
     func createLocalizationTool() -> Tool {
         return Tool(
             name: "apps_create_localization",
-            description: "Создает новую локализацию для версии приложения",
+            description: "Создает новую локализацию для версии приложения. Locale format depends on language: ru, ja (language only) vs en-US, de-DE (with region). Use apps_list_localizations to see existing locales.",
             inputSchema: .object([
                 "type": .string("object"),
                 "properties": .object([

Sources/asc-mcp/Workers/BetaTestersWorker/BetaTestersWorker+ToolDefinitions.swift

@@ -31,7 +31,7 @@ extension BetaTestersWorker {
     func searchBetaTestersTool() -> Tool {
         return Tool(
             name: "beta_testers_search",
-            description: "Search beta tester by email address",
+            description: "Search beta tester by email address. Exact email match only. Partial/wildcard not supported.",
             inputSchema: .object([
                 "type": .string("object"),
                 "properties": .object([

Sources/asc-mcp/Workers/BuildProcessingWorker/BuildProcessingWorker+Handlers.swift

@@ -94,7 +94,7 @@ extension BuildProcessingWorker {
                   let dataObj = declarationJson["data"] as? [String: Any],
                   let declarationId = dataObj["id"] as? String else {
                 return CallTool.Result(
-                    content: [.text("Error: Could not parse encryption declaration response for build \(buildId). The build may not have an encryption declaration.")],
+                    content: [.text("Error: Could not parse encryption declaration response for build \(buildId). The build may not have an encryption declaration. Note: builds older than 90 days may have expired and no longer support this operation.")],
                     isError: true
                 )
             }

Sources/asc-mcp/Workers/ReviewsWorker/ReviewsWorker+ToolDefinitions.swift

@@ -31,7 +31,7 @@ extension ReviewsWorker {
                     ]),
                     "territory": .object([
                         "type": .string("string"),
-                        "description": .string("Filter by territory code (e.g., US, RU, DE)")
+                        "description": .string("ISO 3166-1 alpha-2 territory code (US, RU, DE, JP)")
                     ]),
                     "sort": .object([
                         "type": .string("string"),