MCP Server - Appeeky REST API & MCP Server

The Appeeky MCP Server lets AI assistants like Claude, ChatGPT, Cursor, and any MCP-compatible client query App Store intelligence data directly. Go to Appeeky Developer Dashboard to get your API key.

MCP Endpoint: https://mcp.appeeky.com/mcp
Auth: Authorization: Bearer <your-api-key>

Connect Your Client

Pass your Appeeky API key via the Authorization: Bearer header when connecting.

Claude Desktop
Cursor
TypeScript Client
Python Client

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "appeeky": {
      "url": "https://mcp.appeeky.com/mcp",
      "headers": {
        "Authorization": "Bearer apk_your_key_here"
      }
    }
  }
}

Add to .cursor/mcp.json in your project or global settings:

{
  "mcpServers": {
    "appeeky": {
      "url": "https://mcp.appeeky.com/mcp",
      "headers": {
        "Authorization": "Bearer apk_your_key_here"
      }
    }
  }
}

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://mcp.appeeky.com/mcp"),
  {
    requestInit: {
      headers: {
        "Authorization": "Bearer apk_your_key_here"
      }
    }
  }
);

const client = new Client({ name: "my-app", version: "1.0.0" });
await client.connect(transport);

// Call a tool
const result = await client.callTool({
  name: "search_apps",
  arguments: { query: "fitness tracker", country: "us" }
});

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client(
    "https://mcp.appeeky.com/mcp",
    headers={"Authorization": "Bearer apk_your_key_here"}
) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        result = await session.call_tool(
            "search_apps",
            arguments={"query": "fitness tracker", "country": "us"}
        )
        print(result)

Available Tools

Apps

Tool	Description
`search_apps`	Search the App Store by keyword or app name
`get_app`	Get detailed metadata for a specific app
`get_app_intelligence`	Full intelligence report: downloads, revenue, sentiment, similar apps
`get_app_reviews`	Fetch user reviews with pagination
`get_country_rankings`	App rankings across all countries

Screenshots

Tool	Description
`get_app_screenshots`	Get all screenshots for an app, separated by device (iPhone/iPad)
`get_competitor_screenshots`	Compare screenshots between an app and its competitors
`get_category_screenshots`	Get screenshots for top apps in a category

Keywords

Tool	Description
`get_keyword_ranks`	All apps ranking for a keyword with rich metadata
`get_keyword_suggestions`	Keyword ideas from a seed term with volume/difficulty
`get_keyword_metrics`	Volume score, difficulty score, competition analysis
`get_app_keywords`	All keywords an app ranks for with trends
`get_keyword_trends`	Historical rank data over time (7-90 days)
`compare_keywords`	Compare keyword overlap between two apps
`track_keyword`	Add keyword to daily tracking
`get_trending_keywords`	Keywords with fastest-growing reach, ranked by growth percentage

ASO (App Store Optimization)

Tool	Description
`aso_full_audit`	Full ASO health audit — score (0-100), 9-factor breakdown, prioritized recommendations
`aso_validate_metadata`	Validate title/subtitle/keywords against Apple or Google character limits
`aso_suggest_metadata`	Generate optimized metadata suggestions based on target keywords
`aso_find_opportunities`	Discover untapped keyword opportunities (high volume + low difficulty)
`aso_competitor_report`	Deep ASO comparison between two apps with keyword gap analysis

Discovery & Featured

Tool	Description
`get_featured_apps`	App of the Day, Game of the Day, and curated editorial collections
`get_categories`	List all App Store categories
`get_category_top`	Top apps by category and chart type
`get_downloads_to_top`	Estimated downloads to reach chart positions
`get_new_releases`	Recently released apps
`discover`	Curated discovery feed (new releases + new #1 apps)
`get_new_number_1`	Apps that recently hit #1 in their category

Market Intelligence

Tool	Description
`get_market_movers`	Top gainers, losers, new entries, and apps that dropped out of charts
`get_market_activity`	Live feed of chart movements: new entries, rank ups/downs, exits

ASC Metrics (synced Sales & Trends)

Tool	Description
`asc_get_metrics`	Overview: totals, per-app breakdown, daily rows (2 credits)
`asc_list_metrics_apps`	List app IDs with metrics data (2 credits)
`asc_get_app_metrics`	App detail: daily series + country breakdown (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.

App Store Connect (requires your ASC credentials)

Tool	Description
`asc_list_apps`	List apps in your App Store Connect account
`asc_get_app`	Get app details by App Store Connect app ID
`asc_list_app_versions`	List versions for an app
`asc_list_version_localizations`	List metadata localizations for a version
`asc_update_localization`	Update description, keywords, whatsNew, etc.
`asc_list_customer_reviews`	List customer reviews for your app
`asc_respond_to_review`	Respond to a single customer review
`asc_list_app_analytics_requests`	List analytics report requests
`asc_create_analytics_request`	Create analytics report request
`asc_list_reports_for_request`	List reports for a request

ASC tools require issuer_id, key_id, and private_key — your App Store Connect API key. See App Store Connect Overview.

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 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:

List my app's customer reviews (ASC app ID 6759740679) and suggest 
responses for any 1–2 star reviews. Then respond to them one by one.

Tool Reference

search_apps

Search the App Store by keyword or numeric App ID.

Parameter	Type	Default	Description
`query`	string	required	Search keyword or App ID
`country`	string	`us`	ISO country code
`limit`	number	`20`	Max results (1-50)

get_app

Get metadata for a specific app.

Parameter	Type	Default	Description
`app_id`	string	required	Apple App ID (numeric)
`country`	string	`us`	ISO country code

get_app_intelligence

Full intelligence report with downloads, revenue, and sentiment.

Parameter	Type	Default	Description
`app_id`	string	required	Apple App ID
`country`	string	`us`	ISO country code

get_keyword_ranks

All apps ranking for a keyword with metadata (rating, reviews, category, price).

Parameter	Type	Default	Description
`keyword`	string	required	Keyword to search
`country`	string	`us`	ISO country code
`device`	string	`iphone`	`iphone` or `ipad`

get_keyword_suggestions

Keyword ideas from a seed term with optional volume/difficulty metrics.

Parameter	Type	Default	Description
`term`	string	required	Seed term
`country`	string	`us`	ISO country code
`expand`	boolean	`false`	Long-tail expansion
`metrics`	boolean	`true`	Include volume/difficulty

get_keyword_metrics

Detailed metrics for a keyword.

Parameter	Type	Default	Description
`keyword`	string	required	Keyword to analyze
`country`	string	`us`	ISO country code

get_app_keywords

All keywords an app ranks for with trend data.

Parameter	Type	Default	Description
`app_id`	string	required	Apple App ID
`country`	string	`us`	ISO country code

get_keyword_trends

Historical rank data for a keyword + app pair.

Parameter	Type	Default	Description
`app_id`	string	required	Apple App ID
`keyword`	string	required	Keyword to track
`country`	string	`us`	ISO country code
`days`	number	`30`	History length (7-90)

compare_keywords

Compare keyword rankings between two apps.

Parameter	Type	Default	Description
`app_id`	string	required	Your app’s ID
`competitor_id`	string	required	Competitor’s ID
`country`	string	`us`	ISO country code

get_category_top

Top apps in a specific category or all categories.

Parameter	Type	Default	Description
`genre_id`	string	`all`	Genre ID (e.g. `6014` for Games)
`country`	string	`us`	ISO country code
`chart`	string	`top-free`	`top-free`, `top-paid`, or `top-grossing`
`limit`	number	`25`	Max results (1-100)

get_downloads_to_top

Estimated daily downloads needed to reach specific chart positions (#1, #5, #10, #25, #50, #100).

Parameter	Type	Default	Description
`genre_id`	string	`all`	Genre ID (e.g. `6014` for Games)
`country`	string	`us`	ISO country code
`chart`	string	`top-free`	`top-free`, `top-paid`, or `top-grossing`

get_trending_keywords

Keywords with the fastest-growing reach in the App Store.

Parameter	Type	Default	Description
`country`	string	`us`	ISO country code
`days`	number	`7`	Trend window in days (1-30)
`limit`	number	`50`	Max keywords to return (1-100)

get_featured_apps

Apps currently featured on the App Store Today tab.

Parameter	Type	Default	Description
`country`	string	`us`	ISO country code

get_new_releases

Recently released apps.

Parameter	Type	Default	Description
`country`	string	`us`	ISO country code
`max_days`	number	`7`	Show releases from last N days

aso_full_audit

Full ASO health audit with scoring, breakdown, and recommendations.

Parameter	Type	Default	Description
`app_id`	string	required	Apple App ID
`country`	string	`us`	ISO country code

aso_validate_metadata

Validate metadata against Apple or Google character limits.

Parameter	Type	Default	Description
`platform`	string	required	`apple` or `google`
`title`	string	optional	App title
`subtitle`	string	optional	Apple subtitle
`keywords`	string	optional	Apple keyword field (comma-separated)
`short_description`	string	optional	Google short description
`full_description`	string	optional	Google full description

aso_suggest_metadata

Generate optimized metadata from target keywords.

Parameter	Type	Default	Description
`app_id`	string	required	Apple App ID
`keywords`	string[]	required	Target keywords array
`country`	string	`us`	ISO country code

aso_find_opportunities

Discover untapped keyword opportunities.

Parameter	Type	Default	Description
`app_id`	string	required	Apple App ID
`country`	string	`us`	ISO country code

aso_competitor_report

Deep ASO comparison between two apps.

Parameter	Type	Default	Description
`app_id`	string	required	Your app’s ID
`competitor_id`	string	required	Competitor’s ID
`country`	string	`us`	ISO country code

get_app_screenshots

Get all screenshots for an app, separated by device type (iPhone and iPad).

Parameter	Type	Default	Description
`app_id`	string	required	Apple App ID (numeric)
`country`	string	`us`	ISO country code
`device`	string	`all`	Device filter: `iphone`, `ipad`, or `all`

get_competitor_screenshots

Compare screenshots between an app and its competitors.

Parameter	Type	Default	Description
`app_id`	string	required	Apple App ID
`country`	string	`us`	ISO country code
`limit`	number	`5`	Number of competitor apps to include (1-10)

get_category_screenshots

Get screenshots for top-ranked apps in an App Store category.

Parameter	Type	Default	Description
`genre_id`	string	`all`	Genre ID (e.g. `6014` for Games, or `all`)
`country`	string	`us`	ISO country code
`chart`	string	`top-free`	`top-free`, `top-paid`, or `top-grossing`
`limit`	number	`10`	Number of apps (1-25)

asc_list_customer_reviews

List customer reviews for your app from App Store Connect. Requires ASC credentials.

Parameter	Type	Default	Description
`issuer_id`	string	required	App Store Connect Issuer ID
`key_id`	string	required	App Store Connect Key ID
`private_key`	string	required	App Store Connect private key (PEM)
`app_id`	string	required	App Store Connect app ID
`limit`	number	`50`	Max results per page (1-200)
`cursor`	string	optional	Pagination cursor from previous response

asc_respond_to_review

Create or update your response to a single customer review. One review per call.

Parameter	Type	Default	Description
`issuer_id`	string	required	App Store Connect Issuer ID
`key_id`	string	required	App Store Connect Key ID
`private_key`	string	required	App Store Connect private key (PEM)
`review_id`	string	required	Customer review ID (from asc_list_customer_reviews)
`response_body`	string	required	Your response text

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.

Parameter	Type	Default	Description
(none)	—	—	Returns all your tracked apps

add_my_app

Add an app to your tracked list by its App Store ID.

Parameter	Type	Default	Description
`appId`	number	required	Numeric Apple App Store ID
`appName`	string	optional	Display name
`developerName`	string	optional	Developer name
`bundleId`	string	optional	Bundle identifier
`subtitle`	string	optional	App subtitle
`description`	string	optional	App description
`languages`	string[]	optional	Supported language codes
`isLive`	boolean	optional	Whether the app is live on the App Store
`category`	string	optional	App category
`platform`	string	`ios`	`ios`, `macos`, or `tvos`

update_my_app

Update metadata for an existing app in your tracked list.

Parameter	Type	Default	Description
`appId`	number	required	Numeric App Store ID of the app to update
`appName`	string	optional	New display name
`isLive`	boolean	optional	Live status
`category`	string	optional	App category
`subtitle`	string	optional	App subtitle
`description`	string	optional	App description
`languages`	string[]	optional	Supported language codes

delete_my_app

Remove an app from your tracked list.

Parameter	Type	Default	Description
`appId`	number	required	Numeric App Store ID of the app to remove

list_competitors

List competitor apps tracked for one of your apps.

Parameter	Type	Default	Description
`appId`	number	required	Numeric App Store ID of your tracked app

add_competitor

Add a competitor app to one of your tracked apps.

Parameter	Type	Default	Description
`appId`	number	required	Your tracked app’s App Store ID
`competitorAppId`	number	required	Competitor’s App Store ID
`competitorName`	string	optional	Display name for the competitor

remove_competitor

Remove a competitor from one of your tracked apps.

Parameter	Type	Default	Description
`appId`	number	required	Your tracked app’s App Store ID
`competitorAppId`	number	required	Competitor’s App Store ID to remove

list_tracked_keywords

List keywords tracked for one of your apps.

Parameter	Type	Default	Description
`appId`	number	required	Numeric App Store ID of your tracked app

add_tracked_keyword

Start tracking a keyword for one of your apps.

Parameter	Type	Default	Description
`appId`	number	required	Your tracked app’s App Store ID
`keyword`	string	required	Keyword to track (e.g. `"aso tool"`)
`country`	string	`us`	ISO country code
`language`	string	`en`	ISO language code

remove_tracked_keyword

Stop tracking a keyword.

Parameter	Type	Default	Description
`appId`	number	required	Your tracked app’s App Store ID
`keywordId`	string	required	UUID of the tracked keyword row (from `list_tracked_keywords`)

list_app_versions

List saved metadata versions for one of your apps.

Parameter	Type	Default	Description
`appId`	number	required	Numeric App Store ID of your tracked app

create_app_version

Save a new set of ASO metadata as a named version.

Parameter	Type	Default	Description
`appId`	number	required	Your tracked app’s App Store ID
`versionName`	string	required	Label for this version (e.g. `"v2.1 Spring"`)
`title`	string	optional	App title (max 30 chars)
`subtitle`	string	optional	App subtitle (max 30 chars)
`description`	string	optional	Full app description
`keywords`	string	optional	Comma-separated keyword field
`language`	string	`en-US`	Locale code

update_app_version

Update fields on an existing metadata version.

Parameter	Type	Default	Description
`appId`	number	required	Your tracked app’s App Store ID
`versionId`	string	required	UUID of the version to update
`versionName`	string	optional	New label
`title`	string	optional	Updated title
`subtitle`	string	optional	Updated subtitle
`description`	string	optional	Updated description
`keywords`	string	optional	Updated keyword field

release_app_version

Mark a metadata version as the currently released version.

Parameter	Type	Default	Description
`appId`	number	required	Your tracked app’s App Store ID
`versionId`	string	required	UUID of the version to mark as released

list_reports

List saved ASO reports for your account.

Parameter	Type	Default	Description
`appId`	number	optional	Filter by a specific App Store ID
`type`	string	optional	Filter by report type (e.g. `aso_audit`, `competitor`)
`limit`	number	`20`	Max results (max `100`)
`offset`	number	`0`	Pagination offset

get_report

Retrieve the full content of a saved report.

Parameter	Type	Default	Description
`reportId`	string	required	UUID of the report

delete_report

Permanently delete a saved report.

Parameter	Type	Default	Description
`reportId`	string	required	UUID of the report to delete

Getting Started

Apps

My Data - Appeeky Web

Keywords

ASO Tools

Search & Discovery

Market Intelligence

RevenueCat

App Store Connect

Reference

​Connect Your Client

​Available Tools

​Apps

​Screenshots

​Keywords

​ASO (App Store Optimization)

​Discovery & Featured

​Market Intelligence

​ASC Metrics (synced Sales & Trends)

​App Store Connect (requires your ASC credentials)

​Example Prompts

​Tool Reference

​search_apps

​get_app

​get_app_intelligence

​get_keyword_ranks

​get_keyword_suggestions

​get_keyword_metrics

​get_app_keywords

​get_keyword_trends

​compare_keywords

​get_category_top

​get_downloads_to_top

​get_trending_keywords

​get_featured_apps

​get_new_releases

​aso_full_audit

​aso_validate_metadata

​aso_suggest_metadata

​aso_find_opportunities

​aso_competitor_report

​get_app_screenshots

​get_competitor_screenshots

​get_category_screenshots

​asc_list_customer_reviews

​asc_respond_to_review

​My Apps Tools

​list_my_apps

​add_my_app

​update_my_app

​delete_my_app

​list_competitors

​add_competitor

​remove_competitor

​list_tracked_keywords

​add_tracked_keyword

​remove_tracked_keyword

​list_app_versions

​create_app_version

​update_app_version

​release_app_version

​list_reports

​get_report

​delete_report

Connect Your Client

Available Tools

Apps

Screenshots

Keywords

ASO (App Store Optimization)

Discovery & Featured

Market Intelligence

ASC Metrics (synced Sales & Trends)

App Store Connect (requires your ASC credentials)

Example Prompts

Tool Reference

search_apps

get_app

get_app_intelligence

get_keyword_ranks

get_keyword_suggestions

get_keyword_metrics

get_app_keywords

get_keyword_trends

compare_keywords

get_category_top

get_downloads_to_top

get_trending_keywords

get_featured_apps

get_new_releases

aso_full_audit

aso_validate_metadata

aso_suggest_metadata

aso_find_opportunities

aso_competitor_report

get_app_screenshots

get_competitor_screenshots

get_category_screenshots

asc_list_customer_reviews

asc_respond_to_review

My Apps Tools

list_my_apps

add_my_app

update_my_app

delete_my_app

list_competitors

add_competitor

remove_competitor

list_tracked_keywords

add_tracked_keyword

remove_tracked_keyword

list_app_versions

create_app_version

update_app_version

release_app_version

list_reports

get_report

delete_report