sonar
Sign InGet Started
MCP Server + API for AI Agents

ASO tools for AI Agents

The official Sonar MCP server — drop App Store Optimization tools into Claude Desktop, Claude Code, Cursor, and Cline. Or hit the REST API directly from any agent framework.

Prepaid credits from $10 — no subscription, 50 free credits on signup.

[ 01 / 04 ]·MCP Server//

Install the MCP server

Published on npm as @sonarapp/mcp. Runs over stdio. No global install needed.

Claude Desktop / Cursor

Add to your client's MCP config:

{
  "mcpServers": {
    "sonar": {
      "command": "npx",
      "args": ["-y", "@sonarapp/mcp"],
      "env": {
        "SONAR_API_KEY": "aso_..."
      }
    }
  }
}

Claude Code

One-liner from your shell:

claude mcp add sonar \
  -e SONAR_API_KEY=aso_... \
  -- npx -y @sonarapp/mcp

Restart your session and the 13 sonar_* tools will be available.

Full setup guideView on npm
[ 02 / 04 ]·Endpoints//

Available Endpoints

Eight stateless endpoints covering app lookup, keyword research, reviews, ASO scoring, and revenue estimates. All are exposed as MCP tools, and callable directly via REST.

METHODENDPOINT
GET/api/v1/apps/lookup
GET/api/v1/apps/search
GET/api/v1/apps/aso-score
GET/api/v1/apps/extract-keywords
GET/api/v1/apps/reviews
GET/api/v1/keywords/metrics
GET/api/v1/keywords/search
GET/api/v1/keywords/suggestions
[ 03 / 04 ]·REST API//

Or call the API directly

Standard REST API with Bearer token auth. Works with any HTTP client, agent framework, or automation tool — same data as the MCP server.

curl -H "Authorization: Bearer aso_your_api_key" \
  "https://trysonar.app/api/v1/apps/lookup?store=ios&id=com.example.app"

All responses return { "data": ... } on success or { "error": { "code": "...", "message": "..." } } on failure. See the full API reference or the OpenAPI 3.1 spec.

[ 04 / 04 ]·CLI//

Or use it from your terminal

The companion @sonarapp/cli package exposes the same data via a sonar binary — perfect for shell scripts, CI/CD, and one-off lookups.

npm install -g @sonarapp/cli
sonar auth login
sonar keywords search "habit tracker" --store ios --table
CLI documentation

Get API Access

Sign up, claim 50 free credits, and start querying ASO data in minutes. Top up with packs from $10 when you need more — no subscription required.

Get Started — 50 Free Credits