app-store-connect-mcp

module

v0.10.0 Latest Latest Go to latest Published: Oct 26, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/idoo/app-store-connect-mcp

Links

Open Source Insights

README ¶

A goose drives an old boxy car past a WAITING FOR REVIEW sign. In the back seat a guy in a grey hoodie with a bitten apple for a head cheers, and a cartoon Viking laughs while filming it on his phone. Fuzzy dice hang from the mirror.

app-store-connect-mcp

MCP server for App Store Connect. MCP is the plug-in format AI clients like Claude, Cursor and Codex use, so with this one your agent can read and manage your App Store Connect account. Read-only by default, and it asks before anything goes public. The binary is app-store-connect-mcp.

Install

Paste this into whatever AI is writing your app right now (we won't tell):

Set up the app-store-connect-mcp server for me: https://github.com/idoo/app-store-connect-mcp/blob/main/docs/INSTALL.md

Or by hand, in three steps:

curl -fsSL https://github.com/idoo/app-store-connect-mcp/releases/latest/download/install.sh | sh   # or: brew install idoo/tap/app-store-connect-mcp
app-store-connect-mcp auth add                    # asks for your API key, tests it with Apple
app-store-connect-mcp config install claude-code  # or claude-desktop, cursor, codex, vscode, windsurf

Details in docs/INSTALL.md. Upgrading, key rotation and fixes for common errors: docs/FAQ.md.

Compared

	this one	forgeops	zelentsov	Joshua (archived)	`asc`
MCP	+	+	+	+	−
Read-only default	+	−	−	−	−
Asks before publishing	+	−	~	−	~
Injection guard	+	−	−	−	−
Release preflight	+	−	~	−	+
Sales reports	+	−	+	+	+
One binary, any OS	+	+	−	−	+

~ partial

Security

It can't break anything until you let it. Anything public, money-moving or hard to undo for your users and team waits for your yes. Build uploads and Xcode Cloud branch runs don't ask; pull request runs do. A 1-star review that says "ignore previous instructions" is still just a 1-star review. More in docs/SAFETY.md.

What it does

Everything you'd click in App Store Connect: releases, TestFlight, listings, screenshots, reviews, sales, IAPs, signing, Xcode Cloud. For everything else there's raw API access. Tool list, config.

After launch it keeps watching, if you turn on the insights toolset: post-release health with a guard that pauses a phased rollout from cron, a "what's new since yesterday" digest, the analytics funnel, and keyword rank tracking. In Claude Desktop, claude.ai, ChatGPT and VS Code the release checklist, metadata diffs, screenshots, reviews and funnel show up as small interactive views.

A toolset is a group of tools you switch on or off, so your agent only sees what you use. The release, TestFlight, metadata, reviews, reports and screenshots ones are on out of the box. Add others with --toolsets +insights,+signing or ASC_MCP_TOOLSETS=+insights, or ask the agent to turn one on mid-chat. The list is in docs/CONFIG.md.

License

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
app-store-connect-mcp command Command app-store-connect-mcp is the App Store Connect MCP server.	Command app-store-connect-mcp is the App Store Connect MCP server.
internal
app Package app wires configuration, credentials, the App Store Connect client and local state into a tool.Env, and runs the MCP server.	Package app wires configuration, credentials, the App Store Connect client and local state into a tool.Env, and runs the MCP server.
applemeta Package applemeta pins Apple domain tables shared across app-store-connect-mcp: screenshot display types and pixel sizes, App Store locales, field length limits, and Sales and Trends report parameters and date rules.	Package applemeta pins Apple domain tables shared across app-store-connect-mcp: screenshot display types and pixel sizes, App Store locales, field length limits, and Sales and Trends report parameters and date rules.
asc Package asc is the App Store Connect HTTP client: retries, rate limits, pagination, cursors, error hints, compaction, redaction and the read-only guard.	Package asc is the App Store Connect HTTP client: retries, rate limits, pagination, cursors, error hints, compaction, redaction and the read-only guard.
ascrules Package ascrules holds App Store Connect behaviour rules shared by the client and the tool packages: the eventual-consistency read flag and the per-operation "already exists" answers.	Package ascrules holds App Store Connect behaviour rules shared by the client and the tool packages: the eventual-consistency read flag and the per-operation "already exists" answers.
asctest Package asctest provides a fake App Store Connect server that checks every request against the pinned spec.	Package asctest provides a fake App Store Connect server that checks every request against the pinned spec.
auth Package auth signs App Store Connect ES256 JWTs (team and individual keys) and caches tokens per profile.	Package auth signs App Store Connect ES256 JWTs (team and individual keys) and caches tokens per profile.
config Package config loads profiles, project pins, environment and mode flags, and checks config file permissions.	Package config loads profiles, project pins, environment and mode flags, and checks config file permissions.
mcpserver Package mcpserver builds the MCP server from the tool registry: toolsets, read-only withholding, plans, elicitation, resources, prompts and transports.	Package mcpserver builds the MCP server from the tool registry: toolsets, read-only withholding, plans, elicitation, resources, prompts and transports.
metadata Package metadata is the App Store listing-metadata engine shared by release_prepare (What's New) and the metadata_* tools: it pulls version and app-info localizations, diffs a desired listing against them, applies the resulting plan, and reads/writes the fastlane, Expo and JSON formats.	Package metadata is the App Store listing-metadata engine shared by release_prepare (What's New) and the metadata_* tools: it pulls version and app-info localizations, diffs a desired listing against them, applies the resulting plan, and reads/writes the fastlane, Expo and JSON formats.
netpolicy Package netpolicy is the single "may this server connect here" address predicate shared by every unauthenticated egress path (the asc fetcher and the release_status URL probes).	Package netpolicy is the single "may this server connect here" address predicate shared by every unauthenticated egress path (the asc fetcher and the release_status URL probes).
reports Package reports decodes and aggregates sales, finance and analytics report files.	Package reports decodes and aggregates sales, finance and analytics report files.
resolve Package resolve implements tool.Resolver: it turns the references people use ("Hjul", "latest", "German", "External testers") into App Store Connect ids using only the tool.ASC interface.	Package resolve implements tool.Resolver: it turns the references people use ("Hjul", "latest", "German", "External testers") into App Store Connect ids using only the tool.ASC interface.
secrets Package secrets holds the private-key and token patterns shared by the redactor ([asc.Redact]) and the approval-prompt warning ([tool.LooksLikeSecret]), so the two can never disagree about what a key looks like.	Package secrets holds the private-key and token patterns shared by the redactor ([asc.Redact]) and the approval-prompt warning ([tool.LooksLikeSecret]), so the two can never disagree about what a key looks like.
spec Package spec embeds the App Store Connect OpenAPI index and implements search, describe, validate and the sensitive-operation list.	Package spec embeds the App Store Connect OpenAPI index and implements search, describe, validate and the sensitive-operation list.
spec/gen command Command gen builds internal/spec/index.json.gz and PROVENANCE.json from Apple's App Store Connect OpenAPI document.	Command gen builds internal/spec/index.json.gz and PROVENANCE.json from Apple's App Store Connect OpenAPI document.
state Package state persists cursors and upload resume records in the XDG state directory.	Package state persists cursors and upload resume records in the XDG state directory.
tool Package tool is the contract every app-store-connect-mcp tool is written against: tool declaration (Meta, Class, Toolset, ConfirmMode), the registry, the Env of dependencies a handler may use (all interfaces, implemented elsewhere), result and error helpers, and the confirm/plan gates.	Package tool is the contract every app-store-connect-mcp tool is written against: tool declaration (Meta, Class, Toolset, ConfirmMode), the registry, the Env of dependencies a handler may use (all interfaces, implemented elsewhere), result and error helpers, and the confirm/plan gates.
tool/tooltest Package tooltest provides in-memory fakes of every tool.Env dependency and helpers to call tools directly, so tool slices unit-test handlers without the MCP server or network.	Package tooltest provides in-memory fakes of every tool.Env dependency and helpers to call tools directly, so tool slices unit-test handlers without the MCP server or network.
tools/admin Package admin registers the admin toolset: team users and invitations.	Package admin registers the admin toolset: team users and invitations.
tools/all Package all links every domain tool package so their init functions register tools with internal/tool.	Package all links every domain tool package so their init functions register tools with internal/tool.
tools/core Package core registers the core toolset: diagnostics, toolset control, app lookup and the spec-backed generic API layer (asc_api_*).	Package core registers the core toolset: diagnostics, toolset control, app lookup and the spec-backed generic API layer (asc_api_*).
tools/docsgen command Command docsgen writes docs/tools.json and docs/TOOLS.md from the tool registry.	Command docsgen writes docs/tools.json and docs/TOOLS.md from the tool registry.
tools/insights Package insights holds the optional insights toolset: cross-source summaries such as release health, digests and analytics funnels.	Package insights holds the optional insights toolset: cross-source summaries such as release health, digests and analytics funnels.
tools/metadata Package metadata registers the metadata toolset: App Store localized metadata pull/plan/apply and app info updates.	Package metadata registers the metadata toolset: App Store localized metadata pull/plan/apply and app info updates.
tools/monetization Package monetization registers the monetization toolset: in-app purchases, subscriptions, pricing, availability and offers.	Package monetization registers the monetization toolset: in-app purchases, subscriptions, pricing, availability and offers.
tools/release Package release registers the release toolset: App Store release workflow: readiness preflight, version preparation, submission, publishing, phased release and builds.	Package release registers the release toolset: App Store release workflow: readiness preflight, version preparation, submission, publishing, phased release and builds.
tools/reports Package reports registers the reports toolset: sales, finance and analytics reports and the insights summary.	Package reports registers the reports toolset: sales, finance and analytics reports and the insights summary.
tools/reviews Package reviews registers the reviews toolset: customer reviews and public responses.	Package reviews registers the reviews toolset: customer reviews and public responses.
tools/screenshots Package screenshots registers the screenshots toolset: screenshot and app preview sets: listing, sync and preview uploads.	Package screenshots registers the screenshots toolset: screenshot and app preview sets: listing, sync and preview uploads.
tools/signing Package signing registers the signing toolset: bundle IDs, capabilities, certificates, profiles and devices.	Package signing registers the signing toolset: bundle IDs, capabilities, certificates, profiles and devices.
tools/store Package store registers the store toolset: public iTunes Search/Lookup (no authentication).	Package store registers the store toolset: public iTunes Search/Lookup (no authentication).
tools/testflight Package testflight registers the testflight toolset: TestFlight beta groups, testers, build distribution, feedback and build expiry.	Package testflight registers the testflight toolset: TestFlight beta groups, testers, build distribution, feedback and build expiry.
tools/uploads Package uploads registers the uploads toolset: IPA/PKG build uploads through the BuildUpload API.	Package uploads registers the uploads toolset: IPA/PKG build uploads through the BuildUpload API.
tools/webhooks Package webhooks registers the webhooks toolset: App Store Connect webhook subscriptions.	Package webhooks registers the webhooks toolset: App Store Connect webhook subscriptions.
tools/xcodecloud Package xcodecloud registers the xcodecloud toolset: Xcode Cloud workflows and build runs.	Package xcodecloud registers the xcodecloud toolset: Xcode Cloud workflows and build runs.
upload Package upload implements App Store Connect uploads: the asset flow (screenshots, previews, review screenshots, IAP/subscription images) and the BuildUpload flow for IPA/PKG files with resumable parts.	Package upload implements App Store Connect uploads: the asset flow (screenshots, previews, review screenshots, IAP/subscription images) and the BuildUpload flow for IPA/PKG files with resumable parts.
skills Package skills embeds app-store-connect-mcp's Agent Skills (skills/<name>/SKILL.md) so `app-store-connect-mcp skills install` can copy them into an agent's user skills directory.	Package skills embeds app-store-connect-mcp's Agent Skills (skills/<name>/SKILL.md) so `app-store-connect-mcp skills install` can copy them into an agent's user skills directory.