ASO MCP server · read-only by default
The ASO MCP server for the App Store and Google Play.
AsoBeast’s MCP server lets Claude, Cursor, Codex or any other MCP client read your keyword rankings, competitors, reviews, top charts, audits and ASO to-do list, then answer in plain English. With a write-scoped token it can also track keywords, manage competitors, update actions and pin releases to your charts. It comes with every plan and the 7-day trial, with no credits or per-call fees, and it is free when you self-host AsoBeast.
Settings writes this command for you, with a read-only token for your workspace.
$ claude mcp add --transport http asobeast https://app.asobeast.com/api/backend/mcp --header "Authorization: Bearer YOUR_TOKEN"MCP server
Ask Claude which keywords slipped this week.
AsoBeast ships a Model Context Protocol server with 37 read tools and 7 opt-in write tools for apps, keywords, competitors, positions, SERPs, top charts, audits, reviews, listing changes and the action queue. Connect Claude Code, Cursor, Codex or another MCP client and ask in plain English, with no credits or per-call fees.
Which of my tracked keywords lost more than five positions this week, and what should I do first?
- asobeast · ranking_history
- asobeast · app_actions
Three keywords dropped more than five positions on the App Store (US) this week.
meme maker 12 → 19 · geoguess quiz 8 → 15 · map quiz game 21 → 27
Start with the critical action: defend "meme maker", two competitors entered the top ten on Tuesday.

- Which of my tracked keywords lost more than five positions this week?
- Summarize the open critical actions across my portfolio and tell me which app to work on first.
- Compare my visibility against my top competitor in Germany over the last 30 days.
- Apps · 6
- Keywords · 7
- Competitors · 3
- Top charts · 2
- Annotations · 1
- Insights · 13
- Actions · 5
- Changes · 7
The MCP server is read-only by default: a read token sees only the read tools, and the API refuses it on every change. Tracking keywords, managing competitors, updating actions and annotating charts need a token you mint with write access. The MCP server comes with every plan, including the trial, and Settings writes the setup command for your client.
- Claude Code
- Claude Desktop
- Cursor
- VS Code
- Windsurf
- Codex
- Gemini CLI
Setup
Connected in about a minute.
Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex and Gemini CLI each have a setup snippet. Any other client that speaks streamable HTTP or stdio works too.
- 01
Start a workspace
Start the free trial and paste a store link. Tracking starts on import, so there is data to ask about within minutes.
- 02
Mint a token
Open the MCP server card in Settings and click connect an agent. The token is read-only unless you tick Allow this agent to make changes, and Settings writes the snippet for your client.
- 03
Ask in plain English
Ask which keywords slipped this week, what to fix first or how you compare with a rival in one country. The agent picks the tools.
Every feature from the first minute.
Tool reference
37 read tools and 7 opt-in write tools.
Each tool wraps one route on the AsoBeast API, so an agent reads and changes exactly what that route allows. The read tools are each a GET. The write tools under Changes are listed only to a token with the write scope. Most tools take an app id, which list_apps provides.
| Tool | What it reads or changes |
|---|---|
| Apps | |
| list_apps | Every tracked app with its store, home country, visibility and keyword count |
| get_app | Store metadata, home storefront, latest snapshot and category for one app |
| app_summary | Tracked keywords, visibility, average position and recent movement |
| app_run_status | How far today’s data collection has got for one app and its competitors |
| portfolio | Visibility, keyword and movement figures across every tracked app |
| market_suggestions | Storefronts that read your listing’s languages, with the daily requests each would cost |
| Keywords | |
| list_keywords | Tracked keywords with popularity, difficulty, opportunity and the latest position |
| keyword_suggestions | Keyword ideas from metadata, search, similar apps, competitors, seasonality or reviews |
| keyword_comparison | Your position and each competitor’s for every tracked keyword, with the gaps first |
| keyword_breakdown | Why you and each competitor rank where you do for one keyword, field by field |
| keyword_fields | The saved App Store keyword fields, one per localization, with characters used |
| app_localizations | The App Store localizations an app ships, with the markets that read each one |
| market_keyword_fields | Every localization one storefront’s search reads for your app, in read order |
| Competitors | |
| list_competitors | The competitor apps tracked against one app with their latest snapshot |
| competitor_analysis | Metadata side by side, keyword gap lists and a visibility and rating map |
| competitor_suggestions | Untracked apps that keep showing up in your search results, plus similar apps |
| Top charts | |
| top_chart | One day of a free, paid or grossing chart with climbers, fallers and new entries |
| chart_genres | The categories a top chart can be read for on one store |
| Annotations | |
| list_annotations | The release and campaign markers pinned to an app’s charts |
| Insights | |
| ranking_history | Daily positions for tracked keywords over a date window |
| serp_snapshot | The ranked apps captured for one keyword on a given day |
| serp_movers | Keywords whose search results reshuffled most over the last days |
| visibility_history | Daily visibility score from 0 to 100 |
| rank_distribution_history | Daily keyword counts by rank band: top 3, 4 to 10, 11 to 50 |
| ratings_history | Daily average rating and rating count |
| app_audit | The latest ASO audit: score, grade, evidence and fixes ranked by points gained |
| audit_history | ASO audit scores over a date window |
| metadata_audit | Title, subtitle, short description and keyword field checks with character limits |
| list_reviews | Recent store reviews, filtered by stars or app version |
| changes_timeline | Detected listing changes for an app over the last days |
| change_impact | Rank and visibility movement 7, 14 and 28 days after each listing change |
| category_ranks | Daily top chart positions for free, paid and grossing, in the app’s category and overall |
| Actions | |
| list_actions | The prioritized ASO work queue across every app |
| app_actions | The prioritized ASO work queue for one app |
| actions_summary | Open and snoozed counts by priority, category and rule |
| get_action | One action with its evidence, history and before and after metrics |
| actions_activity | Daily counts of actions opened, done, dismissed and confirmed fixed |
| Changes | |
| track_keywords | Starts tracking up to 50 keywords for one app in one market |
| untrack_keyword | Stops tracking one keyword in its market |
| add_competitor | Adds a competitor to one app from its store listing URL |
| remove_competitor | Removes one competitor from an app |
| set_action_status | Marks an action done, snoozed, dismissed or open again, with an optional note |
| add_annotation | Pins a release, listing change or campaign to one day on the app’s charts |
| delete_annotation | Removes one event marker from the app’s charts |
Other ASO MCP servers
How does it compare with other ASO MCP servers?
9 of the 10 tools in our ASO tools roundup publish an MCP server. Several sit behind a separate API plan or spend credits on every call, and some run only on your own machine. This is what each vendor says on its own site.
| Tool | MCP server | API | Entry price |
|---|---|---|---|
| AsoBeast | 44 tools, every plan | Every plan | $10 a month |
| Appfigures | Hosted | Included, more as an add-on | $44.99 a month |
| AppFollow | Hosted, uses credits | Credits on every plan | $29 a month |
| AppTweak | Every plan, daily credits | From $199 a month | $99 a month |
| Astro | Local beta | Not published | $108 a year |
| MobileAction | With the API plan | Custom plan | $15 a month |
| RespectASO | 32 local tools on Pro | Not included | Free, Pro from 139 PLN |
| Sensor Tower | With an API subscription | API subscription | Quoted after a demo |
| Sonar | 80 tools, hosted or local | Included | $29 a month |
Questions
About the MCP server
What is an ASO MCP server?
An ASO MCP server connects an AI agent to App Store Optimization data through the Model Context Protocol. With AsoBeast’s server, Claude, Cursor or Codex can read your keyword rankings, search results, competitors, reviews, audits and action queue and answer questions about them, without you exporting anything first.
Is this an App Store Connect MCP server?
No. Most App Store MCP servers automate App Store Connect: they manage builds, TestFlight testers and the metadata Apple publishes. AsoBeast’s server reads ASO data instead: keyword rankings, search results, competitors, reviews, audits and your to-do list. It needs no App Store Connect or Play Console key, and even a write-scoped token changes only your AsoBeast workspace, never your live store listing.
Which AI clients work with it?
Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex and Gemini CLI are documented, and Settings writes the command for each. Claude Desktop connects through the small mcp-remote bridge. Any other client that speaks streamable HTTP or stdio works as well.
Can the agent change anything in my workspace?
Only if you allow it. A token is read-only by default: it never sees the write tools, and the API refuses it on every route that changes data. Tick Allow this agent to make changes when you connect an agent and it can also track and untrack keywords, add and remove competitors, set an action’s status and add or remove chart annotations, through the same validation, quota and history as the web app. Importing apps, editing metadata, posting review replies, billing and settings stay in the web app.
Does it cost extra or use AI calls?
It is included on Indie, Ultimate and the trial, and it never uses the workspace’s AI call allowance. Hosted workspaces can make 60 MCP requests a minute on Indie and 300 on Ultimate. Self-hosted installs have no rate limits.
Hosted endpoint or local stdio server?
Both expose the same tools from one catalog. The hosted endpoint needs nothing installed. The stdio server runs on your own machine and calls the API, for clients without a remote transport or for a checkout of the source.
Is there a free ASO MCP server?
Yes. AsoBeast is an open-source ASO tool, and its MCP server is part of the AGPL-3.0 code. A self-hosted install gets the same 37 read tools and 7 opt-in write tools, pointed at your own server, free and with no rate limits. On the hosted service the server comes with every plan and the trial.
Which MCP protocol revisions does it support?
Both transports serve the 2026-07-28 revision and the 2025 revisions from the same tool definitions. Neither holds a session, so there is no session id to store or expire.
What should I ask it?
Weekly reviews, triaging keyword losses, explaining why a keyword moved, comparing against a competitor in one country and drafting the next metadata iteration all work well. The docs have nine tested prompts, and the last two make changes with a write-scoped token.
Last updated .
Give your agent your ASO data.
7 days free. The MCP server works from the first minute.