# ASO Atlas

Wires ASO Atlas into your agent: search popularity, ranks across 59 storefronts and App Store Connect numbers. Handy when metadata edits sit next to the code.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: asoatlas
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/asoatlas/mcp
- Updated: 2026-09-29
- HTML: https://affpapa.org/en/nevibecode/mcp/aso-atlas

## What it does

ASO Atlas runs as a hosted MCP server at `https://asoatlas.com/mcp` over Streamable HTTP. Read tools surface what your account already holds: tracked apps, visibility movement, a metadata breakdown per storefront, an App Store Connect digest. Keyword research is separate — up to 50 terms at a time with a difficulty score and result counts, autocomplete ideas, plus a reverse lookup showing what any App Store app ranks for.

Writes touch your ASO Atlas account and nothing else; the store listing stays as it is. You can start or stop tracking an app, add keywords and competitors, move an app to another storefront, queue a fresh rating check, save a title or subtitle draft for the optimizer. Each tool declares `readOnlyHint`, `destructiveHint` and `openWorldHint`, and the destructive ones state in their description that ranking history goes with them.

An ASO Atlas account with an active subscription is required. Regular clients sign in through OAuth 2.1 with PKCE and dynamic client registration. Headless setups — containers, an agent on a server — never receive the OAuth callback, so they need a personal access token instead: create one in the account settings and pass it in an `Authorization: Bearer YOUR_TOKEN` header.

## Requirements
- Remote server: `https://asoatlas.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://asoatlas.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add aso-atlas --url https://asoatlas.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aso-atlas": {
            "url": "https://asoatlas.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aso-atlas": {
            "type": "http",
            "url": "https://asoatlas.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http aso-atlas https://asoatlas.com/mcp
```

## When to use it
- pull difficulty scores for a batch of terms before rewriting metadata
- see which queries a rival App Store app ranks for
- spot missing terms in a title and subtitle for one storefront
- chart a daily App Store Connect metric
- add competitors and read the keyword gap

## Example prompts
- Show me which queries this App Store app ranks for
- Check the metadata for the US storefront and list the terms I am missing
- Track these keywords and queue a fresh rank check

## Similar
- [aso-appstore-screenshots](https://affpapa.org/en/nevibecode/skills/aso-appstore-screenshots.md) — skill · 837 installs
- [asc-aso-audit](https://affpapa.org/en/nevibecode/skills/asc-aso-audit.md) — skill · 6200 installs
- [aso-audit](https://affpapa.org/en/nevibecode/skills/aso-audit.md) — skill · 4500 installs
- [seasonal-aso](https://affpapa.org/en/nevibecode/skills/seasonal-aso.md) — skill · 2400 installs
- [aso](https://affpapa.org/en/nevibecode/skills/arnabbagxd-aso.md) — skill · 1500 installs
- [app-store-aso](https://affpapa.org/en/nevibecode/skills/app-store-aso.md) — skill · 496 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md