Connect AppmanAi in 2 minutes

1 · Add the connector

One click if your client supports it — Claude opens AppmanAi’s directory listing, Cursor and VS Code arrive with the URL filled in:

Or add it by hand — same URL everywhere:

https://appmanai.com/api/mcp

Every snippet on this page — plus curl, Python and TypeScript examples and ready-made ASO Skills — lives in the connector repo on GitHub.

2 · Sign in when asked

The client opens a browser window to AppmanAi. Sign in or create an account — new accounts confirm their email with a 6-digit code and get free credits, no card — and click Allow. That’s it: the AppmanAi tools appear in your client. No API key to copy, nothing to install.

3 · Just ask

• Prompt Copy

  "Which keywords do my 3 UK competitors rank top-10 for that I don’t?"

• Prompt Copy

  "Profile the keyword “habit tracker” on the US App Store."

• Prompt Copy

  "What does com.discord look like on Google Play in Germany?"

What it looks like

Open full size

Open full size

Open full size

What your agent can call

Account tools are free; data tools spend credits from your balance.

app_metrics_metadataGet app metadata

Fetch the full store listing for one app (title, developer, ratings, category, metadata, whether it shows ads or sells in-app purchases, and their price range and the purchase items the store lists with prices) by its package id. If you only have the app name, call app_search first to resolve it.

3 credits

app_metrics_metadata_batchGet several app listings at once

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.

8 credits

app_searchSearch apps by name

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.

2 credits

app_similarApps similar to one app

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.

5 credits

app_metrics_ratings_worldwideApp rating by country

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.

6 credits

app_metrics_ratings_historyApp rating over time

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.

5 credits

app_metrics_installs_historyApp installs over time

An app's total installs worldwide, at most one point per day (days without data are absent), with `daily` — the gain per day since the previous point (null on a first point with no earlier data and on a day the total fell). For growth over the window, subtract the first `total` from the last. Worldwide only: there is no per-country figure. Google Play figures are Google's exact install count, and `total_bucket` is the range its store page shows. Apple publishes no install counts, so App Store figures are an estimate: approximate for any single app, most reliable as a trend over time or between similar apps, and to be presented to the user as an estimate. Pick the window with `from` / `to`; the last 30 days by default.

10 credits

app_metrics_revenue_worldwideApp revenue estimate

An app's estimated revenue from store purchases over the last 30 days: worldwide `gross` (what users paid) and `net` (what the developer keeps after the store's commission), each with a `low`–`high` range and a size `bucket`, plus the split by country, largest first. Neither store publishes revenue, so these are estimates on both stores: approximate for any single app, best for sizing an app or comparing apps, and to be presented to the user as estimates. An app the store lists no purchases for reads 0. Figures are in USD unless `currency` is given.

10 credits

app_reviewsGet app reviews

Read real user reviews of an app: author, star rating, text and date, 40 per page. Use it to find out what users actually complain about or praise. On Google Play, page through in order (1, 2, 3…) while `has_more` is true, each page within about an hour of the previous one and with the same sort_type; skipping ahead fails with PAGE_EXPIRED (not charged), so start again from page 1. The App Store serves a single page: there is no page 2 on ios.

4 credits

keyword_app_metrics_rankingsApp rank for a keyword

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.

2 credits

keyword_app_metrics_rankings_batchApp ranks across many keywords

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.

9 credits

keyword_app_metrics_rankings_historyApp rank history for a keyword

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.

6 credits

keyword_app_metrics_rankings_worldwideApp rank for a keyword in every country

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.

12 credits

keyword_app_suggestionsKeywords an app ranks for

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.

6 credits

keyword_app_competitorsKeywords an app's competitors rank for

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.

6 credits

keyword_app_overlapKeywords shared by several apps

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.

7 credits

keyword_metricsKeyword profile

Get the ASO profile of a keyword: search-ads popularity (SAP), difficulty, and languages. Use it to judge whether a keyword is worth targeting.

4 credits

keyword_metrics_sapKeyword popularity score

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.

4 credits

keyword_metrics_sap_batchKeyword popularity scores in bulk

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.

9 credits

keyword_metrics_volatilityRanking algorithm volatility

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.

8 credits

keyword_metrics_volatility_worldwideRanking volatility by country

Ranking-algorithm volatility for one date across every country, so you can tell a global store change from a local one.

12 credits

keyword_top_appsTop apps for a keyword

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.

5 credits

keyword_suggestionsSuggest related keywords

Expand a seed keyword into related keyword suggestions for a store/country. Use it to grow a keyword list before profiling or checking ranks.

5 credits

keyword_suggestions_worldwideWorldwide keyword suggestions

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.

10 credits

category_top_appsTop apps in a category chart

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.

5 credits

app_category_rankingsApp ranks across category charts

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.

3 credits

app_category_rankings_singleApp rank in one category chart

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.

2 credits

app_category_rankings_historyApp category rank over time

An app's position in a category chart across past days — the series to chart when asking whether an app is climbing or sliding.

6 credits

app_category_start_rankingsWhere apps entered a chart

For each app given, the rank it first held in a chart from a start date — the baseline to measure a campaign against.

5 credits

generate_keywordsSuggest keywords for an app (AI)

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 propose new keywords to target; keyword_app_suggestions reports what the app already ranks for.

12 credits

generate_app_metadataWrite store listing copy (AI)

Rewrite an app store listing — title, short and long description — optimised for the keywords you pass and the store it targets. Takes the current copy directly, not a package id, so you can iterate on drafts; use app_metrics_metadata first if you want to start from a live listing.

15 credits

list_countriesList supported countries

List the countries AppmanAi covers, with languages and per-store support levels. Use it to confirm coverage or resolve a country code before other calls.

Free

list_categoriesList store categories

List a store's category tree — category tags and the charts under each (top free, top grossing, top paid). Use its tags for `category` in the category tools and `category_tag` in generate_app_metadata; they differ by store.

Free

list_featuresList available data features

List which parts of the dataset are available for a store and country. Use it to check whether a kind of data exists for a market before spending credits looking for it.

Free

user_balanceCheck credit balance

Show the credit balance on the connected AppmanAi account, split into bonus credits (with their expiry), the monthly allowance and credits that never expire.

Free

user_api_usageUsage and spend statistics

Summarise this account's recent AppmanAi usage: credits spent, request count and a per-route breakdown over a window of days.

Free

list_toolsList tools and credit costs

List every AppmanAi tool with what it costs in credits, plus the current balance. Answers "what can you do?" and "what will this cost?".

Free

Full parameter and response details live in the MCP docs.

If something doesn’t connect