feat: add screenshots_upload_batch for multi-file upload + core API audit (293 tools)

New tool:
- screenshots_upload_batch: upload multiple screenshots to a set in one call
  Accepts set_id + file_paths array, uploads each sequentially (reserve→upload→commit)
  Returns per-file results with success/failure status

Core API audit: confirmed 100% coverage of everyday developer workflows
- App management, version localizations, categories, pricing
- TestFlight, subscriptions, IAP, reviews, provisioning
- No critical gaps found in Tier 1/2 functionality

Total: 33 workers, 293 tools, 436 tests

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: zelentsov-dev

CLAUDE.md

@@ -16,7 +16,7 @@ MCP (Model Context Protocol) server for App Store Connect API integration, desig
 # Build the project
 swift build
 
-# Run all unit tests (435 tests)
+# Run all unit tests (436 tests)
 swift test
 
 # Run the MCP server (requires environment variables or companies.json)
@@ -49,7 +49,7 @@ Each company needs: `keyID`, `issuerID`, `privateKeyPath` (path to `.p8` file).
 
 **WorkerManager** (`Workers/MainWorker/WorkerManager.swift`) — central registry, routes tool calls by prefix.
 
-**Workers** (33 workers, 292 tools):
+**Workers** (33 workers, 293 tools):
 
 | Worker | Prefix | Tools | Domain |
 |--------|--------|-------|--------|
@@ -79,7 +79,7 @@ Each company needs: `keyID`, `issuerID`, `privateKeyPath` (path to `.p8` file).
 | BetaAppWorker | `beta_app_` | 10 | Beta app localizations, review submissions, review details |
 | PreReleaseVersionsWorker | `pre_release_` | 3 | Pre-release versions (list, get, builds) |
 | BetaLicenseAgreementsWorker | `beta_license_` | 3 | Beta license agreements (list, get, update) |
-| ScreenshotsWorker | `screenshots_` | 15 | Screenshots, previews, sets, reorder, full upload |
+| ScreenshotsWorker | `screenshots_` | 16 | Screenshots, previews, sets, reorder, full upload, batch upload |
 | CustomProductPagesWorker | `custom_pages_` | 10 | Custom product pages, versions, localizations |
 | ProductPageOptimizationWorker | `ppo_` | 9 | A/B test experiments, treatments |
 | PromotedPurchasesWorker | `promoted_` | 9 | Promoted in-app purchases, images upload |
@@ -110,7 +110,7 @@ Each company needs: `keyID`, `issuerID`, `privateKeyPath` (path to `.p8` file).
 ### Unit Tests (Swift Testing)
 
 ```bash
-swift test    # Run all 435 tests across 31 suites
+swift test    # Run all 436 tests across 31 suites
 ```
 
 Test categories:

README.md

@@ -29,7 +29,7 @@
 
 ## Overview
 
-**asc-mcp** is a Swift-based MCP server that bridges [Claude](https://claude.ai) (or any MCP-compatible host) with the [App Store Connect API](https://developer.apple.com/documentation/appstoreconnectapi). It exposes **292 tools** across 33 workers, enabling you to automate your entire iOS/macOS release workflow through natural language.
+**asc-mcp** is a Swift-based MCP server that bridges [Claude](https://claude.ai) (or any MCP-compatible host) with the [App Store Connect API](https://developer.apple.com/documentation/appstoreconnectapi). It exposes **293 tools** across 33 workers, enabling you to automate your entire iOS/macOS release workflow through natural language.
 
 ### Key capabilities
 
@@ -368,7 +368,7 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
 
 ### Worker Filtering
 
-The server exposes **292 tools** across 33 workers. Some MCP clients impose a tool limit (e.g., Windsurf caps at 100). Use `--workers` to enable only the workers you need:
+The server exposes **293 tools** across 33 workers. Some MCP clients impose a tool limit (e.g., Windsurf caps at 100). Use `--workers` to enable only the workers you need:
 
 ```bash
 # Only load apps, builds, and version lifecycle tools
@@ -432,7 +432,7 @@ For Claude (200K context) ~22K tokens is ~5–7% — negligible. For clients wit
 
 ## Available Tools
 
-**292 tools** organized across 33 workers (use `--workers` to filter — see [Worker Filtering](#worker-filtering)):
+**293 tools** organized across 33 workers (use `--workers` to filter — see [Worker Filtering](#worker-filtering)):
 
 <details>
 <summary><strong>Company Management</strong> — 3 tools</summary>

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

@@ -273,6 +273,100 @@ extension ScreenshotsWorker {
         }
     }
 
+    /// Uploads multiple screenshots to a set sequentially
+    /// - Returns: JSON array with results for each file (success or error)
+    func uploadScreenshotBatch(_ params: CallTool.Parameters) async throws -> CallTool.Result {
+        guard let arguments = params.arguments,
+              let setId = arguments["set_id"]?.stringValue,
+              let filePaths = arguments["file_paths"]?.arrayValue?.compactMap({ $0.stringValue }),
+              !filePaths.isEmpty else {
+            return CallTool.Result(
+                content: [.text("Error: Required parameters: set_id, file_paths (non-empty array)")],
+                isError: true
+            )
+        }
+
+        var results: [[String: Any]] = []
+        var successCount = 0
+        var failCount = 0
+
+        for filePath in filePaths {
+            do {
+                // Step 1: Get file info
+                let fileSize = try await uploadService.fileSize(at: filePath)
+                let fileName = await uploadService.fileName(at: filePath)
+
+                // Step 2: Reserve
+                let createRequest = CreateScreenshotRequest(
+                    data: CreateScreenshotRequest.CreateData(
+                        attributes: CreateScreenshotRequest.Attributes(
+                            fileName: fileName,
+                            fileSize: fileSize
+                        ),
+                        relationships: CreateScreenshotRequest.Relationships(
+                            appScreenshotSet: CreateScreenshotRequest.ScreenshotSetRelationship(
+                                data: ASCResourceIdentifier(type: "appScreenshotSets", id: setId)
+                            )
+                        )
+                    )
+                )
+
+                let encoder = JSONEncoder()
+                let bodyData = try encoder.encode(createRequest)
+                let reserveData = try await httpClient.post("/v1/appScreenshots", body: bodyData)
+                let reserveResponse = try JSONDecoder().decode(ASCScreenshotResponse.self, from: reserveData)
+
+                let screenshotId = reserveResponse.data.id
+                guard let uploadOperations = reserveResponse.data.attributes?.uploadOperations, !uploadOperations.isEmpty else {
+                    results.append(["file": fileName, "success": false, "error": "No upload operations returned"])
+                    failCount += 1
+                    continue
+                }
+
+                // Step 3: Upload chunks
+                let md5 = try await uploadService.uploadFile(filePath: filePath, uploadOperations: uploadOperations)
+
+                // Step 4: Commit
+                let commitRequest = CommitScreenshotRequest(
+                    data: CommitScreenshotRequest.CommitData(
+                        id: screenshotId,
+                        attributes: CommitScreenshotRequest.Attributes(
+                            sourceFileChecksum: md5,
+                            uploaded: true
+                        )
+                    )
+                )
+
+                let commitBody = try encoder.encode(commitRequest)
+                let commitData = try await httpClient.patch("/v1/appScreenshots/\(screenshotId)", body: commitBody)
+                let commitResponse = try JSONDecoder().decode(ASCScreenshotResponse.self, from: commitData)
+
+                results.append([
+                    "file": fileName,
+                    "success": true,
+                    "screenshot_id": commitResponse.data.id,
+                    "state": commitResponse.data.attributes?.assetDeliveryState?.state ?? "unknown"
+                ] as [String: Any])
+                successCount += 1
+
+            } catch {
+                let fileName = URL(fileURLWithPath: filePath).lastPathComponent
+                results.append(["file": fileName, "success": false, "error": error.localizedDescription] as [String: Any])
+                failCount += 1
+            }
+        }
+
+        let response: [String: Any] = [
+            "success": failCount == 0,
+            "total": filePaths.count,
+            "uploaded": successCount,
+            "failed": failCount,
+            "results": results
+        ]
+
+        return CallTool.Result(content: [.text(JSONFormatter.formatJSON(response))])
+    }
+
     /// Gets details of a specific screenshot
     /// - Returns: JSON with screenshot details
     func getScreenshot(_ params: CallTool.Parameters) async throws -> CallTool.Result {

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

@@ -298,6 +298,30 @@ extension ScreenshotsWorker {
         )
     }
 
+    func uploadScreenshotBatchTool() -> Tool {
+        return Tool(
+            name: "screenshots_upload_batch",
+            description: "Upload multiple screenshots to a screenshot set in one call. Each file goes through the full upload cycle (reserve, upload, commit). Returns results for each file.",
+            inputSchema: .object([
+                "type": .string("object"),
+                "properties": .object([
+                    "set_id": .object([
+                        "type": .string("string"),
+                        "description": .string("Screenshot set ID")
+                    ]),
+                    "file_paths": .object([
+                        "type": .string("array"),
+                        "description": .string("Array of absolute paths to screenshot files on disk"),
+                        "items": .object([
+                            "type": .string("string")
+                        ])
+                    ])
+                ]),
+                "required": .array([.string("set_id"), .string("file_paths")])
+            ])
+        )
+    }
+
     func deletePreviewTool() -> Tool {
         return Tool(
             name: "screenshots_delete_preview",

Sources/asc-mcp/Workers/ScreenshotsWorker/ScreenshotsWorker.swift

@@ -28,7 +28,8 @@ public final class ScreenshotsWorker: Sendable {
             uploadPreviewTool(),
             getPreviewTool(),
             listPreviewsTool(),
-            deletePreviewTool()
+            deletePreviewTool(),
+            uploadScreenshotBatchTool()
         ]
     }
 
@@ -65,6 +66,8 @@ public final class ScreenshotsWorker: Sendable {
             return try await listPreviews(params)
         case "screenshots_delete_preview":
             return try await deletePreview(params)
+        case "screenshots_upload_batch":
+            return try await uploadScreenshotBatch(params)
         default:
             throw MCPError.methodNotFound("Unknown tool: \(params.name)")
         }

Tests/ASCMCPTests/Workers/ParameterValidationTests.swift

@@ -935,6 +935,15 @@ struct ParameterValidationTests {
         #expect(result.isError == true)
     }
 
+    @Test("screenshots_upload_batch without required params returns isError")
+    func screenshotsUploadBatchMissing() async throws {
+        let client = try await TestFactory.makeHTTPClient()
+        let worker = ScreenshotsWorker(httpClient: client, uploadService: UploadService())
+        let params = CallTool.Parameters(name: "screenshots_upload_batch", arguments: nil)
+        let result = try await worker.handleTool(params)
+        #expect(result.isError == true)
+    }
+
     @Test("screenshots_delete without screenshot_id returns isError")
     func screenshotsDeleteMissing() async throws {
         let client = try await TestFactory.makeHTTPClient()

Tests/ASCMCPTests/Workers/WorkerToolDefinitionsTests.swift

@@ -483,7 +483,7 @@ struct WorkerToolDefinitionsTests {
         let client = try await TestFactory.makeHTTPClient()
         let worker = ScreenshotsWorker(httpClient: client, uploadService: UploadService())
         let tools = await worker.getTools()
-        #expect(tools.count == 15)
+        #expect(tools.count == 16)
         let names = Set(tools.map(\.name))
         #expect(names.contains("screenshots_list_sets"))
         #expect(names.contains("screenshots_create_set"))
@@ -500,6 +500,7 @@ struct WorkerToolDefinitionsTests {
         #expect(names.contains("screenshots_get_preview"))
         #expect(names.contains("screenshots_list_previews"))
         #expect(names.contains("screenshots_delete_preview"))
+        #expect(names.contains("screenshots_upload_batch"))
     }
 
     // MARK: - CustomProductPagesWorker (10 tools)