English Français العربية

io.github.sarisen/ascope-mcp

Official registry Marketing and sales

Daily App Store keyword ranks, popularity and difficulty, from Ascope for Mac

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package ascope-mcp
Claude Code 
claude mcp add ascope-mcp -e 'ASCOPE_MCP_URL=<ASCOPE_MCP_URL>' -- npx -y ascope-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ascope-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "ascope-mcp@0.1.1"
            ],
            "env": {
                "ASCOPE_MCP_URL": "<ASCOPE_MCP_URL>"
            }
        }
    }
}

Environment variables

  • ASCOPE_MCP_URL Endpoint of the MCP server that Ascope runs on your Mac. Defaults to http://127.0.0.1:47321/mcp, and a custom port set in Ascope's settings is detected automatically.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ascope-mcp
  2. Requirements
  3. Install
  4. Tools
  5. Things to ask
  6. Configuration
  7. License

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

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

ToolWhat it does
list_appsList the apps you track, with keyword counts.
list_keywordsTracked keywords for an app with rank, change, popularity, difficulty and number of results.
keyword_historyDaily rank history of one tracked keyword.
add_keywordsStart tracking keywords and fetch their rank, popularity and difficulty.
remove_keywordsStop tracking keywords.
refresh_rankingsFetch fresh rankings for all or some of an app's keywords.
research_keywordLook up any keyword without tracking it: popularity, difficulty, top apps and your rank.
suggest_keywordsKeyword ideas from App Store search suggestions, with popularity for the strongest.
ranked_keywordsSearches where a tracked app already shows up but isn't tracked yet, from cached lookups.
app_ratingsAverage rating and rating count per country, with daily history.
search_appsSearch the App Store to find an app ID.
similar_appsApps the App Store recommends next to an app: its closest competitors.
add_appStart tracking an app by its App Store ID.

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

Frequently asked questions

What is io.github.sarisen/ascope-mcp?

Daily App Store keyword ranks, popularity and difficulty, from Ascope for Mac

How do I install io.github.sarisen/ascope-mcp?

It runs on your machine. In Claude Code: claude mcp add ascope-mcp -e 'ASCOPE_MCP_URL=<ASCOPE_MCP_URL>' -- npx -y ascope-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.sarisen/ascope-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.sarisen/ascope-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.sarisen/ascope-mcp?

It is published by sarisen. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.