ASO MCP server · 23 read-only tools
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, audits and ASO to-do list, then answer in plain English. It comes with every plan and the 7-day trial, with no credits or per-call fees.
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 23 read-only tools for apps, keywords, positions, SERPs, 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 · 4
- Keywords · 2
- Insights · 12
- Actions · 5
Every tool is a read-only GET on the API, so an agent can read your queue but never change it. 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 read-only token
Open the MCP server card in Settings and click connect an agent. It creates the token and 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.
No credit card. Every feature from the first minute.
Tool reference
23 tools, every one read-only.
Each tool wraps one GET on the AsoBeast API, so an agent sees exactly what the API returns. Most tools take an app id, which list_apps provides.
| Tool | What it returns |
|---|---|
| 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 |
| portfolio | Visibility, keyword and movement figures across every tracked app |
| 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 |
| 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 |
| 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 |
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.
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?
No. Every tool wraps a read-only GET and the token can only read. Importing apps, changing tracked keywords and closing actions stay in the web app, so the worst an agent can do is give a wrong answer.
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.
Does it work with a self-hosted AsoBeast?
Yes. The MCP server is part of the open source code, so a self-hosted install has the same 23 tools, pointed at your own server, with no rate limits.
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 seven tested prompts.
Give your agent your ASO data.
7 days free, no card. The MCP server works from the first minute.