<div align="center"> <img src=".github/assets/cover.png" alt="AppmanAi — give your AI real App Store and Google Play data">

AppmanAi MCP

Keyword demand, rank history, top charts, competitors, reviews and ratings — across 100+ countries, answered inside your chat instead of a dashboard.

<br>

</div>

---

Without AppmanAi

Ask an assistant about your app's market and it answers from training data — a snapshot of some stores, some countries, some year ago:

• Keyword advice with no idea what people actually search for
• "Competitors" it inferred from a name rather than the store's own graph
• Rank claims it cannot check, stated with the same confidence as facts
• Nothing at all for the 90+ countries outside the US

With AppmanAi

Your agent calls the stores. Every number in the answer came back from a live query, and the agent tells you what each call cost.

Which keywords do my three UK competitors rank top-10 for that I don't?

Profile the keyword "habit tracker" on the US App Store — is it worth chasing?

My rank for "meditation" dropped 12 places last week. Was that me, or the algorithm?

What do users actually complain about in the reviews of com.example.app?

Where in the world does "budget planner" have enough demand to justify a launch?

---

Install

AppmanAi is a remote MCP server. There is nothing to download and no API key to paste — you add one URL, sign in, and the tools appear:

https://appmanai.com/api/mcp

Authentication is OAuth 2.1: your client opens a browser, you approve once, and it stores the token. New accounts get 200 free credits, no card.

<table> <tr><th align="left">Client</th><th align="left">How</th></tr> <tr> <td><b>Claude</b><br>_{web · desktop · mobile}</td> <td>

Add AppmanAi to Claude →

Listed in Claude's connector directory: Customize → Connectors → Discover, search AppmanAi, Connect, Allow. Or add it by hand as a custom connector (Customize → Connectors → Add) with the URL.

</td> </tr> <tr> <td><b>Claude Code</b></td> <td>

claude mcp add --transport http appmanai https://appmanai.com/api/mcp

</td> </tr> <tr> <td><b>Cursor</b></td> <td>

One-click install → · or add to mcp.json:

{ "mcpServers": { "appmanai": { "url": "https://appmanai.com/api/mcp" } } }

</td> </tr> <tr> <td><b>VS Code</b></td> <td>

One-click install → · or add to mcp.json:

{ "servers": { "appmanai": { "type": "http", "url": "https://appmanai.com/api/mcp" } } }

</td> </tr> <tr> <td><b>Codex</b></td> <td>

codex mcp add appmanai --url https://appmanai.com/api/mcp

</td> </tr> <tr> <td><b>Gemini CLI</b></td> <td>

gemini mcp add appmanai https://appmanai.com/api/mcp --transport http

</td> </tr> <tr> <td><b>Anything else</b></td> <td>

Bridge it over stdio with mcp-remote:

{ "mcpServers": { "appmanai": { "command": "npx", "args": ["-y", "mcp-remote", "https://appmanai.com/api/mcp"] } } }

</td> </tr> </table> <details> <summary><b>What the three steps look like</b></summary> <br>

1 · Find AppmanAi under Connectors → Discover

<img src=".github/assets/connector-directory.png" alt="Claude's Connectors → Discover tab with the AppmanAI connector in the search results" width="620">

2 · Sign in and click Allow

<img src=".github/assets/authorize.png" alt="The AppmanAi authorize screen" width="620">

3 · The tools answer in chat

<img src=".github/assets/answer-in-chat.jpg" alt="AppmanAi answering a keyword question in Claude" width="620"> </details>

---

Tools

35 read-only tools. Costs are in credits and are the real numbers the server charges — this section is generated from the live catalogue by scripts/generate-tool-table.mjs, so what is published here cannot drift from what you are billed.

<!-- tools:start --> <details> <summary><b>Apps</b> — 7 tools, 2–8 credits</summary>

| Tool | Credits | What it does | | --- | ---: | --- | | app_search | 2 | Search a store for apps matching a name or phrase. Returns matching apps with their package ids — the way to resolve a name into a package id for the other tools. | | app_similar | 5 | List the apps the store itself considers similar to a given app (title, developer, icon). The quickest way to build a competitor set from one seed app. | | app_metrics_metadata | 3 | Fetch the full store listing for one app (title, developer, ratings, category, metadata) by its package id. If you only have the app name, call app_search first to resolve it. | | app_metrics_metadata_batch | 8 | Fetch store listings for a list of package ids in one call — the bulk form of app_metrics_metadata. Use it when comparing apps, instead of one call per app. | | app_metrics_ratings_worldwide | 6 | An app's current rating and per-star vote counts in every country it is listed in. Use it to see where an app is rated well or badly; app_metrics_ratings_history tracks one country over time. | | app_metrics_ratings_history | 5 | An app's average rating and star breakdown over time in one country — a dated series for charting whether a release helped or hurt. app_metrics_ratings_worldwide gives the current picture across all countries instead. | | app_reviews | 4 | Read real user reviews of an app: author, star rating, text and date. Use it to find out what users actually complain about or praise. |

</details> <details> <summary><b>Keywords by app</b> — 7 tools, 2–12 credits</summary>

| Tool | Credits | What it does | | --- | ---: | --- | | keyword_app_metrics_rankings | 2 | Where one app currently ranks in search results for one keyword. The direct answer to "am I ranking for this?". A rank of 0 means the app is not in the results. | | keyword_app_metrics_rankings_batch | 9 | One app's rank for a list of keywords in a single call. Use it to check a whole keyword set at once instead of calling keyword_app_metrics_rankings repeatedly. A rank of 0 means the app is not in the results. | | keyword_app_metrics_rankings_history | 6 | One app's rank for a keyword over time — the series to chart when asking whether a change helped. Pick the window with period. A rank of 0 means the app is not in the results. | | keyword_app_metrics_rankings_worldwide | 12 | One app's rank for a keyword in every country at once. Use it to find the markets where the app already ranks, before spending calls per country. A rank of 0 means the app is not in the results. | | keyword_app_suggestions | 6 | List the keywords a specific app is recommended for / ranks on in a store/country, by its package id. The direct way to answer "what keywords does this app rank for?". If you only have the app name, call app_search first to resolve it. A rank of 0 means the app is not in the results. | | keyword_app_competitors | 6 | List keywords that the competitors of one app rank for, with their popularity (SAP) and that app's own rank where it has one. Use it to find the gaps — keywords rivals own and this app does not. keyword_app_suggestions covers what the app itself already ranks for. | | keyword_app_overlap | 7 | Given a set of apps, list the keywords they compete on, each with its popularity (SAP) and every app's rank for it. Use it to compare a whole competitor set head-to-head on one keyword list; keyword_app_competitors starts from a single app instead. |

</details> <details> <summary><b>Keywords</b> — 8 tools, 4–12 credits</summary>

| Tool | Credits | What it does | | --- | ---: | --- | | keyword_metrics | 4 | Get the ASO profile of a keyword: search-ads popularity (SAP), difficulty, and languages. Use it to judge whether a keyword is worth targeting. | | keyword_metrics_sap | 4 | Get just the search-ads popularity (SAP, 0-100) of one keyword in a country, across both stores. The cheapest popularity check; keyword_metrics adds difficulty and languages. | | keyword_metrics_sap_batch | 9 | Get the search-ads popularity (SAP) of many keywords in one call. Use it to rank a whole keyword list by demand before profiling the promising ones. | | keyword_metrics_volatility | 8 | How much the store's ranking algorithm moved in one country over a period. High volatility means rank changes are the store's doing, not yours — check it before blaming a release. | | keyword_metrics_volatility_worldwide | 12 | Ranking-algorithm volatility for one date across every country, so you can tell a global store change from a local one. | | keyword_top_apps | 5 | List the apps that rank highest for a keyword in a store/country — the search results a user sees. Use it to find the incumbents / competitors for a keyword. | | keyword_suggestions | 5 | Expand a seed keyword into related keyword suggestions for a store/country. Use it to grow a keyword list before profiling or checking ranks. | | keyword_suggestions_worldwide | 10 | Expand a seed keyword into suggestions with their popularity (SAP), across all markets at once and without picking a store or country. The cheap first pass before narrowing down with keyword_suggestions or keyword_metrics. |

</details> <details> <summary><b>Charts and categories</b> — 5 tools, 2–6 credits</summary>

| Tool | Credits | What it does | | --- | ---: | --- | | category_top_apps | 5 | List the apps at the top of a category chart (top free, top grossing, top paid) in a country. Use it to see who leads a category; list_categories has the valid tags. | | app_category_rankings | 3 | List every category chart an app currently appears in, with its rank in each. The place to start when you do not already know which chart matters. | | app_category_rankings_single | 2 | An app's current position in a single category chart. Use it when you know exactly which chart you mean; app_category_rankings lists every chart the app appears in. | | app_category_rankings_history | 6 | An app's position in a category chart across past days — the series to chart when asking whether an app is climbing or sliding. | | app_category_start_rankings | 5 | For each app given, the rank it first held in a chart from a start date — the baseline to measure a campaign against. |

</details> <details> <summary><b>Generation</b> — 2 tools, 12–15 credits</summary>

| Tool | Credits | What it does | | --- | ---: | --- | | generate_keywords | 12 | Generate a keyword list for an app from its own store listing, each scored with its popularity (SAP) and the app's current rank where it has one. Use it to propo