Apprankhero MCP Server

AppRankHero MCP server

Your AppRankHero keyword rankings for the App Store (iOS) and Google Play (Android), inside ChatGPT, Claude, Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI and any other MCP client.

Ask in plain language:

• "Which of my keywords dropped out of the top 10 this week?"
• "Find popular, low difficulty keywords for a habit tracker in Germany."
• "Who outranks me for 'focus timer' and what do they have in their title?"
• "Track 'app blocker' and 'screen time' for my app in the US and UK."

Answers come live from your AppRankHero data, refreshed every morning.

Requirements

An AppRankHero Pro or Studio plan. Your license key starts with ARH- and is in the Mac app under Account. See plans and how to activate a key.

Hosted server (recommended)

Nothing to install. One URL for every client:

https://apprankhero.com/mcp

Streamable HTTP, two ways to sign in:

• OAuth. ChatGPT, Claude and Perplexity open an AppRankHero page where you paste your license key once.
• Bearer header. Developer tools send Authorization: Bearer ARH-XXXX.

Claude (claude.ai and Claude Desktop)

Settings, Connectors, Add custom connector, paste the URL, Connect.

ChatGPT

Settings, Apps, turn on Developer mode, Create, paste the URL, Authentication OAuth, Connect.

Claude Code

claude mcp add --transport http apprankhero https://apprankhero.com/mcp \
  --scope user --header "Authorization: Bearer ARH-XXXX"

Codex

export ARH_TOKEN=ARH-XXXX
codex mcp add apprankhero --url https://apprankhero.com/mcp --bearer-token-env-var ARH_TOKEN

Cursor, Windsurf, VS Code and other JSON configs

{
  "mcpServers": {
    "apprankhero": {
      "url": "https://apprankhero.com/mcp",
      "headers": { "Authorization": "Bearer ARH-XXXX" }
    }
  }
}

VS Code uses "servers" instead of "mcpServers" and "type": "http". Step by step guides for every client: apprankhero.com/help/connect-ai-tools-mcp.

Local stdio server

For clients that only run local servers. Needs Node.js 18 or later.

{
  "mcpServers": {
    "apprankhero": {
      "command": "npx",
      "args": ["-y", "github:DedalDev/apprankhero-mcp"],
      "env": { "ARH_LICENSE_KEY": "ARH-XXXX" }
    }
  }
}

The hosted and the local server offer the same tools.

Tools

Every tool carries MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) so clients can ask before write calls. Write tools need the owner or member role; viewers are read only. Plan limits apply exactly as in the Mac app.

App Store and Google Play

• platform is ios (App Store, default) or android (Google Play) on arh_search_store_apps, arh_add_app, arh_search_keywords and arh_competitors. Tracked apps already know their store.
• store_id is the numeric App Store id (6772967892) or the package name (com.example.app).
• Ranks are tracked within the top 200 on the App Store and the top 30 on Google Play. Rank 0 means not ranked in that range.

Privacy and security

• The server only sees data of the teams your license key belongs to.
• Privacy Policy and Terms of Service.

Support

hello@apprankhero.com and the Help Center.

Made by DedalDev. MIT licensed.