ascope-mcp

MCP server for Ascope, a native macOS app that tracks App Store keyword rankings. It lets Cursor, Claude Code, Claude Desktop and any other MCP client read your rankings, research keywords and manage what you track.

This package is a small bridge: it speaks stdio to your assistant and forwards every call to the MCP server that Ascope runs on your own Mac. No data leaves your machine, and there is no API key.

Requirements

• macOS 14 Sonoma or later with Ascope installed and a Pro license — $89.99 a year, no free tier, refunded in full within 14 days

• Ascope open, with the server enabled in Settings → MCP

• Node.js 18 or later

Related MCP server: App Store Connect MCP

Install

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ascope": {
      "command": "npx",
      "args": ["-y", "ascope-mcp"]
    }
  }
}

Claude Code

claude mcp add ascope -- npx -y ascope-mcp

Claude Desktop

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "ascope": {
      "command": "npx",
      "args": ["-y", "ascope-mcp"]
    }
  }
}

Clients that support MCP over Streamable HTTP can also point straight at http://127.0.0.1:47321/mcp without this package.

Tools

The table above is what Ascope serves. With Ascope closed the bridge still connects and offers a single ascope_setup tool that explains what to install, so your assistant tells you what is missing instead of reporting a dead server. Open Ascope and the real tools replace it without restarting the client.

Things to ask

• "Which of my keywords dropped more than 5 places this week?"

• "Find 10 keywords with popularity above 30 and difficulty below 50 for my app in Germany, then start tracking them."

• "Compare where I rank for habit tracker in the US, UK and Canada."

• "Research budget planner: who are the top apps and how hard is it to rank?"

Configuration

The bridge finds Ascope on http://127.0.0.1:47321/mcp. If you changed the port in Settings → MCP it is picked up automatically; you can also set it explicitly:

ASCOPE_MCP_URL=http://127.0.0.1:50000/mcp npx -y ascope-mcp

License

MIT