<p align="center"><img src="assets/logo.png" width="96" alt="AppTrack Ninja"></p>

# 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](https://apptrack.ninja)
keyword tracker from Claude, Cursor or any MCP client.

Full guide with every tool: **[apptrack.ninja/tools/mcp](https://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](https://apptrack.ninja) (free plan works; Pro lifts the limits).
2. Open **Account → MCP / IDE** ([direct link](https://apptrack.ninja/account?tab=mcp)).
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:

```text
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

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

With a key instead of sign-in:

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

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

### VS Code (GitHub Copilot)

`.vscode/mcp.json` in your workspace:

```json
{
  "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

ninja@apptrack.ninja · [apptrack.ninja](https://apptrack.ninja)

## License

The documentation in this repository is MIT licensed. The AppTrack Ninja service is
subject to its [terms of service](https://apptrack.ninja/terms).