# Sonar MCP server

> Lets AI agents perform App Store Optimization research, track keyword rankings, analyze competitors, and audit app metadata for iOS and Android.

- Repository: https://github.com/trysonar/mcp
- Page: https://hostedmcp.org/servers/trysonar/mcp
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 0.7.0

## Install

### Claude Code

```sh
claude mcp add --env 'SONAR_API_KEY=<YOUR_SONAR_API_KEY>' mcp -- npx -y @sonarapp/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sonarapp/mcp"
      ],
      "env": {
        "SONAR_API_KEY": "<YOUR_SONAR_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sonarapp/mcp"
      ],
      "env": {
        "SONAR_API_KEY": "<YOUR_SONAR_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@sonarapp/mcp"],"env":{"SONAR_API_KEY":"<YOUR_SONAR_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sonarapp/mcp"
      ],
      "env": {
        "SONAR_API_KEY": "<YOUR_SONAR_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp --env 'SONAR_API_KEY=<YOUR_SONAR_API_KEY>' -- npx -y @sonarapp/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "@sonarapp/mcp"]

[mcp_servers.mcp.env]
SONAR_API_KEY = "<YOUR_SONAR_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'SONAR_API_KEY=<YOUR_SONAR_API_KEY>' mcp npx -- -y @sonarapp/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sonarapp/mcp"
      ],
      "env": {
        "SONAR_API_KEY": "<YOUR_SONAR_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SONAR_API_KEY` | yes | yes | Your Sonar API key (aso_...). Create one at https://trysonar.app |
| `SONAR_API_URL` | no | no | API base URL. Defaults to https://trysonar.app. |

## Tools (43)

- `sonar_app_lookup`
- `sonar_app_search`
- `sonar_app_aso_score`
- `sonar_app_extract_keywords`
- `sonar_app_reviews`
- `sonar_app_revenue`
- `sonar_keyword_search`
- `sonar_keyword_metrics`
- `sonar_keyword_suggestions`
- `sonar_top_charts`
- `sonar_list_products`
- `sonar_list_apps`
- `sonar_get_app`
- `sonar_app_overview`
- `sonar_app_keywords`
- `sonar_app_rankings`
- `sonar_app_changes`
- `sonar_keyword_rankings`
- `sonar_discovered_keywords`
- `sonar_competitor_keywords`
- `sonar_competitor_landscape`
- `sonar_review_insights`
- `sonar_list_alerts`
- `sonar_alert_events`
- `sonar_portfolio`
- `sonar_app_sales`
- `sonar_app_engagement`
- `sonar_create_product`
- `sonar_track_app`
- `sonar_track_competitor`
- `sonar_remove_competitor`
- `sonar_delete_product`
- `sonar_untrack_app`
- `sonar_track_keywords`
- `sonar_update_keyword_note`
- `sonar_star_keyword`
- `sonar_delete_tracked_keyword`
- `sonar_untrack_keywords`
- `sonar_scan_competitor`
- `sonar_analyze_competitors`
- `sonar_generate_review_insights`
- `sonar_set_alert`
- `sonar_delete_alert`

## FAQ

### How do I get an API key for advanced features?

You can obtain an API key at the Sonar developer portal, with options including prepaid API credits starting from $10.
