mcp-server

# @applyra/mcp-server

[![npm](https://img.shields.io/npm/v/@applyra/mcp-server)](https://www.npmjs.com/package/@applyra/mcp-server)
[![CI](https://github.com/applyra-io/mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/applyra-io/mcp-server/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)

MCP (Model Context Protocol) server for [Applyra](https://www.applyra.io). It connects your App Store and Google Play keyword data to AI assistants like ChatGPT, Claude, Cursor, Codex, VS Code Copilot, and more.

30 tools covering keyword rank tracking, difficulty and traffic scoring, listing audits and metadata simulation, competitor visibility, notes on your charts and what followed each one, autocomplete mining, niche clustering, and top charts, on the App Store and Google Play.

## Remote server (ChatGPT, Claude, Gemini CLI, VS Code, Cursor)

The same tools are hosted at `https://www.applyra.io/api/mcp` (Streamable HTTP, OAuth). Nothing to install and no API key: the client opens an Applyra sign-in page, you approve it, and it is connected. It requires an Applyra account with the **Unlimited plan**.

- **ChatGPT**: on chatgpt.com, Plugins > Add > Create custom MCP server, with this URL and OAuth authentication, then Create as a plugin. Read and write tools both work on a ChatGPT Plus plan.
- **Claude**: add it from the [Claude directory](https://claude.ai/directory/applyra) in one click (on the web, desktop, mobile and in Claude Code), or as a custom connector with this URL (Customize > Connectors > Add custom connector).
- **Gemini CLI**: `gemini extensions install https://github.com/applyra-io/mcp-server`, then sign in when Gemini CLI asks.
- **VS Code, Cursor, Perplexity, Smithery** and any client that supports remote MCP servers with OAuth: add this URL as a remote (HTTP) server.

Connected assistants are listed, and can be disconnected, at [applyra.io/dashboard/mcp](https://www.applyra.io/dashboard/mcp).

## Prerequisites (local server)

- Node.js 20 or later
- An Applyra account with the **Unlimited plan**
- An API key, generated at [applyra.io/dashboard/api](https://www.applyra.io/dashboard/api)

## Installation

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "applyra": {
      "command": "npx",
      "args": ["-y", "@applyra/mcp-server"],
      "env": {
        "APPLYRA_API_KEY": "your_api_key"
      }
    }
  }
}
```

### Cursor

Install the Applyra plugin from the Cursor Marketplace and set the `APPLYRA_API_KEY` environment variable. The plugin also ships an ASO research skill that guides the agent through the tools.

Or add the server manually to `.cursor/mcp.json` or `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "applyra": {
      "command": "npx",
      "args": ["-y", "@applyra/mcp-server"],
      "env": {
        "APPLYRA_API_KEY": "your_api_key"
      }
    }
  }
}
```

### VS Code (GitHub Copilot)

Add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "applyra": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@applyra/mcp-server"],
      "env": {
        "APPLYRA_API_KEY": "your_api_key"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add applyra -e APPLYRA_API_KEY=your_api_key -- npx -y @applyra/mcp-server
```

### Codex

Note `--env`, where Claude Code takes `-e`.

```bash
codex mcp add applyra --env APPLYRA_API_KEY=your_api_key -- npx -y @applyra/mcp-server
```

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "applyra": {
      "command": "npx",
      "args": ["-y", "@applyra/mcp-server"],
      "env": {
        "APPLYRA_API_KEY": "your_api_key"
      }
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `list_applications` | List tracked apps with store metadata, ratings, keyword count and ASO Health scores |
| `add_application` | Track a new application by its store bundle ID. Fetches store metadata and computes the initial visibility score |
| `list_keywords` | Tracked keywords with current rank, favorite flag, difficulty/traffic scores |
| `track_keywords` | Track up to 20 new keywords for an application in a single call |
| `untrack_keyword` | Stop tracking a keyword for an application (soft delete) |
| `set_keyword_favorite` | Mark or unmark a tracked keyword as favorite for a specific app |
| `inspect_keyword` | Deep-analyze any keyword: difficulty, traffic, KEI, top 20 apps, related keywords |
| `list_keyword_inspections` | Past keyword inspections with their scores |
| `run_autocomplete` | Fetch autocomplete suggestions from the App Store or Google Play |
| `list_autocomplete_history` | Past autocomplete queries |
| `run_niche_analysis` | Cluster a niche topic into sub-niches with opportunity scores |
| `list_niche_analyses` | Past niche analyses |
| `top_charts` | Top apps chart for a store/country/category/collection, with daily rank movement |
| `list_top_chart_categories` | Categories and collections supported by `top_charts`, per store |
| `get_keyword_rank_history` | Daily rank evolution over a date range |
| `get_app_score_history` | Daily visibility score history for an app, with the notes and updates in the range |
| `list_notes` | The notes on an app's charts, numbered like their flags |
| `add_note` | Note what you did on a day (a campaign, a metadata change, a launch) |
| `update_note` | Change the text or the day of a note |
| `delete_note` | Delete a note |
| `compare_events` | Visibility, or a keyword's rank, before and after each note and app update |
| `get_aso_health` | Full listing audit for an app: coverage, targeting and appeal, every field, and what to fix |
| `check_metadata` | Check draft listing text against each store's limits and forbidden copy. Instant, no store lookup |
| `simulate_metadata` | Score a listing that does not exist yet and see the gain against the app's current score |
| `list_metadata_simulations` | Listing drafts already scored on the account (titles and scores) |
| `get_metadata_simulation` | One saved draft in full: its four fields, its context and its findings |
| `list_competitors` | Competitor pairs with side-by-side visibility scores |
| `add_competitor` | Add a competitor app to one of your applications by its store bundle ID |
| `remove_competitor` | Remove a competitor relationship by its internal ID |
| `get_account_usage` | Current usage vs. plan limits |

## Learn more

- [Applyra](https://www.applyra.io): ASO for indie developers, with a permanent free plan
- [MCP setup guide](https://www.applyra.io/dashboard/mcp) (requires an account)
- [REST API documentation](https://www.applyra.io/dashboard/api) (requires an account)

## License

MIT. See [LICENSE](./LICENSE).