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

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.

Keyword opportunities:

Find keyword opportunities for Headspace (id: 493145008).
Which keywords should they target next?

ASO competitor analysis:

Run a full ASO competitor report comparing Brilliant (id: 913335252)
vs Khan Academy (id: 1157115554). Where is Brilliant falling behind?

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)

Authentication

Each user passes their own Appeeky API key via the Authorization: Bearer <key> or X-API-Key header. Tool calls consume credits from the user’s plan, same as direct API usage. See Rate Limits for the full credit cost table.

Never hardcode API keys in files committed to version control. Use environment variables or secrets management.

Endpoints

URL	Description
`POST https://mcp.appeeky.com/mcp`	MCP Streamable HTTP endpoint
`GET https://mcp.appeeky.com/health`	Health check
`GET https://mcp.appeeky.com/`	Server info

Architecture

AI Client (Claude, ChatGPT, Cursor)
    ↓ MCP Protocol (Streamable HTTP)
https://mcp.appeeky.com/mcp
    ↓ HTTPS + User's API Key
https://api.appeeky.com/v1/...
    ↓
Apple App Store Data

The MCP server is a stateless proxy. Each request creates a fresh session, authenticates with the user’s API key, and forwards tool calls to api.appeeky.com.

Getting Started

Apps

Keywords

ASO Tools

Search & Discovery

Reference

​Connect Your Client

​Available Tools

​Apps

​Screenshots

​Keywords

​ASO (App Store Optimization)

​Discovery & Featured

​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

​Authentication

​Endpoints

​Architecture

Connect Your Client

Available Tools

Apps

Screenshots

Keywords

ASO (App Store Optimization)

Discovery & Featured

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

Authentication

Endpoints

Architecture