Skip to main content
The Appeeky MCP Server lets AI assistants like Claude, ChatGPT, Cursor, and any MCP-compatible client query App Store intelligence data directly.
MCP Endpoint: https://mcp.appeeky.com

Connect Your Client

Claude Desktop uses OAuth — no API key needed. You’ll sign in with your Appeeky account when prompted.
  1. Open Claude Desktop and go to Settings → Connectors (or click the button in your Appeeky dashboard).
  2. Click Add Connector and paste the MCP URL:
https://mcp.appeeky.com
  1. Claude will redirect you to sign in with your Appeeky account (Google, GitHub, or email).
  2. Once authenticated, the Appeeky MCP tools will be available in your conversations.
You can also add the connector from appeeky.com → Settings → API Key — the “Claude Desktop” button copies the URL and opens the Connectors page for you.
Claude Desktop uses OAuth (no API key required). All other clients use your API key via Authorization: Bearer header or X-API-Key header. Get your key from appeeky.com → Settings or the API Dashboard.

Available Tools

Apps

ToolDescription
search_appsSearch the App Store by keyword or app name
get_appGet detailed metadata for a specific app
get_app_intelligenceFull intelligence report: downloads, revenue, sentiment
get_app_similarSimilar and competing apps (3-layer matching)
get_app_reviewsFetch user reviews with pagination
get_country_rankingsApp rankings across all countries

Screenshots

ToolDescription
get_app_screenshotsGet all screenshots for an app, separated by device (iPhone/iPad)
get_competitor_screenshotsCompare screenshots between an app and its competitors
get_category_screenshotsGet screenshots for top apps in a category

Keywords

ToolDescription
get_keyword_ranksAll apps ranking for a keyword with rich metadata (supports countries for multi-storefront)
get_keyword_suggestionsKeyword ideas from a seed term with volume/difficulty
get_keyword_metricsVolume score, difficulty score, competition analysis (supports countries)
get_app_keywordsAll keywords an app ranks for with trends
get_keyword_trendsHistorical rank data over time (7-90 days)
get_keyword_ranks_historyHistorical apps-per-day counts for a tracked keyword (charting SERP crowding)
compare_keywordsCompare keyword overlap between two apps
compare_keyword_clusterYour app + 1–5 competitors: lifecycle buckets + gap keywords
track_keywordAdd keyword to daily tracking
get_trending_keywordsKeywords with fastest-growing reach, ranked by growth percentage

Account

ToolDescription
get_api_usagePlan, credits used/remaining, reset date, per-endpoint usage (0 credits)

ASO (App Store Optimization)

ToolDescription
aso_full_auditFull ASO health audit — score (0-100), 9-factor breakdown, prioritized recommendations
aso_briefAudit + opportunities + storefront score; optional countries, intent_clusters (embeddings — see ASO Intent Clusters)
aso_validate_metadataValidate title/subtitle/keywords against Apple or Google character limits
aso_suggest_metadataGenerate optimized metadata suggestions based on target keywords
aso_find_opportunitiesDiscover untapped keyword opportunities (high volume + low difficulty)
aso_competitor_reportDeep ASO comparison between two apps with keyword gap analysis
ToolDescription
get_featured_appsApp of the Day, Game of the Day, and curated editorial collections
get_categoriesList all App Store categories
get_category_topTop apps by category and chart type
get_downloads_to_topEstimated downloads to reach chart positions
get_new_releasesRecently released apps
discoverCurated discovery feed (new releases + new #1 apps)
get_new_number_1Apps that recently hit #1 in their category

Market Intelligence

ToolDescription
get_market_moversTop gainers, losers, new entries, and apps that dropped out of charts
get_market_activityLive feed of chart movements: new entries, rank ups/downs, exits
ToolDescription
asc_get_metricsOverview: totals, per-app breakdown, daily rows (2 credits)
asc_list_metrics_appsList app IDs with metrics data (2 credits)
asc_get_app_metricsApp detail: daily series + country breakdown (2 credits)
asc_subscription_metricsMRR / ARR / ARPU / churn / trial conversion + daily series (2 credits)
Pro feature — requires Indie plan or higher. ASC Metrics need your App Store Connect account connected in appeeky.com → Settings → Integrations. Data syncs daily. 2 credits per request.

ASC Reviews (synced + write-through)

ToolDescription
asc_search_reviewsSearch reviews with rich filters: rating, territory, hasResponse, full-text
asc_reviews_summaryAggregated stats: total, avg rating, distribution, response rate, by-territory
asc_respond_to_reviewPost or update a developer response (handles Apple’s edit-by-DELETE flow)
asc_delete_review_responseDelete a developer response
asc_refresh_reviewForce-refresh one review from Apple (e.g. after replying)
Pro feature — requires Indie plan or higher. Reviews data syncs daily; mutations write through to Apple immediately.

App Store Connect (requires your ASC credentials)

ToolDescription
asc_list_appsList apps in your App Store Connect account
asc_get_appGet app details by App Store Connect app ID
asc_list_app_versionsList versions for an app
asc_create_app_versionCreate a new app version (version string + platform)
asc_update_app_versionPatch attributes on an app version
asc_list_app_infosList app info resources for an app
asc_list_app_info_localizationsList app info localizations (name, subtitle, privacy)
asc_update_app_info_localizationUpdate app info localization fields
asc_list_version_localizationsList metadata localizations for a version
asc_get_version_localizationGet one version localization by ID
asc_update_localizationUpdate description, keywords, whatsNew, etc.
asc_list_customer_reviewsList customer reviews live from Apple (legacy — prefer asc_search_reviews for filtering)
asc_list_app_analytics_requestsList analytics report requests
asc_create_analytics_requestCreate analytics report request
asc_list_reports_for_requestList reports for a request
asc_list_analytics_report_instancesList instances for an analytics report
asc_list_analytics_report_segmentsList segments for a report instance
asc_get_analytics_report_segmentGet one segment (download metadata)
ASC tools require issuer_id, key_id, and private_key — your App Store Connect API key. See App Store Connect Overview.

RevenueCat (your credentials: X-RC-Key / X-RC-Project)

ToolDescription
rc_overviewSnapshot: MRR, actives, trials, revenue, etc.
rc_chart_optionsValid filters (countries, products, …) for a chart name
rc_revenue, rc_mrr, rc_active_subscriptions, rc_churnCommon chart shortcuts
rc_chartGeneric chart by name

Example Prompts

Once connected, ask your AI assistant in natural language: Market research:
Show me the top 10 apps for "meditation" and analyze
their ratings and review counts.
Keyword intelligence:
Find keyword suggestions for "screen recorder" and
tell me which ones have high volume but low difficulty.
Competitor analysis:
Compare keyword overlap between Headspace (id: 493145008)
and Calm (id: 571800810). What keywords is Calm ranking
for that Headspace is missing?
App intelligence:
Give me the full intelligence report for Duolingo.
How many downloads does it get? What's the revenue estimate?
Featured apps:
What apps are featured on the App Store today?
What's the App of the Day and Game of the Day?
Trending keywords:
What keywords are trending on the App Store this week?
Show me keywords with the highest growth in the US.
Downloads to top:
How many downloads does it take to reach the top 10
in the Games category? Show me the current apps at each rank.
New releases:
What new apps were released in the last 3 days?
Are any of them in the Games category?
ASO audit:
Run a full ASO audit on Duolingo (id: 570060128).
What's its score and what should they improve?
ASO decision brief (orchestration):
Give me an ASO decision brief for Brilliant (id: 913335252) in the US.
Summarize prioritized actions and top keyword opportunities.
ASO metadata optimization:
I want to optimize my app (id: 913335252) for the keywords
"learn math", "science education", and "brain training".
Suggest optimized metadata for Apple and Google.
ASC Metrics (synced Sales & Trends):
What's my app's revenue and downloads for the last 30 days?
Use asc_get_metrics or asc_get_app_metrics.
Keyword opportunities:
Find keyword opportunities for Headspace (id: 493145008).
Which keywords should they target next?
Market movers:
Which apps gained the most ranks in the top-free chart today?
Show me the top gainers and any new entries in Games.
Market activity:
What's happening in the App Store right now?
Show me the latest chart activity for the US free apps chart.
ASO competitor analysis:
Run a full ASO competitor report comparing Brilliant (id: 913335252)
vs Khan Academy (id: 1157115554). Where is Brilliant falling behind?
App Store Connect reviews (synced + write-through):
Find every unanswered 1- or 2-star review for app 6759740679 from the last
two weeks that mentions "crash" or "bug", and reply with an empathetic
message that points to support@example.com. Then show me the updated
unanswered count.
Subscription health (MRR / Churn):
Pull subscription metrics for the last 90 days. Tell me whether MRR
growth is being driven by new subscribers, lower churn, or higher
trial conversion — and which app contributes most to MRR.

Tool Reference

search_apps

Search the App Store by keyword or numeric App ID.
ParameterTypeDefaultDescription
querystringrequiredSearch keyword or App ID
countrystringusISO country code
limitnumber20Max results (1-50)

get_app

Get metadata for a specific app.
ParameterTypeDefaultDescription
app_idstringrequiredApple App ID (numeric)
countrystringusISO country code

get_app_intelligence

Full intelligence report with downloads, revenue, and sentiment.
ParameterTypeDefaultDescription
app_idstringrequiredApple App ID
countrystringusISO country code

get_app_similar

Similar and competing apps via 3-layer matching (keyword overlap, title search, same developer).
ParameterTypeDefaultDescription
app_idstringrequiredApple App ID
countrystringusISO country code

get_keyword_ranks

All apps ranking for a keyword with metadata (rating, reviews, category, price).
ParameterTypeDefaultDescription
keywordstringrequiredKeyword to search
countrystringusISO country code
devicestringiphoneiphone or ipad

get_keyword_suggestions

Keyword ideas from a seed term with optional volume/difficulty metrics.
ParameterTypeDefaultDescription
termstringrequiredSeed term
countrystringusISO country code
expandbooleanfalseLong-tail expansion
metricsbooleantrueInclude volume/difficulty

get_keyword_metrics

Detailed metrics for a keyword.
ParameterTypeDefaultDescription
keywordstringrequiredKeyword to analyze
countrystringusISO country code

get_app_keywords

All keywords an app ranks for with trend data.
ParameterTypeDefaultDescription
app_idstringrequiredApple App ID
countrystringusISO country code
Historical rank data for a keyword + app pair.
ParameterTypeDefaultDescription
app_idstringrequiredApple App ID
keywordstringrequiredKeyword to track
countrystringusISO country code
daysnumber30History length (7-90)

compare_keywords

Compare keyword rankings between two apps.
ParameterTypeDefaultDescription
app_idstringrequiredYour app’s ID
competitor_idstringrequiredCompetitor’s ID
countrystringusISO country code

compare_keyword_cluster

Multi-competitor keyword lifecycle (your app + 1–5 competitors).
ParameterTypeDefaultDescription
app_idstringrequiredYour app’s Apple App ID
competitorsstringrequiredComma-separated competitor app IDs (1–5)
countrystringusISO country code

get_keyword_ranks_history

Historical apps-per-day counts for a tracked keyword.
ParameterTypeDefaultDescription
keywordstringrequiredKeyword
countrystringusISO country code
devicestringiphoneiphone or ipad
daysnumber14Lookback (1–90)

get_api_usage

Current billing period usage (0 credits).
ParameterTypeDefaultDescription
(none)

get_category_top

Top apps in a specific category or all categories.
ParameterTypeDefaultDescription
genre_idstringallGenre ID (e.g. 6014 for Games)
countrystringusISO country code
chartstringtop-freetop-free, top-paid, or top-grossing
limitnumber25Max results (1-100)

get_downloads_to_top

Estimated daily downloads needed to reach specific chart positions (#1, #5, #10, #25, #50, #100).
ParameterTypeDefaultDescription
genre_idstringallGenre ID (e.g. 6014 for Games)
countrystringusISO country code
chartstringtop-freetop-free, top-paid, or top-grossing
Keywords with the fastest-growing reach in the App Store.
ParameterTypeDefaultDescription
countrystringusISO country code
daysnumber7Trend window in days (1-30)
limitnumber50Max keywords to return (1-100)
Apps currently featured on the App Store Today tab.
ParameterTypeDefaultDescription
countrystringusISO country code

get_new_releases

Recently released apps.
ParameterTypeDefaultDescription
countrystringusISO country code
max_daysnumber7Show releases from last N days

aso_full_audit

Full ASO health audit with scoring, breakdown, and recommendations.
ParameterTypeDefaultDescription
app_idstringrequiredApple App ID
countrystringusISO country code

aso_validate_metadata

Validate metadata against Apple or Google character limits.
ParameterTypeDefaultDescription
platformstringrequiredapple or google
titlestringoptionalApp title
subtitlestringoptionalApple subtitle
keywordsstringoptionalApple keyword field (comma-separated)
short_descriptionstringoptionalGoogle short description
full_descriptionstringoptionalGoogle full description

aso_suggest_metadata

Generate optimized metadata from target keywords.
ParameterTypeDefaultDescription
app_idstringrequiredApple App ID
keywordsstring[]requiredTarget keywords array
countrystringusISO country code

aso_find_opportunities

Discover untapped keyword opportunities.
ParameterTypeDefaultDescription
app_idstringrequiredApple App ID
countrystringusISO country code

aso_brief

Orchestrated ASO brief: audit + opportunities, storefront readiness score, optional intent clusters, optional multi-country.
ParameterTypeDefaultDescription
app_idstringrequiredApple App ID
countrystringusISO country code (ignored if countries set)
countriesstringoptionalComma-separated ISO codes for per-country briefs
freshbooleanfalseForce fresh re-analysis (slower)
intent_clustersbooleanfalseSemantic intent clustering (+2 credits)

aso_competitor_report

Deep ASO comparison between two apps.
ParameterTypeDefaultDescription
app_idstringrequiredYour app’s ID
competitor_idstringrequiredCompetitor’s ID
countrystringusISO country code

get_app_screenshots

Get all screenshots for an app, separated by device type (iPhone and iPad).
ParameterTypeDefaultDescription
app_idstringrequiredApple App ID (numeric)
countrystringusISO country code
devicestringallDevice filter: iphone, ipad, or all

get_competitor_screenshots

Compare screenshots between an app and its competitors.
ParameterTypeDefaultDescription
app_idstringrequiredApple App ID
countrystringusISO country code
limitnumber5Number of competitor apps to include (1-10)

get_category_screenshots

Get screenshots for top-ranked apps in an App Store category.
ParameterTypeDefaultDescription
genre_idstringallGenre ID (e.g. 6014 for Games, or all)
countrystringusISO country code
chartstringtop-freetop-free, top-paid, or top-grossing
limitnumber10Number of apps (1-25)

asc_list_customer_reviews

List customer reviews for your app from App Store Connect. Requires ASC credentials.
ParameterTypeDefaultDescription
issuer_idstringrequiredApp Store Connect Issuer ID
key_idstringrequiredApp Store Connect Key ID
private_keystringrequiredApp Store Connect private key (PEM)
app_idstringrequiredApp Store Connect app ID
limitnumber50Max results per page (1-200)
cursorstringoptionalPagination cursor from previous response

asc_respond_to_review

Create or update your response to a single customer review. Transparently handles Apple’s edit-by-DELETE-then-POST flow — you always make a single tool call.
ParameterTypeDefaultDescription
issuer_idstringoptionalApp Store Connect Issuer ID (omit if ASC connected on your Appeeky account)
key_idstringoptionalApp Store Connect Key ID
private_keystringoptionalApp Store Connect private key (PEM)
review_idstringrequiredCustomer review ID (from asc_search_reviews or asc_list_customer_reviews)
response_bodystringrequiredYour response text (max 5970 chars — Apple’s hard limit)

asc_search_reviews

Search persisted customer reviews with rich filters. Reads from a synced copy of your App Store Connect reviews — much faster than asc_list_customer_reviews and supports filtering Apple’s API does not.
ParameterTypeDefaultDescription
app_idstringoptionalApp Store Connect app ID — omit to search across all your connected apps
ratingnumberoptionalFilter by exact star rating (1–5)
territorystringoptionalISO 3-letter country code (e.g. USA, GBR, DEU)
has_responsebooleanoptionaltrue for answered, false for unanswered, omit for both
qstringoptionalCase-insensitive substring match in title or body
limitnumber50Max results (1–200)
beforestringoptionalISO timestamp cursor — returns reviews created strictly before this date

asc_reviews_summary

Aggregated review stats: total count, average rating, star distribution, response rate, top territories.
ParameterTypeDefaultDescription
app_idstringoptionalFilter by app — omit for portfolio-wide summary

asc_delete_review_response

Delete your developer response to a review (idempotent — calling on a review with no response succeeds with response: null).
ParameterTypeDefaultDescription
issuer_idstringoptionalASC Issuer ID (omit if connected on Appeeky)
key_idstringoptionalASC Key ID
private_keystringoptionalASC private key (PEM)
review_idstringrequiredCustomer review ID whose response should be deleted

asc_refresh_review

Force-refresh a single review from Apple, bypassing the daily sync. Useful right after responding to confirm the PUBLISHED state.
ParameterTypeDefaultDescription
issuer_idstringoptionalASC Issuer ID (omit if connected on Appeeky)
key_idstringoptionalASC Key ID
private_keystringoptionalASC private key (PEM)
review_idstringrequiredCustomer review ID to refresh

asc_subscription_metrics

SaaS-grade subscription health: MRR, ARR, ARPU, churn rate, trial conversion rate, plus daily event counts (new, canceled, refunded, reactivated, trial starts/conversions, expired). Computed from Apple’s SUBSCRIPTION + SUBSCRIPTION_EVENT reports, FX-converted to USD using historical rates.
ParameterTypeDefaultDescription
app_idstringoptionalApp Store Connect app ID — omit to roll up across all your apps
start_datestring30 days agoISO date YYYY-MM-DD
end_datestringtodayISO date YYYY-MM-DD

My Apps Tools

Manage your appeeky.com apps, competitors, tracked keywords, metadata versions, and reports directly from your AI assistant. All tools cost 0 credits and require an API key generated from appeeky.com → Settings → API Key.
These tools operate on your appeeky.com account data — the same data visible in the web dashboard. The key must have the apps:read scope for reads and apps:write for writes (unrestricted keys have both by default).

list_my_apps

List all apps in your appeeky.com tracked app list.
ParameterTypeDefaultDescription
(none)Returns all your tracked apps

add_my_app

Add an app to your tracked list by its App Store ID.
ParameterTypeDefaultDescription
appIdnumberrequiredNumeric Apple App Store ID
appNamestringoptionalDisplay name
developerNamestringoptionalDeveloper name
bundleIdstringoptionalBundle identifier
subtitlestringoptionalApp subtitle
descriptionstringoptionalApp description
languagesstring[]optionalSupported language codes
isLivebooleanoptionalWhether the app is live on the App Store
categorystringoptionalApp category
platformstringiosios, macos, or tvos

update_my_app

Update metadata for an existing app in your tracked list.
ParameterTypeDefaultDescription
appIdnumberrequiredNumeric App Store ID of the app to update
appNamestringoptionalNew display name
isLivebooleanoptionalLive status
categorystringoptionalApp category
subtitlestringoptionalApp subtitle
descriptionstringoptionalApp description
languagesstring[]optionalSupported language codes

delete_my_app

Remove an app from your tracked list.
ParameterTypeDefaultDescription
appIdnumberrequiredNumeric App Store ID of the app to remove

list_competitors

List competitor apps tracked for one of your apps.
ParameterTypeDefaultDescription
appIdnumberrequiredNumeric App Store ID of your tracked app

add_competitor

Add a competitor app to one of your tracked apps.
ParameterTypeDefaultDescription
appIdnumberrequiredYour tracked app’s App Store ID
competitorAppIdnumberrequiredCompetitor’s App Store ID
competitorNamestringoptionalDisplay name for the competitor

remove_competitor

Remove a competitor from one of your tracked apps.
ParameterTypeDefaultDescription
appIdnumberrequiredYour tracked app’s App Store ID
competitorAppIdnumberrequiredCompetitor’s App Store ID to remove

list_tracked_keywords

List keywords tracked for one of your apps.
ParameterTypeDefaultDescription
appIdnumberrequiredNumeric App Store ID of your tracked app

add_tracked_keyword

Start tracking a keyword for one of your apps.
ParameterTypeDefaultDescription
appIdnumberrequiredYour tracked app’s App Store ID
keywordstringrequiredKeyword to track (e.g. "aso tool")
countrystringusISO country code
languagestringenISO language code

remove_tracked_keyword

Stop tracking a keyword.
ParameterTypeDefaultDescription
appIdnumberrequiredYour tracked app’s App Store ID
keywordIdstringrequiredUUID of the tracked keyword row (from list_tracked_keywords)

list_app_versions

List saved metadata versions for one of your apps.
ParameterTypeDefaultDescription
appIdnumberrequiredNumeric App Store ID of your tracked app

create_app_version

Save a new set of ASO metadata as a named version.
ParameterTypeDefaultDescription
appIdnumberrequiredYour tracked app’s App Store ID
versionNamestringrequiredLabel for this version (e.g. "v2.1 Spring")
titlestringoptionalApp title (max 30 chars)
subtitlestringoptionalApp subtitle (max 30 chars)
descriptionstringoptionalFull app description
keywordsstringoptionalComma-separated keyword field
languagestringen-USLocale code

update_app_version

Update fields on an existing metadata version.
ParameterTypeDefaultDescription
appIdnumberrequiredYour tracked app’s App Store ID
versionIdstringrequiredUUID of the version to update
versionNamestringoptionalNew label
titlestringoptionalUpdated title
subtitlestringoptionalUpdated subtitle
descriptionstringoptionalUpdated description
keywordsstringoptionalUpdated keyword field

release_app_version

Mark a metadata version as the currently released version.
ParameterTypeDefaultDescription
appIdnumberrequiredYour tracked app’s App Store ID
versionIdstringrequiredUUID of the version to mark as released

list_reports

List saved ASO reports for your account.
ParameterTypeDefaultDescription
appIdnumberoptionalFilter by a specific App Store ID
typestringoptionalFilter by report type (e.g. aso_audit, competitor)
limitnumber20Max results (max 100)
offsetnumber0Pagination offset

get_report

Retrieve the full content of a saved report.
ParameterTypeDefaultDescription
reportIdstringrequiredUUID of the report

delete_report

Permanently delete a saved report.
ParameterTypeDefaultDescription
reportIdstringrequiredUUID of the report to delete