ShipASO MCP server
Commit Oct 21, 2026Audit App Store and Google Play listings to identify keyword gaps, score metadata, and generate optimized copy for mobile app optimization.
Also known as airowe/store-ops, store-ops
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Oct 21, 2026
- License
- MIT
What is ShipASO MCP?
ShipASO is an MCP server. Audit App Store and Google Play listings to identify keyword gaps, score metadata, and generate optimized copy for mobile app optimization.
Summary generated from the project's README
About ShipASO MCP server
ShipASO provides a complete loop for mobile app store optimization on both the App Store and Google Play. Unlike advisory tools that only suggest changes, this system handles the entire workflow from auditing listings and researching keywords to generating optimized metadata and verifying rank changes. It is designed for developers and mobile marketers who want to automate the repetitive tasks of App Store Optimization without relying on expensive third-party data APIs.
Users can run the engine locally within any coding agent like Cursor, Copilot, or Claude Code by cloning the repository. This local version uses your own credentials and machine to execute commands via the asc and gplay CLIs. Alternatively, you can connect to the hosted MCP server via a single command to access tools like preview_app and proof. The system operates on a principle of human approval, meaning it generates optimized copy and push commands but never submits changes to a live store without your explicit permission.
What you can do with it
- 1Audit existing app listingsPerform a field-by-field scoring of your current iOS or Android metadata against industry best practices.
- 2Conduct keyword researchIdentify high-potential keywords by scraping store autocomplete and competitor data without paying for external APIs.
- 3Optimize app metadataGenerate new app descriptions and titles that fit within exact character limits for the stores.
- 4Monitor competitor changesTrack how competitors update their names, subtitles, or pricing over time.
- 5Verify organic rank movementCheck if your metadata updates actually resulted in better keyword rankings using public data.
Written from the project's README. Every use case is checked against a quote from it.
How to install ShipASO MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ShipASO MCP in Claude Code
$ claude mcp add --transport http store-ops https://api.shipaso.com/mcpInstall ShipASO MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"store-ops": {
"url": "https://api.shipaso.com/mcp"
}
}
}Install ShipASO MCP in VS Code
.vscode/mcp.json
{
"servers": {
"store-ops": {
"type": "http",
"url": "https://api.shipaso.com/mcp"
}
}
}Install ShipASO MCP in VS Code CLI
$ code --add-mcp '{"name":"store-ops","type":"http","url":"https://api.shipaso.com/mcp"}'Install ShipASO MCP in Codex
$ codex mcp add store-ops --url https://api.shipaso.com/mcpInstall ShipASO MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.store-ops] url = "https://api.shipaso.com/mcp"
Install ShipASO MCP in Gemini CLI
$ gemini mcp add -s user --transport http store-ops https://api.shipaso.com/mcpInstall ShipASO MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"store-ops": {
"url": "https://api.shipaso.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableairowe/store-ops is public and reachablegithub.com/airowe/store-ops ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-21github.com/airowe/store-ops ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 193 msPass
README
View on GitHubShipASO
The reason → execute ASO loop for App Store and Google Play.
The product is ShipASO; the codebase, this repo, and the Cloudflare services are named
store-ops.
Every other AI ASO tool does one half. Advisory tools (and most "AI ASO agents") reason about your listing then stop at the copy-paste boundary — and they depend on a paid data API. Deploy CLIs (Fastlane, raw APIs) execute but have no ASO brain. ShipASO does both, on both stores, with no paid data dependency.
The open lane: Google Play. There is no public tool that operationally optimizes a Google Play Console listing end-to-end. ShipASO does iOS and Android.
Install — any coding agent
The loop runs in your editor, on your machine, with your credentials. The 33 skills are plain Markdown runbooks over plain CLI tools, and the engine is standard-library Python — so nothing here is tied to one vendor.
Any agent (Codex, Cursor, Copilot, Gemini, Amp, Aider…):
git clone https://github.com/airowe/store-ops && cd store-ops
Then point your agent at AGENTS.md — most read it automatically. That file
is the front door: the skills index, the credential rules, and how to run the
engine. Cursor, Copilot, and Gemini also get a pointer file that redirects there.
Claude Code additionally has a plugin installer:
/plugin marketplace add airowe/store-ops
/plugin install store-ops@store-ops
Either way, audit any listing — read-only, no credentials, no keys:
python3 lib/aso_rank_check.py --bundle com.burbn.instagram "photo,stories,reels"
You get a per-field ASO score of your live listing and the exact next skill to run for each gap. → Full walkthrough + what you'll see: https://shipaso.com/install
Zero install: point your agent at the hosted MCP
No clone, no key, no account:
claude mcp add shipaso --transport http https://api.shipaso.com/mcp
Your agent immediately gets preview_app — a real, measured teaser of any App
Store app (audit grade, lead organic rank, how many keywords crack the top 10)
— and proof, the aggregate rank-win record. The other ten tools (listing
audit, keyword gaps, rank check, screenshot scoring, competitor watch, war room,
localization gaps, draft copy, and the two Google Play audits) unlock with a
free shipaso_ key from app.shipaso.com → Settings → Agent access; re-add the
server with --header "Authorization: Bearer <key>". MCP is vendor-neutral, so
Cursor and any other MCP client work the same way. Every tool is read or draft;
nothing pushes to a live store. Details: skills/shipaso-mcp/SKILL.md.
What's in this repo
ShipASO comes in two forms — run it yourself, or let the hosted agent run it for you:
| Path | What |
|---|---|
skills/ + lib/ |
The free OSS agent plugin — 33 skills + the engine (Python, 200 tests). Runs in any coding agent; Claude Code also has a one-command installer. |
cloud/ |
The hosted autonomous agent — a Cloudflare app (Workers + D1 + Cron + Pages) that runs the loop on a schedule and surfaces decisions for approval. Engine ported to TypeScript (2,160 tests). See cloud/README.md + cloud/DEPLOY.md. |
commercial/, docs/ |
The offer, the launch posts, the landing page. |
The plugin is the funnel (discover the agent by running it); the hosted app is the product (it keeps working while you build). Same engine, two surfaces.
Run it yourself, or let it run itself:
- Free, in your editor — install the plugin and run the loop yourself in whichever agent you already use. Your credentials, your machine, no cost. Start here ↓ (Install).
- Hosted + autonomous — connect an app by bundle id and an agent runs the loop on a weekly schedule: re-checking ranks, watching competitors, drafting the next optimization, surfacing each decision for you to approve. It's live: https://app.shipaso.com
What it does
audit → research keywords → optimize to char limits → push → verify rank
(asc/gplay) (no paid API) (ready copy + commands) (you approve) (free, over time)
The full loop, not half of it. The data tools (Astro, AppTweak, Sensor Tower) stop at "here's what to do" and leave you in the App Store Connect form. ShipASO picks the keywords, writes the metadata, hands you the push, and then verifies the rank actually moved — the only piece that closes the loop and the one nobody else ships.
/store-ops myapp # full chain, both stores
/store-ops myapp --store playstore # Google Play only
/store-ops myapp --audit-only # just score the live listing
Try it in 30 seconds (no credentials, no setup)
The verify/watch half runs on the free public iTunes API — try it on any live app right now:
# organic App Store rank for some keywords (any app's bundle id)
python3 lib/aso_rank_check.py \
--bundle com.burbn.instagram "photo,stories,reels"
# score an app's screenshots against ASO best practice
python3 lib/aso_screenshot_score.py \
--app instagram --bundle com.burbn.instagram
# resolve a non-US market's keyword-volume + rank constants
python3 lib/aso_locale.py --locale de-DE
Run the test suites (standard-library only — no network, no keys):
python3 lib/run_tests.py
Skills
Reasoning (the IP):
| Skill | Does |
|---|---|
aso-audit |
Score a live iOS/Android listing field-by-field vs ASO best practice. Read-only. |
issue-verify |
Check open issues against the source before working them — catches stale "this is missing" claims. |
aso-teardown |
Write a publishable long-form teardown of any app from public measured data. Never estimates revenue. |
aso-keyword-research |
Rank keywords from store autocomplete + competitor scrape + synonyms. No paid data API. |
aso-metadata-optimization |
Generate final copy at exact char limits + emit the push commands. Never auto-ships. |
aso-rank-check |
Read your organic App Store rank per keyword and log it over time — did the change land? Free public iTunes API, no key. |
store-ops |
Router for the full chain. |
More reasoning — audit, risk, and research:
| Skill | Does |
|---|---|
aso-context |
Scaffold the per-app context.md every other ASO skill reads. Start here. |
aso-review-mine |
Mine your own reviews for the words real users use to describe the app. |
aso-offstore-mine |
Mine "best <category> apps" articles + YouTube for off-store discovery language. |
aso-localize-research |
Keyword + rank research per market (de-DE, ja-JP, es-MX…) instead of US-only. |
aso-competitor-watch |
Track competitors' listing changes over time — name, subtitle, price, rating. |
aso-screenshot-score |
Score a live screenshot set — count, device/aspect coverage, first-two story. |
aso-review-risk |
Flag copy that gets apps rejected — unverifiable claims, "#1", competitor names. |
aso-rejection-assistant |
Turn a rejection into a plan against the guideline the reviewer actually cited. |
aso-ppo-treatment |
Design a free screenshot A/B test (Product Page Optimization). |
aso-rank-monitor |
Run a keyword set on a cadence so you get deltas, not one snapshot. |
Execution — App Store Connect (via the asc CLI):
| Skill | Does |
|---|---|
asc-metadata-write-lane |
Create the editable version, attach the build, push the copy — stops before submit. |
asc-screenshot-write-lane |
Put an approved run's screenshot strip on the editable version through ShipASO — ids resolved, per-shot ledger, stops before submit. |
asc-metadata-sync |
Sync + validate metadata; migrate the legacy metadata format. |
asc-localize-metadata |
Translate and sync metadata across locales. |
asc-submission-health |
Preflight a submission, submit a build, monitor review status. |
asc-id-resolver |
Resolve app / build / version / group IDs from human-friendly names. |
asc-ppp-pricing |
Per-territory pricing by purchasing power. |
asc-shots-pipeline |
iOS screenshot capture via xcodebuild / simctl / AXe. |
aso-goldie-config |
Emit a goldie.config.ts from a run — audit-ordered scenes with headlines from the proposed copy, rendered on your own Mac. |
Execution — Google Play (via the gplay CLI):
| Skill | Does |
|---|---|
gplay-metadata-sync |
Listing sync, including Fastlane format. |
gplay-review-management |
Review monitoring, filtering, and responses. |
gplay-rollout-management |
Staged rollout orchestration and monitoring. |
gplay-vitals-monitoring |
Crashes, ANRs, performance, errors. |
gplay-screenshot-automation |
Android capture across devices/locales via adb + Espresso. |
gplay-ppp-pricing |
Region-specific pricing. |
Hosted:
| Skill | Does |
|---|---|
shipaso-mcp |
Point your agent at the hosted ShipASO MCP server and drive the loop over it. |
Every asc-* / gplay-* skill that writes asks which API key to use before
it does — asc resolves credentials from a default profile, and with more than
one registered a push through the wrong one succeeds against the wrong account.
Principles
- No paid data dependency — reasons over free + owned data (store autocomplete,
public listings, your own asc/gplay exports). Every credentialed source is an
optional accelerator with a free fallback, never a gate:
- volume — bring your own Apple Search Ads / Google Keyword Planner keys for real search-popularity numbers; without them, an honest autocomplete-rank proxy.
- scrape — bring a context.dev key for clean competitor-listing + brand-data scraping; without it, WebFetch / Crawl4AI. You bring your own keys (it's your data, ToS-clean); the plugin never resells data.
- Both stores, official APIs.
- Nothing ships without your approval — reasoning writes copy + prints commands; you run the push.
- App-agnostic —
--app <slug>+ acontext.md. No hardcoded apps, no secrets in the plugin.
Requirements
- To execute: the
ascandgplayCLIs installed + authed with your own developer credentials. - The reasoning skills work standalone (they emit commands you can run later).
Install
/plugin marketplace add airowe/store-ops
/plugin install store-ops@store-ops
Open-core — what's free vs. hosted
The plugin is free and MIT-licensed, forever. Everything above — the full audit → research → optimize → push → verify loop, both stores, all 33 skills — runs locally with your own credentials at no cost. Use it, fork it, ship apps with it. That's the whole product for anyone who's comfortable in a terminal.
The line for the hosted tier is convenience, never capability. The free plugin is complete; the paid tier sells you out of the setup pain and the remembering. The hosted agent is live now at https://app.shipaso.com — connect an app and watch the loop run on a schedule.
| Free (this plugin) | Hosted agent | |
|---|---|---|
| The 33 skills + full loop | ✅ all of it | ✅ same engine |
| Real volume data | BYO Apple/Google keys | guided setup |
| Rank tracking | run aso-rank-check by hand |
scheduled weekly + history + delta alerts |
| Standing autonomy (weekly cron) | ❌ you re-run it | ✅ Indie / Startup / Scale |
| Apps | unlimited (it's local) | 1 (Free) · 3 (Indie) · 10 (Startup) · 50 (Scale) |
| Approval gate | you run the push | enforced in code — commands withheld until you approve |
The tiers:
| Tier | Price | What you get |
|---|---|---|
| Free | $0 | Run the agent yourself in any coding agent. The whole loop, your machine. 1 connected app, manual runs only. |
| Indie | $6.99/month | The weekly autonomous sweep, up to 3 apps. It proposes, you approve, it ships. |
| Startup | $19.99/month | The weekly sweep across up to 10 apps, with rank history and competitor watch. |
| Scale | $64.99/month | Up to 50 apps plus the portfolio roll-up. For agencies and multi-app devs. |
We will never resell Apple/Google data through a shared account (that breaks their ToS) — the hosted tier is BYO-credentials too, and we never hold your store credentials; the push is a generated-commands handoff. What you pay for is the guided onboarding, the scheduler, and the history. The differentiator isn't the data — everyone has Apple's popularity numbers. It's that ShipASO ships the metadata and proves the rank moved.
→ Try the hosted agent: https://app.shipaso.com
License
MIT — see LICENSE.
ShipASO MCP questions
How do I add ShipASO MCP to Claude Code?
Run claude mcp add --transport http store-ops https://api.shipaso.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add ShipASO MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does ShipASO automatically publish changes to my app store listings?
No, the tool is designed to stop before submission. It generates optimized copy and commands, but nothing is pushed to a live store without your explicit approval.
Do I need to pay for a data API to use the keyword research features?
No, ShipASO does not have a paid data dependency and can rank keywords using store autocomplete and competitor scraping.
Can I use ShipASO for both iOS and Android?
Yes, it provides optimization and audit tools for both the App Store and Google Play.
How can I run a quick audit without setting up credentials?
You can perform a read-only audit of any live listing using the provided Python scripts without needing any keys or credentials.