Heimdall — App Store Connect MCP
Your whole App Store Connect account, in one app.

🇬🇧 English · 🇹🇷 Türkçe
I released Heimdall a few months ago. Since then it has been downloaded more than 10,000 times from npm, more than 3,600 of them in the last month alone. It has passed 60 stars on GitHub, with 41 releases in 4 months. Thank you all for the interest.
Ask, and it answers. Tell it, and it's done.
- "Summarize this week's 1-star reviews and draft replies."
- "Which builds are stuck in review?"
- "Raise this subscription's price in every country."
- "What does this subscription cost in each country?"
- "Which screenshots are on the store listing?"
- "Add build 42 to the Internal and External groups."
- "Why did my Xcode Cloud build fail?"
Almost anything you'd click through App Store Connect to do, you can now just ask your AI to do. More examples in the Guide.
A real AI session, sped up. The App Store Connect account is a stand-in so the recording can be public.
Heimdall
One package for the App Store Connect API and the App Store Server API (StoreKit 2), built from Apple's own OpenAPI specification. 14 profiles, 51 sub-profiles, 786 tools. Each profile runs as its own small MCP server.
Apple's specification lists 1036 API operations. Heimdall leaves out the 185 that Apple has deprecated or replaced with a newer version, and 19 that repeat another operation from the other side or that no task needs. Of the remaining 832, 734 become tools, and 52 hand-written ones join them: 786 tools in all. The other 98 are covered by the media tools, which do in one call what took several raw ones.
Sounds complicated, doesn't it? You don't have to think about any of it. Just tell your AI the job you want done.
Heimdall gives you the whole API, cut by the work you do. Releases, TestFlight, subscriptions and in-app purchases, the store page and reviews, Game Center, Xcode Cloud, provisioning, webhooks, sales and finance reports: each is a profile.
A big profile splits into sub-profiles, so monetization:subscription loads subscriptions without the rest of the money tools. You pick what you need, and add or remove profiles whenever you like.
Profiles shows what each one covers, down to every tool. You don't have to memorize any of it, though: ask "Is there a tool for in-app events?" and Heimdall tells you which profile has it.
Not sure which profiles you need? The starter packs suggest a set for your role.
Runs on your machine
Heimdall runs locally. On a Mac it reads your App Store Connect key from the Keychain, signs a short-lived token and talks to Apple directly. Nothing sits in between, so your key stays with you.
flowchart LR
ai["Your AI app"] -->|"stdio, no network"| h
subgraph mac["Your machine"]
h["Heimdall<br/>read-only mode hides every write"] --> gate["Asks before risky changes"]
gate --> rl["Paces requests under<br/>Apple's rate limit"]
rl --> sign["Signs a 20-minute token"]
kc[("Keychain")] -.->|"key, read when needed"| sign
end
sign -->|HTTPS| apple["App Store Connect API"]
NOTE
Give your key the narrowest role that does the job. Roles explains what each App Store Connect role can do.
Asks before risky changes
Before changing a price, giving someone Admin access or deleting something, Heimdall asks you to confirm and shows what will change.
flowchart LR
w["A write"] --> q{"What does<br/>it change?"}
q -->|"money, deletion,<br/>signing, access"| c["You type CONFIRM"]
q -->|"reaches customers,<br/>players or testers"| y["You answer yes or no"]
q -->|"anything else"| a["Your AI app's approval"]
If your AI app can't show the question, Heimdall asks in a window of its own on a Mac. The AI can neither see nor press it, and waits until you answer.
More in Security.
Setup
One command:
npx -y @erayendes/asc-mcp setup
It asks whether to continue in your browser or the terminal. I recommend the browser.
To reach your account you need an App Store Connect API key. Heimdall tells you which role to give it from the tools you pick, so you can start setup before creating the key.
Setup in the browser: pick what you need and see what it costs the AI as you go. All four steps are in Setup.
Setup does two things: it saves your key, and it registers the profiles you pick in the AI apps you pick.
Your AI can do the second half for you with register; the key is always yours to hand over, through setup.
Want your AI to install it for you, or to use it in Xcode 27? Everything else is in Setup.
If something isn't working, run npx -y @erayendes/asc-mcp doctor; it checks your setup without changing anything and tells you the next step.
About the name and the project
In Norse mythology, Heimdall keeps watch over Bifröst, the rainbow bridge that links Asgard to the nine realms. Here, his job is to guard the road between your App Store Connect account and your machine. That's where the name comes from.
I build Heimdall on my own, in the evenings, and release it free and open source under the MIT license.
If it gets you out of the App Store Connect dashboard, it has done its job.
License
MIT © Eray Endes
SECURITY.md | SUPPORT.md | CHANGELOG.md | CONTRIBUTING.md | CODE_OF_CONDUCT.md | GOVERNANCE.md
Heimdall is generated from the App Store Connect OpenAPI specification published by Apple Inc. App Store Connect, TestFlight, StoreKit, Xcode and Game Center are trademarks of Apple Inc. This project is not affiliated with Apple Inc.