MCP Server
App Store Connect
in your AI agent
Asomium ships 42 MCP tools that expose the whole release workflow — metadata, screenshots, ASO, revenue, build, submit — to Claude Code, Cursor, Windsurf, or Claude Dispatch on your phone.
Connect in under a minute
Install Asomium
Download the Mac app. The MCP server ships inside the bundle. 3-day free trial, no API key required.
Download Asomium →Click Connect
Open Asomium → Settings → AI Integration. Asomium auto-detects Claude Code, Claude Desktop, Cursor, and Windsurf. Click Connect next to the one you use — done. No terminal required.
Ask your agent
Plain English. Claude picks the right tools, chains them, and reports back. Examples below.
Prefer the terminal? Manual snippet →
claude mcp add asomium /Applications/Asomium.app/Contents/MacOS/asomium-mcp For Cursor / Windsurf / Zed see the MCP setup docs for client-specific config blocks. All four register the same binary path.
Just ask your agent
› “pull the German metadata for my Renovise app and translate the new subtitle to every locale, respecting char limits”
› “what are my top 10 keywords this week, render a chart of rank movement”
› “build and submit the next iOS Pro version for review, attach the new build, declare encryption-free”
› “show me last week's sales by country plus the impression → download funnel”
› “respond to the new 1-star reviews with a polite apology and a note about the upcoming fix”
› “create a phased release for v2.4, start at 1% and pause if reviews drop”
Claude picks the tools, chains them, and reports back with the result. Submit-for-review chains can finish in under a minute end-to-end.
All 42 tools
Every Asomium action — also reachable from your AI agent.
Metadata
Pull, edit, validate, and push App Store listings across every locale.
-
asomium_pull_metadataFetch the editable AppStoreVersion for an app across every locale
-
asomium_push_metadataWrite edits back to App Store Connect — atomic across locales
-
asomium_bulk_push_metadataPush curated fields for multiple apps in one call
-
asomium_validate_metadataDry-run char-limit and required-field checks before pushing
-
asomium_translate_fieldTranslate one field into N locales via Claude, char-aware
-
asomium_expand_englishExpand a seed term into 100 ranked keyword candidates
-
asomium_snapshot_metadataCapture current ASC state to disk for later diffing
-
asomium_list_metadata_snapshotsList archived metadata snapshots for an app
-
asomium_diff_metadataCompare two snapshots and surface what changed
ASO & Keywords
Discover, track, and benchmark App Store keywords + competitors.
-
asomium_discover_keywordsAutocomplete-sweep new keyword opportunities for a seed
-
asomium_keyword_rankGet your app's current rank for a specific keyword
-
asomium_track_keywordPersist a keyword for daily rank tracking
-
asomium_untrack_keywordStop tracking a keyword
-
asomium_list_tracked_keywordsList every tracked keyword across all apps with latest ranks
-
asomium_refresh_tracked_ranksManually re-poll all tracked keyword ranks
-
asomium_competitor_intelRead another app's title / subtitle / keywords / screenshots
Build & Ship
Take a build from xcodebuild archive all the way to App Store review.
-
asomium_build_and_shipxcodebuild archive → export → upload → optional submit chain
-
asomium_build_and_distribute_directDirect-distribution counterpart: archive → sign → notarize → staple → DMG
-
asomium_bump_xcode_versionBump MARKETING_VERSION / CURRENT_PROJECT_VERSION via agvtool
-
asomium_create_versionCreate a new AppStoreVersion (auto-version-bump or explicit)
-
asomium_list_buildsList recent App Store Connect builds for a platform
-
asomium_upload_screenshotsUpload PNG screenshots from disk to a specific app + locale
-
asomium_submit_for_reviewSelf-healing submit: encryption flag, build attach, support URL
-
asomium_release_nowManually release an approved version to the store
-
asomium_set_release_strategyConfigure manual / auto / scheduled release for the next version
-
asomium_phased_release_controlStatus / pause / resume / release-to-all / cancel phased release
TestFlight
Ship the same build to internal or external beta groups, with per-group What-to-test notes.
-
asomium_list_beta_groupsList internal + external TestFlight groups for an app
-
asomium_submit_for_beta_reviewAttach a build to TestFlight groups, set What-to-test, optionally submit for Beta App Review
Async jobs
Track long-running builds + submissions across chat sessions — pick up where you left off.
-
asomium_list_jobsList recent async jobs newest-first, even from earlier chat sessions
-
asomium_job_statusPoll a job for state, current stage, last ~50 log lines, and final result
-
asomium_cancel_jobRequest cancellation; the worker exits between phases when it sees the flag
App settings
Adjust categories, privacy nutrition labels, and per-app config.
-
asomium_list_appsList all apps under the configured ASC team
-
asomium_list_iapsList in-app purchases configured for an app
-
asomium_list_in_app_eventsList scheduled In-App Events for an app
-
asomium_update_app_categoriesSet primary/secondary App Store categories
-
asomium_update_app_privacySet or update privacy nutrition labels
Reviews
Read App Store reviews and respond inline.
-
asomium_review_statusHistogram of star ratings + latest user reviews
-
asomium_respond_to_reviewPost a developer response to a specific review
Revenue & analytics
Pull real sales data and render it as charts or full dashboards.
-
asomium_get_sales_reportDaily/weekly/monthly sales rollups from Sales & Trends API
-
asomium_render_chartSVG chart fallback for terminal clients without artifact support
-
asomium_dashboardComposite executive-summary artifact: versions + builds + ranks + reviews + sales
Account
Check usage, manage MCP-specific state.
-
asomium_usage_statusTranslate-call counter for current month + quota status
Ship a release from your phone
Asomium's MCP server works over Claude Dispatch — so you can submit an App Store update from the iOS Claude app on your phone, talking to your Mac. Useful for the “something is on fire and I'm in line at the bakery” case.
Yes, this works. Yes, we've done it. Yes, it's silly.
MCP FAQ
What is MCP? ▾
Model Context Protocol — Anthropic's open standard for letting AI agents call external tools and read external data. Claude Code, Cursor, Windsurf, Zed, and Claude Dispatch all support it. Think “Stripe API but standardised across every AI client”.
Do I need an API key? ▾
No. The MCP server runs locally inside the Asomium app bundle and reads the App Store Connect credentials you've already entered in the GUI. Nothing leaves your Mac except the outbound HTTPS calls to Apple — the same calls the GUI would make.
What about safety? Can my AI agent accidentally ship a broken build? ▾
Submit-for-review and metadata pushes are explicit, named tool
calls — Claude won't fire them without you asking. For
high-stakes actions (release_now, push_metadata against
production), most AI clients also show you the exact JSON
arguments before executing.
validate_metadata is the dry-run path.
Can the same MCP server work from a remote machine? ▾
v1.x runs as a local stdio transport — the AI client spawns the binary on your Mac. v1.2+ will add an optional HTTP transport so Cursor running on a colleague's Mac (or your phone) can hit your Asomium server via Tailscale / Cloudflare Tunnel.
Are the tool calls counted against my plan? ▾
For read-only tools (pull, list, rank), no — they hit Apple's
APIs directly with your key. Translation calls (translate_field,
expand_english) consume AsoAI quota from your plan — current
month counter is visible via usage_status or in
Settings → Subscription.
Give your AI agent App Store powers
Download Asomium, install the MCP server with one command, and ask Claude to ship your next release.