Apple App Store MCP server for AI agents

Let Claude, ChatGPT or your own agent read Apple App Store: 17 typed functions through one MCP server. No Apple App Store API key needed.

Functions
17
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Apple App Store

An MCP server for Apple App Store alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/app_store
Every site

One MCP server for Apple App Store and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 17
  • getAppRead one app the way its store listing reads: name, developer and seller, price, average rating and rating count (overall and for the current…

    Arguments

    NameTypeRequired
    appstring | numberYes
    countrystringNo

    Returns AppStoreApp

    interface AppStoreApp {
      id: string;
      name: string;
      bundleId: string;
      developer: { id: string; name: string; url: string | null; website: string | null }; // url = their apps.apple.com page, website = their own site
      price: { amount: number; currency: string; formatted: string; isFree: boolean } | null;
      rating: { average: number; count: number } | null; // all versions, this storefront
      currentVersionRating: { average: number; count: number } | null;
      category: string; // primary genre name
      categoryId: string | null; // primary genre id, listTopCharts' genreId
      genres: string[];
      url: string;
      description: string | null;
      whatsNew: string | null; // the current version's release notes
      seller: string | null;
      contentRating: string | null; // e.g. "17+"
      advisories: string[];
      version: string | null;
      minimumOsVersion: string | null;
      fileSizeBytes: number | null;
      languages: string[]; // ISO 639-1, upper-case, e.g. "EN"
      releasedAt: string | null; // ISO timestamp, first release
      updatedAt: string | null; // ISO timestamp, current version
      iconUrl: string | null;
      screenshotUrls: string[];
      ipadScreenshotUrls: string[];
      appleTvScreenshotUrls: string[];
      hasGameCenter: boolean | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/getApp

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.getApp({ app: 618783545 });
  • getAppDetailsEverything the store page shows that the API does not: the five-star histogram behind the average (how many 5s, 4s, 3s, 2s, 1s), the app's LIVE chart…

    Arguments

    NameTypeRequired
    appstring | numberYes
    countrystringNo

    Returns AppStoreAppDetails

    interface AppStoreRatingHistogram {
      average: number;
      total: number;
      counts: number[];
    }
    
    interface AppStoreChartPosition {
      category: string;
      position: number;
    }
    
    interface AppStoreInAppPurchase {
      name: string;
      price: string;
    }
    
    interface AppStorePrivacyCategory {
      type: string;
      title: string;
      categories: string[];
    }
    
    interface AppStoreVersionInfo {
      version: string | null;
      releaseDate: string | null;
      notes: string;
    }
    
    interface AppStoreLink {
      label: string;
      url: string;
    }
    
    interface AppStoreFeaturedStory {
      title: string;
      url: string;
    }
    
    interface AppStoreAppDetails {
      id: string;
      country: string;
      url: string;
      ratings: AppStoreRatingHistogram | null;
      chartPosition: AppStoreChartPosition | null;
      editorsChoice: boolean;
      information: Record<string, string>;
      inAppPurchases: AppStoreInAppPurchase[];
      privacy: AppStorePrivacyCategory[];
      mostRecentVersion: AppStoreVersionInfo | null;
      accessibilityFeatures: string[];
      links: AppStoreLink[];
      featuredIn: AppStoreFeaturedStory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/getAppDetails

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.getAppDetails({ app: 618783545 });
  • getAppsRead up to fifty apps in ONE request, for when an agent already holds a list of ids.

    Arguments

    NameTypeRequired
    apps(string | number)[]Yes
    countrystringNo

    Returns GetAppsResult

    interface AppStoreApp {
      id: string;
      name: string;
      bundleId: string;
      developer: { id: string; name: string; url: string | null; website: string | null }; // url = their apps.apple.com page, website = their own site
      price: { amount: number; currency: string; formatted: string; isFree: boolean } | null;
      rating: { average: number; count: number } | null; // all versions, this storefront
      currentVersionRating: { average: number; count: number } | null;
      category: string; // primary genre name
      categoryId: string | null; // primary genre id, listTopCharts' genreId
      genres: string[];
      url: string;
      description: string | null;
      whatsNew: string | null; // the current version's release notes
      seller: string | null;
      contentRating: string | null; // e.g. "17+"
      advisories: string[];
      version: string | null;
      minimumOsVersion: string | null;
      fileSizeBytes: number | null;
      languages: string[]; // ISO 639-1, upper-case, e.g. "EN"
      releasedAt: string | null; // ISO timestamp, first release
      updatedAt: string | null; // ISO timestamp, current version
      iconUrl: string | null;
      screenshotUrls: string[];
      ipadScreenshotUrls: string[];
      appleTvScreenshotUrls: string[];
      hasGameCenter: boolean | null;
    }
    
    interface GetAppsResult {
      apps: AppStoreApp[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/getApps

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.getApps({ apps: [618783545, 570060128] });
  • getStoryRead an App Store editorial story.

    Arguments

    NameTypeRequired
    storystring | numberYes
    platformAppStoreDeviceNo
    countrystringNo

    Returns AppStoreStory

    interface AppStoreStoryApp {
      id: string;
      bundleId: string;
      name: string;
      subtitle: string;
      developer: string; // display name only (the story page carries no id), for this developer's catalog call listDeveloperApps({ app: row.id })
      ageRating: string;
      rating: { average: number; countLabel: string } | null;
      price: string;
      url: string;
    }
    
    interface AppStoreStory {
      id: string;
      country: string;
      url: string;
      heading: string;
      title: string;
      subtitle: string;
      body: string;
      apps: AppStoreStoryApp[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/getStory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.getStory({ story: "<story>" });
  • listAppEventsList the in-app events an app is running or about to run.

    Arguments

    NameTypeRequired
    appstring | numberYes
    countrystringNo

    Returns ListAppEventsResult

    interface AppStoreAppEvent {
      id: string;
      title: string;
      subtitle: string | null;
      detail: string | null;
      kind: string | null;
      startDate: string | null;
      endDate: string | null;
      url: string | null;
    }
    
    interface ListAppEventsResult {
      id: string;
      country: string;
      url: string;
      events: AppStoreAppEvent[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listAppEvents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listAppEvents({ app: 1094591345 });
  • listArcadeGamesList the games on Apple's Apple Arcade page.

    Arguments

    NameTypeRequired
    deviceAppStoreDeviceNo
    countrystringNo

    Returns ListArcadeGamesResult

    type AppStoreDevice = "iphone" | "ipad" | "mac";
    
    interface AppStoreArcadeGame {
      id: string;
      name: string;
      developer: string | null;
      tagline: string | null;
      ageRating: string | null;
      rating: number | null;
      shelf: string | null;
      availability: string | null; // "Expected Dec 3, 2026" on a coming-soon game
    }
    
    interface ListArcadeGamesResult {
      device: AppStoreDevice;
      country: string;
      games: AppStoreArcadeGame[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listArcadeGames

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listArcadeGames({});
  • listCategoriesList every category and subcategory the App Store sorts apps into.

    Arguments

    None.

    Returns ListCategoriesResult

    interface AppStoreCategory {
      id: string;
      name: string;
      parentId: string | null;
    }
    
    interface ListCategoriesResult {
      categories: AppStoreCategory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listCategories();
  • listCollectionsList the named collections on the App Store's Games tab or Apps tab.

    Arguments

    NameTypeRequired
    tabAppStoreCollectionTabYes
    deviceAppStoreCollectionDeviceNo
    countrystringNo

    Returns ListCollectionsResult

    type AppStoreCollectionTab = "games" | "apps";
    
    type AppStoreCollectionDevice = "iphone" | "ipad";
    
    interface AppStoreCollectionApp {
      id: string;
      name: string;
      developer: string | null;
      subtitle: string | null;
      ageRating: string | null;
      rating: { average: number; countLabel: string } | null;
    }
    
    interface AppStoreCollection {
      title: string;
      apps: AppStoreCollectionApp[];
    }
    
    interface ListCollectionsResult {
      tab: AppStoreCollectionTab;
      device: AppStoreCollectionDevice;
      country: string;
      collections: AppStoreCollection[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listCollections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listCollections({ tab: "games" });
  • listDeveloperAppsList every app one developer has on the store.

    Arguments

    NameTypeRequired
    developerstring | numberNo
    appstring | numberNo
    countrystringNo
    limitnumberNo

    Returns ListDeveloperAppsResult

    interface AppStoreApp {
      id: string;
      name: string;
      bundleId: string;
      developer: { id: string; name: string; url: string | null; website: string | null }; // url = their apps.apple.com page, website = their own site
      price: { amount: number; currency: string; formatted: string; isFree: boolean } | null;
      rating: { average: number; count: number } | null; // all versions, this storefront
      currentVersionRating: { average: number; count: number } | null;
      category: string; // primary genre name
      categoryId: string | null; // primary genre id, listTopCharts' genreId
      genres: string[];
      url: string;
      description: string | null;
      whatsNew: string | null; // the current version's release notes
      seller: string | null;
      contentRating: string | null; // e.g. "17+"
      advisories: string[];
      version: string | null;
      minimumOsVersion: string | null;
      fileSizeBytes: number | null;
      languages: string[]; // ISO 639-1, upper-case, e.g. "EN"
      releasedAt: string | null; // ISO timestamp, first release
      updatedAt: string | null; // ISO timestamp, current version
      iconUrl: string | null;
      screenshotUrls: string[];
      ipadScreenshotUrls: string[];
      appleTvScreenshotUrls: string[];
      hasGameCenter: boolean | null;
    }
    
    interface ListDeveloperAppsResult {
      developer: { id: string; name: string };
      apps: AppStoreApp[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listDeveloperApps

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listDeveloperApps({ developer: 453420243 });
  • listPurchasedAppsList the apps the caller's own Apple Account has bought or downloaded, with what was paid and when.

    Arguments

    NameTypeRequired
    batchIdstring
    The nextBatchId a previous call returned; omit for the newest purchases.
    No

    Returns ListPurchasedAppsResult

    interface ListPurchasedAppsResult {
      batchId: string | null;
      nextBatchId: string | null; // pass back as batchId for the next, older batch
      raw: unknown; // Apple's own purchase-search JSON, unaltered, the signed-in shape is unmeasured
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listPurchasedApps

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listPurchasedApps({});
  • listReviewsRead what people actually wrote about an app.

    Arguments

    NameTypeRequired
    appstring | number
    Numeric id, bundle id, or apps.apple.com URL (its country segment picks the storefront).
    Yes
    limitnumber
    1-500, default 50, the feed holds 10 pages of 50.
    No
    pagenumber
    1-10, the page to START from, default 1.
    No
    sortByAppStoreReviewSortNo
    countrystringNo

    Returns ListReviewsResult

    type AppStoreReviewSort = "mostRecent" | "mostHelpful";
    
    interface AppStoreReview {
      id: string;
      author: string;
      title: string;
      body: string;
      rating: number | null;
      version: string;
      helpfulVotes: number;
      totalVotes: number;
      updated: string;
    }
    
    interface ListReviewsResult {
      app: string; // the numeric id, resolved from a bundle id when that is what was passed
      page: number; // the page the walk started from
      pagesRead: number;
      limit: number;
      sortBy: AppStoreReviewSort;
      country: string;
      hasMore: boolean;
      reviews: AppStoreReview[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listReviews({ app: 618783545 });
  • listSimilarAppsAnswer "what else is like this one" with the App Store's own You Might Also Like shelf.

    Arguments

    NameTypeRequired
    appstring | numberYes
    countrystringNo

    Returns AppStoreSimilarAppsResult

    interface AppStoreSimilarApp {
      id: string;
      bundleId: string;
      name: string;
      subtitle: string;
      ageRating: string;
      price: string;
      rating: { average: number; countLabel: string } | null;
      url: string;
    }
    
    interface AppStoreSimilarAppsResult {
      id: string;
      country: string;
      apps: AppStoreSimilarApp[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listSimilarApps

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listSimilarApps({ app: 618783545 });
  • listSubscriptionsList the App Store subscriptions the caller's own Apple Account is paying for.

    Arguments

    None.

    Returns ListSubscriptionsResult

    interface ListSubscriptionsResult {
      url: string;
      raw: string; // Apple's own subscriptions page, unaltered, the signed-in shape is unmeasured
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listSubscriptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listSubscriptions({});
  • listTodayStoriesList the editorial stories Apple is featuring on the Today tab right now.

    Arguments

    NameTypeRequired
    deviceAppStoreDeviceNo
    countrystringNo

    Returns ListTodayStoriesResult

    type AppStoreDevice = "iphone" | "ipad" | "mac";
    
    interface AppStoreTodayStory {
      id: string;
      title: string;
      url: string;
    }
    
    interface ListTodayStoriesResult {
      device: AppStoreDevice;
      country: string;
      stories: AppStoreTodayStory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listTodayStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listTodayStories({});
  • listTopChartsWhat is charting on the App Store right now.

    Arguments

    NameTypeRequired
    deviceAppStoreChartDeviceNo
    chartAppStoreChartKindNo
    genreIdstring | numberNo
    countrystringNo
    limitnumberNo

    Returns ListTopChartsResult

    type AppStoreDevice = "iphone" | "ipad" | "mac";
    
    type AppStoreChartDevice = AppStoreDevice | "watch" | "tv";
    
    type AppStoreChartKind = "free" | "paid";
    
    interface AppStoreChartApp {
      position: number;
      id: string;
      bundleId: string;
      name: string;
      subtitle: string;
      developer: string; // display name only, for this developer's catalog call listDeveloperApps({ app: row.id })
      developerId?: string; // artist id, ONLY on rows hydrated past the page's first 25, listDeveloperApps({ developer: row.developerId })
      ageRating: string;
      price: string;
      rating: { average: number; countLabel: string } | null;
      url: string;
    }
    
    interface ListTopChartsResult {
      device: AppStoreChartDevice;
      chart: AppStoreChartKind;
      genreId: string;
      country: string;
      source: "page" | "feed";
      apps: AppStoreChartApp[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listTopCharts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listTopCharts({ limit: 5 });
  • listVersionHistoryRead an app's update history from its store page.

    Arguments

    NameTypeRequired
    appstring | numberYes
    countrystringNo

    Returns ListVersionHistoryResult

    interface AppStoreVersionHistoryEntry {
      version: string;
      releaseDate: string | null; // ISO 8601
      notes: string;
    }
    
    interface ListVersionHistoryResult {
      id: string;
      country: string;
      url: string;
      versions: AppStoreVersionHistoryEntry[]; // newest first
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/listVersionHistory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.listVersionHistory({ app: 1094591345 });
  • searchAppsSearch the App Store for what a person would actually type.

    Arguments

    NameTypeRequired
    termstringYes
    platformAppStorePlatformNo
    genreIdstring | numberNo
    countrystringNo
    limitnumberNo

    Returns AppStoreSearchResult

    interface AppStoreApp {
      id: string;
      name: string;
      bundleId: string;
      developer: { id: string; name: string; url: string | null; website: string | null }; // url = their apps.apple.com page, website = their own site
      price: { amount: number; currency: string; formatted: string; isFree: boolean } | null;
      rating: { average: number; count: number } | null; // all versions, this storefront
      currentVersionRating: { average: number; count: number } | null;
      category: string; // primary genre name
      categoryId: string | null; // primary genre id, listTopCharts' genreId
      genres: string[];
      url: string;
      description: string | null;
      whatsNew: string | null; // the current version's release notes
      seller: string | null;
      contentRating: string | null; // e.g. "17+"
      advisories: string[];
      version: string | null;
      minimumOsVersion: string | null;
      fileSizeBytes: number | null;
      languages: string[]; // ISO 639-1, upper-case, e.g. "EN"
      releasedAt: string | null; // ISO timestamp, first release
      updatedAt: string | null; // ISO timestamp, current version
      iconUrl: string | null;
      screenshotUrls: string[];
      ipadScreenshotUrls: string[];
      appleTvScreenshotUrls: string[];
      hasGameCenter: boolean | null;
    }
    
    type AppStorePlatform = "iphone" | "ipad" | "mac";
    
    interface AppStoreSearchResult {
      term: string;
      platform: AppStorePlatform;
      country: string;
      total: number;
      apps: AppStoreApp[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/app_store/searchApps

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.app_store.searchApps({ term: "slack" });

Use it from code