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
platformisios(App Store, default) orandroid(Google Play) onarh_search_store_apps,arh_add_app,arh_search_keywordsandarh_competitors. Tracked apps already know their store.store_idis 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
0means 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
[email protected] and the Help Center.
Made by DedalDev. MIT licensed.