AppTrack Ninja

AppTrack Ninja MCP server

App Store and Google Play intelligence for AI assistants. Search and inspect any iOS app, read chart rankings, version history, in-app events, ads and publisher portfolios, see which icon and screenshot redesigns moved ranks, and manage your AppTrack Ninja keyword tracker from Claude, Cursor or any MCP client.

Full guide with every tool: apptrack.ninja/tools/mcp

This is a hosted remote server: there is nothing to install or run. This repository documents how to connect to it.

Endpoint	https://mcp.apptrack.ninja
Transport	Streamable HTTP
Auth	OAuth sign-in, or Authorization: Bearer <key>
Plans	Free: one key, 25 calls a day, 10 a minute, 10 results per list · Pro: three keys, 600 reads and 30 searches a minute, full result pages, estimates, the ads library
Earlier endpoint	https://api.apptrack.ninja/mcp keeps working with the same sign-ins and keys

Get a key

Clients with OAuth (Claude, Claude Code, VS Code, Cursor, Windsurf, Codex, Gemini CLI) open the AppTrack Ninja sign-in on first use; no key needed. For other clients:

1. Sign in at apptrack.ninja (free plan works; Pro lifts the limits).
2. Open Account → MCP / IDE (direct link).
3. Create a key. It is shown once; keys start with ninja_.

Connect

Ask your AI agent

Agents that can edit their own configuration (Claude Code, Cursor, Codex, Windsurf) can add the server themselves. Paste this and replace the key:

Add the AppTrack Ninja MCP server to this tool.
Endpoint: https://mcp.apptrack.ninja (Streamable HTTP)
Send this header with every request: Authorization: Bearer ninja_your_key
Setup guide: https://apptrack.ninja/tools/mcp

Claude Code

claude mcp add --transport http --scope user apptrack https://mcp.apptrack.ninja
claude mcp login apptrack

With a key instead of sign-in:

claude mcp add --transport http --scope user apptrack https://mcp.apptrack.ninja --header "Authorization: Bearer ninja_your_key"

Cursor

~/.cursor/mcp.json, or .cursor/mcp.json in a project:

{
  "mcpServers": {
    "apptrack": {
      "url": "https://mcp.apptrack.ninja",
      "headers": { "Authorization": "Bearer ninja_your_key" }
    }
  }
}

VS Code (GitHub Copilot)

.vscode/mcp.json in your workspace:

{
  "servers": {
    "apptrack": {
      "type": "http",
      "url": "https://mcp.apptrack.ninja",
      "headers": { "Authorization": "Bearer ninja_your_key" }
    }
  }
}

Other clients

Any client that supports remote MCP servers with custom headers:

• URL: https://mcp.apptrack.ninja
• Transport: Streamable HTTP
• Header: Authorization: Bearer ninja_your_key. Gateways that reserve Authorization can send the key in X-Api-Key instead.

Claude Desktop and claude.ai custom connectors: add https://mcp.apptrack.ninja as a custom connector and sign in with AppTrack Ninja when asked (OAuth).

Tools

Tool	What it does
Search and catalog
search_apps	Plain-language App Store search (developer country, genre, dates, ratings are read from the text)
find_apps	Filtered catalog: text, storefront, monetization, rating, dates, sort order, cursor paging
get_publisher	Publisher identity and their apps
App details
get_app	App detail: title, description, version and screenshots
get_app_market	Price, rating, version and in-app purchases in one storefront
get_app_versions	Version history with release dates and release notes
get_app_events	App Store In-App Events: running, upcoming and past
get_app_transfers	When the app moved between publisher accounts
Charts, ratings and estimates
trending_apps	Top free, paid and grossing charts for a storefront
get_app_ranks	Chart positions today, the 7-day move and the best (Pro: daily series)
get_rating_history	Daily rating and rating count (3 days free, 30 with Pro)
get_app_estimates	30-day download and revenue estimates (Pro)
Creative analysis and ads
creative_changes	Icon and screenshot redesigns of chart apps and their rank effect against the app's usual update; ten countries
get_app_creative_history	Every icon and screenshot change of one app with its rank effect (free: the latest one)
get_app_ads	The app's ads from Apple's Ad Repository and Meta's Ad Library, EU (Pro)
Google Play (beta)
gplay_top_charts	Google Play top charts by country and category
gplay_get_app	One Play app: texts, installs, rating, its App Store twin, daily installs
Keyword tracker
list_tracked_apps	Apps in your ASO tracker
add_tracked_app	Add an app to your ASO tracker (writes)
add_tracked_keywords	Track keywords for an app (writes)
get_tracked_keywords	Tracked keywords with rank, popularity and difficulty
get_keyword_history	Daily rank history for one tracked keyword
Account
whoami	The plan on this key and remaining calls this minute

Every tool except the two tracker writes only reads AppTrack Ninja's stored data; nothing removes or overwrites anything.

On the free plan list tools return up to 10 rows and, once the 25 daily calls are used, answer with an upgrade note until the next UTC day.

Example prompts

• "What are the top grossing games in Japan right now?"
• "Show me the apps published by Duolingo and their ratings."
• "Which icon and screenshot redesigns lifted chart ranks in the US this month?"
• "Show the release notes of Notion's last five versions."
• "Compare Block Blast! on the App Store and Google Play."
• "Track the keywords 'pdf scanner' and 'scan to pdf' for my app 6736992829, then show their current ranks."

Support

[email protected] · apptrack.ninja

License

The documentation in this repository is MIT licensed. The AppTrack Ninja service is subject to its terms of service.