// DOCS
AppHitlist MCP server
Claude Code, Cursor and other AI assistants query AppHitlist with an API key: new winners, daily chart risers, revenue, complaint themes and Meta ads.
The server URL is https://apphitlist.com/api/mcp. An API key is required. Create one on the API key page, then send it as a bearer token.
- API key setup — Create a key and add the server to Claude Code or Cursor.
- OAuth discovery — How clients learn that the key goes in the Authorization header.
Tools
- Tool reference — Purpose, parameters and an example call for each tool.
find_new_winning_apps
Apps released in the last six months that already earn $10K or more a month, highest first. Optionally one category.
category— Optional. A category name such as "Health & Fitness" or a short name such as "fitness". Leave it out for all categories.limit— Optional. Integer from 1 to 50. Default 20.
find_top_earning_apps
The highest-earning apps, in one category or across all of them, highest first.
category— Optional. A category name such as "Health & Fitness" or a short name such as "fitness". Leave it out for all categories.limit— Optional. Integer from 1 to 50. Default 20.
find_chart_movers
Daily App Store chart movement in 36 countries: apps that climbed the most places and apps that just entered the list, with previous rank, new rank and change. Pick the list (grossing, free or paid), a category and a date.
country— Optional. Two-letter App Store country code such as us, gb, de, jp, tr or br. Default us.chart— Optional. grossing, free or paid. Default grossing.category— Optional. A category name such as "Health & Fitness" or a short name such as "fitness". Leave it out for all categories.date— Optional. Chart day as YYYY-MM-DD (UTC). Default: the latest day.days— Optional. Integer from 1 to 28: compare with the chart this many days earlier. 1 is day over day, 7 is week over week. Default 1.limit— Optional. Integer from 1 to 50, applied to risers and new entries separately. Default 20.
find_longest_running_ads
Active Meta ads that have been running the longest, in one category or across all of them. Pro.
category— Optional. A category name such as "Health & Fitness" or a short name such as "fitness". Leave it out for all categories.limit— Optional. Integer from 1 to 20. Default 10.
get_category_complaints
The most common complaint topics across all apps in one category, with review counts, app counts and example apps. Pro.
category— A category name such as "Health & Fitness" or a short name such as "fitness".kind— Optional. product, billing or price: only complaints of that kind.limit— Optional. Integer from 1 to 30. Default 15.
search_apps
Search apps by app or developer name.
query— App or developer name. 2 to 80 characters.limit— Optional. Integer from 1 to 10. Default 5.
get_app
One app by App Store link, id or name: category, release date, and revenue and download ranges. Subscribers get one monthly figure instead.
app— App Store URL (https://apps.apple.com/.../id123456789), numeric App Store id, or app name. 1 to 200 characters.
get_app_complaints
Top complaint themes from 1 and 2 star reviews. Pro.
app— App Store URL (https://apps.apple.com/.../id123456789), numeric App Store id, or app name. 1 to 200 characters.
get_app_ads
Active Meta ads for the app, longest running first. Pro.
app— App Store URL (https://apps.apple.com/.../id123456789), numeric App Store id, or app name. 1 to 200 characters.limit— Optional. Integer from 1 to 20. Default 10.
Limits
- Free keys: 20 tool calls a month. Revenue and downloads are ranges.
- Pro keys: 60 calls a minute. Subscribers get revenue and downloads as one monthly figure instead of ranges, plus price, ratings and a 30-day rank summary.
Client guide
Step-by-step setup for each client, the tool reference and an agent skill are in the public repository: https://github.com/mmdincer/apphitlist-mcp
// FAQ
Questions people ask before they start
What is the MCP endpoint?
The MCP endpoint is https://apphitlist.com/api/mcp. Clients connect with OAuth or with an API key sent as a bearer token.
What does a free account include?
A free account gets 20 MCP calls a month. Revenue and downloads come back as ranges.
What does Pro cost?
Pro is $19.99 a month.