For agents: the documentation index is llms.txt. Append .md to a page URL for Markdown.

// 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.

// START

See the data for yourself

Start discovering winning apps.

Upgrade to Pro