Skip to content

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.

Terminal
$ 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.

claude

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.

Claude Code + AsoBeast
Claude Code answering an ASO question by calling AsoBeast MCP tools, with the AsoBeast app open beside it
  • 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.

  1. 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.

  2. 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.

  3. 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.

Start my free 7-day trial

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.

37 read tools and 7 opt-in write tools.
ToolWhat it reads or changes
Apps
list_appsEvery tracked app with its store, home country, visibility and keyword count
get_appStore metadata, home storefront, latest snapshot and category for one app
app_summaryTracked keywords, visibility, average position and recent movement
app_run_statusHow far today’s data collection has got for one app and its competitors
portfolioVisibility, keyword and movement figures across every tracked app
market_suggestionsStorefronts that read your listing’s languages, with the daily requests each would cost
Keywords
list_keywordsTracked keywords with popularity, difficulty, opportunity and the latest position
keyword_suggestionsKeyword ideas from metadata, search, similar apps, competitors, seasonality or reviews
keyword_comparisonYour position and each competitor’s for every tracked keyword, with the gaps first
keyword_breakdownWhy you and each competitor rank where you do for one keyword, field by field
keyword_fieldsThe saved App Store keyword fields, one per localization, with characters used
app_localizationsThe App Store localizations an app ships, with the markets that read each one
market_keyword_fieldsEvery localization one storefront’s search reads for your app, in read order
Competitors
list_competitorsThe competitor apps tracked against one app with their latest snapshot
competitor_analysisMetadata side by side, keyword gap lists and a visibility and rating map
competitor_suggestionsUntracked apps that keep showing up in your search results, plus similar apps
Top charts
top_chartOne day of a free, paid or grossing chart with climbers, fallers and new entries
chart_genresThe categories a top chart can be read for on one store
Annotations
list_annotationsThe release and campaign markers pinned to an app’s charts
Insights
ranking_historyDaily positions for tracked keywords over a date window
serp_snapshotThe ranked apps captured for one keyword on a given day
serp_moversKeywords whose search results reshuffled most over the last days
visibility_historyDaily visibility score from 0 to 100
rank_distribution_historyDaily keyword counts by rank band: top 3, 4 to 10, 11 to 50
ratings_historyDaily average rating and rating count
app_auditThe latest ASO audit: score, grade, evidence and fixes ranked by points gained
audit_historyASO audit scores over a date window
metadata_auditTitle, subtitle, short description and keyword field checks with character limits
list_reviewsRecent store reviews, filtered by stars or app version
changes_timelineDetected listing changes for an app over the last days
change_impactRank and visibility movement 7, 14 and 28 days after each listing change
category_ranksDaily top chart positions for free, paid and grossing, in the app’s category and overall
Actions
list_actionsThe prioritized ASO work queue across every app
app_actionsThe prioritized ASO work queue for one app
actions_summaryOpen and snoozed counts by priority, category and rule
get_actionOne action with its evidence, history and before and after metrics
actions_activityDaily counts of actions opened, done, dismissed and confirmed fixed
Changes
track_keywordsStarts tracking up to 50 keywords for one app in one market
untrack_keywordStops tracking one keyword in its market
add_competitorAdds a competitor to one app from its store listing URL
remove_competitorRemoves one competitor from an app
set_action_statusMarks an action done, snoozed, dismissed or open again, with an optional note
add_annotationPins a release, listing change or campaign to one day on the app’s charts
delete_annotationRemoves 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.

ASO MCP servers compared on access, API and entry price, as each vendor published it by 15 November 2026.
ToolMCP serverAPIEntry price
AsoBeast44 tools, every planEvery plan$10 a month
AppfiguresHostedIncluded, more as an add-on$44.99 a month
AppFollowHosted, uses creditsCredits on every plan$29 a month
AppTweakEvery plan, daily creditsFrom $199 a month$99 a month
AstroLocal betaNot published$108 a year
MobileActionWith the API planCustom plan$15 a month
RespectASO32 local tools on ProNot includedFree, Pro from 139 PLN
Sensor TowerWith an API subscriptionAPI subscriptionQuoted after a demo
Sonar80 tools, hosted or localIncluded$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.