feat: add accessibility declarations tools

Author: zelentsov-dev

ASC-COVERAGE-MATRIX-2026-05-05.md

@@ -8,13 +8,14 @@ Source baseline:
 - Apple Webhook notifications: https://developer.apple.com/documentation/appstoreconnectapi/webhook-notifications
 
 Update 2026-05-07: automated OpenAPI coverage tooling is now available. See `ASC-OPENAPI-COVERAGE-GENERATED.md` for the generated Apple 4.3 path/operation matrix.
+Update 2026-05-08: accessibility declaration management is covered by `accessibility_*` tools.
 
 This matrix tracks current `asc-mcp` coverage against the official App Store Connect API documentation. It is intentionally product-oriented: it names what users can do today, what is missing, and which additions should come first.
 
 ## Executive Priority
 
 P0 additions:
-- Accessibility declarations, App Clips, background assets, app tags, routing app coverages, and customer review summaries.
+- App Clips, background assets, app tags, routing app coverages, and customer review summaries.
 
 P1 additions:
 - Webhook receiver-side signature verification, event payload decoder, and triage resources/prompts.
@@ -26,7 +27,7 @@ P1 additions:
 | Area | Status | Priority | Current worker keys | Missing / next |
 |---|---|---:|---|---|
 | Essentials: auth, errors, paging, uploads, rate limits | Partial | P1 | `auth` | API key inventory/revocation helpers |
-| App Store app metadata and release operations | Partial | P0 | `apps`, `versions`, `app_info`, `pricing`, `app_events`, `screenshots`, `custom_pages`, `ppo`, `promoted`, `review_attachments`, `reviews` | accessibility declarations; App Clips; background assets; app tags; routing app coverages; customer review summary endpoint |
+| App Store app metadata and release operations | Partial | P0 | `apps`, `accessibility`, `versions`, `app_info`, `pricing`, `app_events`, `screenshots`, `custom_pages`, `ppo`, `promoted`, `review_attachments`, `reviews` | App Clips; background assets; app tags; routing app coverages; customer review summary endpoint |
 | TestFlight builds, testers, groups, and beta app review | Partial | P0 | `builds`, `build_processing`, `build_beta`, `beta_groups`, `beta_feedback`, `beta_testers`, `beta_app`, `pre_release`, `beta_license` | beta recruitment criteria; beta app clip invocation/localization APIs |
 | Webhook notifications | Covered | P2 | `webhooks` | OpenAPI drift checks and receiver-side helper ergonomics |
 | Webhook notification receiver resources | Missing | P1 | none | signature verification helpers; event payload decoder; prompt/resource templates for event triage |
@@ -41,7 +42,7 @@ P1 additions:
 ## Implementation Order
 
 1. Add `--read-only` runtime guard so static and live validation can run safely in production-like MCP hosts.
-2. Add `AccessibilityWorker` and update `AppsWorker` for `accessibilityUrl`: this closes a new compliance-oriented App Store gap.
+2. Update `AppsWorker` for app-level `accessibilityUrl` if Apple keeps it as a separate app metadata field outside declaration resources.
 3. Add webhook receiver helpers: signature verification, event payload decoder, and triage prompts/resources.
 4. Add merchant/pass identifiers, App Clips, background assets, Game Center, and alternative distribution as larger domain workers.
 

ASC-OPENAPI-COVERAGE-GENERATED.md

@@ -1,6 +1,6 @@
 # App Store Connect OpenAPI Coverage
 
-Generated: 2026-05-07
+Generated: 2026-05-08
 
 Sources:
 - Apple App Store Connect API overview: https://developer.apple.com/app-store-connect/api/
@@ -26,7 +26,7 @@ Unclassified paths: 0
 
 | Domain | Status | Priority | Apple paths | Operations | Workers | Notes |
 |---|---|---:|---:|---:|---|---|
-| App Store app metadata and release operations | Partial | P0 | 303 | 380 | `apps`, `versions`, `app_info`, `pricing`, `app_events`, `screenshots`, `custom_pages`, `ppo`, `promoted`, `review_attachments`, `reviews` | The common release workflow is strong; API 4.0 app-surface additions are the highest App Store coverage gap. |
+| App Store app metadata and release operations | Partial | P0 | 303 | 380 | `apps`, `accessibility`, `versions`, `app_info`, `pricing`, `app_events`, `screenshots`, `custom_pages`, `ppo`, `promoted`, `review_attachments`, `reviews` | The common release workflow is strong; API 4.0 app-surface additions are the highest App Store coverage gap. |
 | TestFlight builds, testers, groups, and beta app review | Partial | P0 | 115 | 154 | `builds`, `build_processing`, `build_beta`, `beta_groups`, `beta_feedback`, `beta_testers`, `beta_app`, `pre_release`, `beta_license` | Current TestFlight management is useful, but feedback retrieval is now core user value and should become a dedicated worker. |
 | Essentials: auth, errors, paging, uploads, rate limits | Partial | P1 | 0 | 0 | `auth` | Core runtime behavior is covered; OpenAPI drift is now generated from Apple's official specification. |
 | Provisioning and identifiers | Partial | P1 | 32 | 49 | `provisioning` | Core signing automation exists; Wallet and Apple Pay identifiers are useful next additions. |

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.3.0] - 2026-05-08
+
+### Added
+
+- Accessibility declaration tools (`accessibility_*`) for listing, reading, creating, updating/publishing, deleting, and relationship-only listing of App Store accessibility declarations by device family.
+
+### Changed
+
+- README worker counts, worker filtering docs, and coverage matrix now reflect 345 tools across 36 worker domains.
+
 ## [2.2.0] - 2026-05-07
 
 ### Added

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 **339 tools** across 35 worker domains, 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 **345 tools** across 36 worker domains, enabling you to automate your entire iOS/macOS release workflow through natural language.
 
 ### Key capabilities
 
@@ -42,6 +42,7 @@
 - **Subscriptions** — subscription CRUD, groups, localizations, prices, offer codes, win-back offers
 - **Provisioning** — bundle IDs, devices, certificates, profiles, capabilities
 - **Marketing** — screenshots, app previews, custom product pages, A/B testing (PPO), promoted purchases
+- **Accessibility declarations** — manage App Store accessibility support declarations by device family
 - **Analytics & Metrics** — sales/financial reports, analytics reports, performance metrics, diagnostics
 - **Metadata management** — localized descriptions, keywords, What's New across all locales
 - **MCP 2025-11-25 surface** — tool annotations, output schemas for stable tools, structured JSON results, and safe result-size metadata
@@ -52,7 +53,7 @@
 ```bash
 # 1. Install via Mint
 brew install mint
-mint install zelentsov-dev/asc-mcp@v2.2.0
+mint install zelentsov-dev/asc-mcp@v2.3.0
 
 # 2. Add to Claude Code with env vars (simplest setup)
 claude mcp add asc-mcp \
@@ -84,7 +85,7 @@ Or use a JSON config file — see [Configuration](#configuration) below.
 brew install mint
 
 # Install asc-mcp from GitHub
-mint install zelentsov-dev/asc-mcp@v2.2.0
+mint install zelentsov-dev/asc-mcp@v2.3.0
 
 # Register in Claude Code
 claude mcp add asc-mcp -- ~/.mint/bin/asc-mcp
@@ -95,13 +96,13 @@ To install a specific branch or tag:
 ```bash
 mint install zelentsov-dev/asc-mcp@main      # main branch
 mint install zelentsov-dev/asc-mcp@develop    # develop branch
-mint install zelentsov-dev/asc-mcp@v2.2.0     # specific tag
+mint install zelentsov-dev/asc-mcp@v2.3.0     # specific tag
 ```
 
 To update to the latest version:
 
 ```bash
-mint install zelentsov-dev/asc-mcp@v2.2.0 --force
+mint install zelentsov-dev/asc-mcp@v2.3.0 --force
 ```
 
 ### Option B: Build from Source
@@ -361,7 +362,7 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
 }
 ```
 
-> **Note:** Windsurf has a 100-tool limit. The server exposes 339 tools by default, so you must use `--workers` to select a subset. See [Worker Filtering](#worker-filtering) below.
+> **Note:** Windsurf has a 100-tool limit. The server exposes 345 tools by default, so you must use `--workers` to select a subset. See [Worker Filtering](#worker-filtering) below.
 
 </details>
 
@@ -370,14 +371,14 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
 
 ### Worker Filtering
 
-The server exposes **339 tools** across 35 worker domains. 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 **345 tools** across 36 worker domains. 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
 asc-mcp --workers apps,builds,versions
 
-# Full release workflow subset (~60 tools, fits within any client limit)
-asc-mcp --workers apps,builds,versions,reviews,beta_groups,iap
+# Full release + App Store compliance subset (~96 tools, fits within 100-tool clients)
+asc-mcp --workers apps,accessibility,builds,versions,reviews,beta_groups,iap
 
 # Monetization focus
 asc-mcp --workers apps,iap,subscriptions,offer_codes,winback,pricing,promoted
@@ -423,6 +424,7 @@ The generated report records Apple spec metadata, path and operation counts, dom
 | `company` | `company_` | 3 | Multi-account management |
 | `auth` | `auth_` | 4 | JWT token tools |
 | `apps` | `apps_` | 9 | App listing, metadata, localizations |
+| `accessibility` | `accessibility_` | 6 | App Store accessibility declarations |
 | `webhooks` | `webhooks_` | 8 | Webhook notifications and deliveries |
 | `xcode_cloud` | `xcode_cloud_` | 30 | Xcode Cloud products, workflows, build runs, artifacts, issues, test results, and SCM |
 | `builds` | `builds_` | 4 | Build management |
@@ -462,7 +464,7 @@ When connected to an LLM client, tool definitions consume context tokens. Here's
 
 | Configuration | Tools | ~Tokens |
 |---|---:|---:|
-| All workers (default) | 339 | **~38,000** |
+| All workers (default) | 345 | **~39,000** |
 | Release workflow: `apps,builds,versions,reviews` | ~57 | ~7,000 |
 | Monetization: `apps,iap,subscriptions,pricing` | ~78 | ~9,000 |
 | TestFlight: `apps,builds,beta_groups,beta_testers` | ~56 | ~6,000 |
@@ -471,11 +473,11 @@ When connected to an LLM client, tool definitions consume context tokens. Here's
 
 **Heaviest workers:** Xcode Cloud (30 tools), Subscriptions (29 tools), InAppPurchases (24 tools), Provisioning (17 tools), Screenshots (16 tools).
 
-For Claude (200K context) ~38K tokens is about 19% of the window. For clients with smaller context windows, use `--workers` to reduce the footprint.
+For Claude (200K context) ~39K tokens is about 20% of the window. For clients with smaller context windows, use `--workers` to reduce the footprint.
 
 ## Available Tools
 
-**339 tools** organized across 35 worker domains (use `--workers` to filter — see [Worker Filtering](#worker-filtering)):
+**345 tools** organized across 36 worker domains (use `--workers` to filter — see [Worker Filtering](#worker-filtering)):
 
 <details>
 <summary><strong>Company Management</strong> — 3 tools</summary>
@@ -517,6 +519,20 @@ For Claude (200K context) ~38K tokens is about 19% of the window. For clients wi
 
 </details>
 
+<details>
+<summary><strong>Accessibility Declarations</strong> — 6 tools</summary>
+
+| Tool | Description |
+|------|-------------|
+| `accessibility_list` | List accessibility declarations for an app |
+| `accessibility_get` | Get one accessibility declaration |
+| `accessibility_create` | Create a declaration for a device family |
+| `accessibility_update` | Update support flags or publish a declaration |
+| `accessibility_delete` | Delete a declaration |
+| `accessibility_list_relationships` | List declaration relationship IDs for an app |
+
+</details>
+
 <details>
 <summary><strong>Webhook Notifications</strong> — 8 tools</summary>
 
@@ -1100,11 +1116,12 @@ Sources/asc-mcp/
 │   ├── HTTPClient.swift            #   Actor-based HTTP with retry logic
 │   ├── JWTService.swift            #   ES256 JWT token generation
 │   └── CompaniesManager.swift      #   Multi-account management
-└── Workers/                        # MCP tool implementations (35 worker domains + MainWorker router)
+└── Workers/                        # MCP tool implementations (36 worker domains + MainWorker router)
     ├── MainWorker/WorkerManager    #   Central tool registry & routing
     ├── CompaniesWorker/            #   company_* tools
     ├── AuthWorker/                 #   auth_* tools
     ├── AppsWorker/                 #   apps_* tools
+    ├── AccessibilityWorker/        #   accessibility_* tools
     ├── BuildsWorker/               #   builds_* tools
     ├── BuildProcessingWorker/      #   builds_*_processing tools
     ├── BuildBetaDetailsWorker/     #   builds_*_beta_* tools

SECURITY.md

@@ -4,6 +4,7 @@
 
 | Version | Supported |
 |---------|-----------|
+| 2.3.x   | Yes       |
 | 2.2.x   | Yes       |
 | 2.1.x   | Yes       |
 | 2.0.x   | Yes       |

Sources/asc-mcp/Core/ASCCoverageInventory.swift

@@ -67,11 +67,12 @@ enum ASCCoverageInventory {
             status: .partial,
             priority: .p0,
             workerKeys: [
-                "apps", "versions", "app_info", "pricing", "app_events",
+                "apps", "accessibility", "versions", "app_info", "pricing", "app_events",
                 "screenshots", "custom_pages", "ppo", "promoted", "review_attachments", "reviews"
             ],
             coveredCapabilities: [
                 "apps, app info, version lifecycle, review responses",
+                "accessibility declarations",
                 "pricing and availability",
                 "in-app events",
                 "screenshots and app previews",
@@ -81,7 +82,6 @@ enum ASCCoverageInventory {
                 "review attachments"
             ],
             missingCapabilities: [
-                "accessibility declarations",
                 "App Clips and advanced App Clip experiences",
                 "background assets",
                 "app tags",

Sources/asc-mcp/Core/Application.swift

@@ -44,6 +44,7 @@ public func runApplication(options: AppRuntimeOptions = AppRuntimeOptions()) asy
         After selecting a company, use:
         - auth_* — authentication
         - apps_* — app management and metadata
+        - accessibility_* — App Store accessibility declarations by device family
         - webhooks_* — webhook notifications and delivery diagnostics
         - xcode_cloud_* — Xcode Cloud products, workflows, builds, artifacts, issues, test results, and SCM resources
         - builds_* — build management

Sources/asc-mcp/Core/ServerVersion.swift

@@ -1,5 +1,5 @@
 import Foundation
 
 enum ServerVersion {
-    static let current = "2.2.0"
+    static let current = "2.3.0"
 }

Sources/asc-mcp/EntryPoint.swift

@@ -67,7 +67,7 @@ struct ASCMCPApp {
         }
 
         let validWorkers: Set<String> = [
-            "company", "auth", "apps", "webhooks", "xcode_cloud", "builds", "build_processing", "build_beta",
+            "company", "auth", "apps", "accessibility", "webhooks", "xcode_cloud", "builds", "build_processing", "build_beta",
             "versions", "reviews", "beta_groups", "beta_feedback", "beta_testers", "iap",
             "provisioning", "app_info", "pricing", "users", "app_events", "analytics",
             "subscriptions", "offer_codes", "winback", "intro_offers", "promo_offers",