Apple MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Apple: 32 typed functions through one MCP server. No Apple API key needed.

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

Connect

Just Apple

An MCP server for Apple 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/apple
Every site

One MCP server for Apple 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 29
  • checkCoverageLook up what warranty or AppleCare a device still has from its serial number.

    Arguments

    NameTypeRequired
    serialstringYes

    Returns AppleCoverageResult

    interface AppleCoverageResult {
      serial: string;
      found: boolean;
      errorToken?: string;
      raw?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/checkCoverage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.checkCoverage("F2LN3AB1JCL7");
  • compareModelsPut two or more models of the SAME family.

    Arguments

    NameTypeRequired
    modelsstring[]Yes

    Returns AppleCompareModels

    interface AppleCompareSpec {
      label: string;
      value: string;
    }
    
    interface AppleCompareModel {
      name: string;
      specs: AppleCompareSpec[];
    }
    
    interface AppleCompareModels {
      models: AppleCompareModel[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/compareModels

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.compareModels(["iPhone 17 Pro", "iPhone 17"]);
  • findStoresNearFind the Apple Stores near a place a person named.

    Arguments

    NameTypeRequired
    placestringYes

    Returns AppleStoresNear

    interface AppleNearbyStore {
      storeNumber: string;
      storeName: string;
      city: string;
      state: string;
      address: string;
      phoneNumber: string;
      distanceMiles: number | null;
    }
    
    interface AppleStoresNear {
      location: string;
      stores: AppleNearbyStore[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/findStoresNear

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.findStoresNear("cupertino");
  • getBagWhat's in the shopping bag right now, no sign-in needed.

    Arguments

    None.

    Returns AppleBagContents

    interface AppleBagContents {
      hasItems: boolean;
      raw: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getBag

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getBag();
  • getConfigurationOptionsRead every choice a buy page actually offers.

    Arguments

    NameTypeRequired
    urlOrPathstringYes

    Returns AppleConfigurationOptions

    interface AppleConfigChoice {
      key: string;
      label: string;
    }
    
    interface AppleConfigDimension {
      key: string;
      label: string;
      choices: AppleConfigChoice[];
    }
    
    interface AppleConfiguration {
      dimensions: Record<string, string>;
      partNumber: string | null;
      buildToOrder: boolean;
      price: number | null;
      priceCurrency: string | null;
    }
    
    interface AppleConfigurationOptions {
      url: string;
      dimensions: AppleConfigDimension[];
      configDimensions: AppleConfigDimension[];
      configurations: AppleConfiguration[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getConfigurationOptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getConfigurationOptions("/shop/buy-mac/macbook-air");
  • getDeliveryEstimateWhen would this actually arrive if I ordered it now, to my ZIP code.

    Arguments

    NameTypeRequired
    partNumberstringYes
    postalCodestringYes

    Returns AppleDeliveryEstimate

    interface AppleDeliveryOption {
      displayName: string;
      date: string;
      shippingCost: string;
    }
    
    interface AppleDeliveryEstimate {
      partNumber: string;
      postalCode: string;
      options: AppleDeliveryOption[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getDeliveryEstimate

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getDeliveryEstimate("MYAP3LL/A", "94301");
  • getNewsroomPostRead one Apple press release in full from its URL.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns AppleNewsroomArticle

    interface AppleNewsroomArticle {
      title: string;
      summary: string;
      date: string;
      url: string;
      body: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getNewsroomPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getNewsroomPost("<url>");
  • getOrderStatusWhere is one Apple order, and when does it arrive.

    Arguments

    NameTypeRequired
    orderNumberstringYes

    Returns AppleOrderStatus

    interface AppleOrderStatus {
      orderNumber: string;
      raw: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getOrderStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getOrderStatus("W000000000");
  • getPickupAvailabilityAnswer the one question apple.com is uniquely able to answer and no other site can: can I walk into a store today and pick this up.

    Arguments

    NameTypeRequired
    partNumberstringYes
    placestringYes

    Returns ApplePickupAvailability

    interface ApplePickupStore {
      storeNumber: string;
      storeName: string;
      city: string;
      state: string;
      address: string;
      phoneNumber: string;
      distanceMiles: number | null;
      available: boolean;
      pickupQuote: string | null;
    }
    
    interface ApplePickupAvailability {
      partNumber: string;
      location: string;
      stores: ApplePickupStore[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getPickupAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getPickupAvailability("MYAP3LL/A", "94301");
  • getProductReads one apple.com product/buy page (a URL or path search already returned, e.g. /shop/buy-iphone/iphone-16) and returns every schema.org Product…

    Arguments

    NameTypeRequired
    urlOrPathstringYes

    Returns AppleProductPage

    interface AppleProduct {
      name: string;
      lowPrice: number | null;
      highPrice: number | null;
      priceCurrency: string | null;
      image: string | null;
      description: string | null;
      partNumber: string | null;
    }
    
    interface AppleProductPage {
      url: string;
      products: AppleProduct[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getProduct("/shop/buy-iphone/iphone-16");
  • getProductByPartNumberTurn an Apple part number, the MYAP3LL/A-shaped code printed on every buy page, in every pickup and delivery answer, and on the box, into the product…

    Arguments

    NameTypeRequired
    partNumberstringYes

    Returns AppleProductPage

    interface AppleProduct {
      name: string;
      lowPrice: number | null;
      highPrice: number | null;
      priceCurrency: string | null;
      image: string | null;
      description: string | null;
      partNumber: string | null;
    }
    
    interface AppleProductPage {
      url: string;
      products: AppleProduct[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getProductByPartNumber

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getProductByPartNumber("MYAP3LL/A");
  • getPurchaseOptionsRead the ways Apple will let you pay for one product.

    Arguments

    NameTypeRequired
    urlOrPathstringYes

    Returns ApplePurchaseOptions

    interface ApplePurchaseOptionTerm {
      id: string;
      name: string;
      sectionHeader: string;
      sectionFooter: string;
    }
    
    interface ApplePurchaseOption {
      id: string;
      formValue: string;
      sectionHeader: string;
      sectionFooter: string;
      hideCarrier: boolean;
      terms: ApplePurchaseOptionTerm[];
    }
    
    interface ApplePurchaseOptions {
      url: string;
      options: ApplePurchaseOption[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getPurchaseOptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getPurchaseOptions("/shop/buy-mac/macbook-air");
  • getRepairPricingWhat Apple charges to fix an iPhone, iPad or Apple Watch.

    Arguments

    NameTypeRequired
    device"iphone" | "ipad" | "watch"Yes

    Returns AppleRepairPricing

    interface AppleRepairService {
      label: string;
      price: string;
    }
    
    interface AppleRepairModelPricing {
      model: string;
      outOfWarranty: AppleRepairService[];
      appleCarePlus: AppleRepairService[];
    }
    
    interface AppleRepairPricing {
      device: "iphone" | "ipad" | "watch";
      helpUrl: string | null;
      models: AppleRepairModelPricing[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getRepairPricing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getRepairPricing("iphone");
  • getStoreRead one Apple Store: its full address, phone number, map coordinates, store number and the hours it is open each day of the week.

    Arguments

    NameTypeRequired
    urlOrPathstringYes

    Returns AppleStore

    interface AppleStoreHours {
      days: string[];
      opens: string;
      closes: string;
    }
    
    interface AppleStore {
      storeNumber: string;
      name: string;
      url: string;
      phoneNumber: string;
      address: string;
      city: string;
      state: string;
      postalCode: string;
      latitude: number | null;
      longitude: number | null;
      hours: AppleStoreHours[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getStore

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getStore("/retail/thesummit/");
  • getSupportArticleRead one Apple support article end to end.

    Arguments

    NameTypeRequired
    docidOrUrlstringYes

    Returns AppleSupportArticle

    interface AppleSupportArticle {
      docid: string;
      title: string;
      description: string;
      url: string;
      body: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getSupportArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getSupportArticle("102640");
  • getSystemStatusIs App Store / iCloud / FaceTime / Apple Music down right now, or is it me.

    Arguments

    NameTypeRequired
    scope"consumer" | "developer"No

    Returns AppleSystemStatus

    interface AppleSystemEvent {
      messageId: string;
      statusType: string;
      message: string;
      eventStatus: "resolved" | "completed" | string;
      epochStartDate: number;
      epochEndDate: number;
    }
    
    interface AppleSystemServiceStatus {
      serviceName: string;
      redirectUrl: string | null;
      status: "operational" | "ongoing" | "recent";
      hasEvent: boolean;
      events: AppleSystemEvent[];
    }
    
    interface AppleSystemStatus {
      scope: "consumer" | "developer";
      drMessage: string | null;
      services: AppleSystemServiceStatus[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getSystemStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getSystemStatus();
  • getTradeInEstimateReads apple.com's own trade-in value table and returns the ceiling ("up to $X") cash-or-credit estimate it publishes for one iPhone model.

    Arguments

    NameTypeRequired
    modelstringYes

    Returns AppleTradeInEstimate

    interface AppleTradeInEstimate {
      device: string;
      upToUsd: number;
      sourceUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/getTradeInEstimate

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.getTradeInEstimate("iPhone 14 Pro");
  • listAccessoriesEverything Apple sells that is not a device.

    Arguments

    NameTypeRequired
    category"cases-protection" | "chargers-adapters" | "headphones-speakers" | "drives-storage" | "mice-keyboards" | "gaming" | "office" | "travel-essentials" | "college-essentials" | "software" | "homekit" | "content-creation" | "health-fitness" | "new-arrivals" | "made-by-apple" | "accessibility"Yes
    pagenumberNo

    Returns AppleAccessoryCatalog

    interface AppleAccessoryListing {
      partNumber: string;
      name: string;
      price: number | null;
      priceCurrency: string | null;
      url: string;
      image: string | null;
    }
    
    interface AppleAccessoryCatalog {
      category:
        | "cases-protection"
        | "chargers-adapters"
        | "headphones-speakers"
        | "drives-storage"
        | "mice-keyboards"
        | "gaming"
        | "office"
        | "travel-essentials"
        | "college-essentials"
        | "software"
        | "homekit"
        | "content-creation"
        | "health-fitness"
        | "new-arrivals"
        | "made-by-apple"
        | "accessibility";
      page: number;
      hasMore: boolean;
      listings: AppleAccessoryListing[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/listAccessories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.listAccessories("cases-protection");
  • listFamilyModelsList every model Apple currently sells in one product family.

    Arguments

    NameTypeRequired
    family"mac" | "iphone" | "ipad" | "watch"Yes

    Returns AppleFamilyModelList

    interface AppleFamilyModel {
      name: string;
      startingPrice: number | null;
      url: string;
    }
    
    interface AppleFamilyModelList {
      family: "mac" | "iphone" | "ipad" | "watch";
      models: AppleFamilyModel[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/listFamilyModels

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.listFamilyModels("mac");
  • listNewsroomPostsApple's official announcements, newest first.

    Arguments

    None.

    Returns AppleNewsroomPostList

    interface AppleNewsroomPost {
      title: string;
      category: string;
      date: string;
      url: string;
      summary: string;
    }
    
    interface AppleNewsroomPostList {
      posts: AppleNewsroomPost[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/listNewsroomPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.listNewsroomPosts();
  • listOrdersEverything I have bought from Apple, with dates and prices.

    Arguments

    None.

    Returns AppleOrderList

    interface AppleOrderList {
      rootKey: string;
      raw: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/listOrders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.listOrders();
  • listRefurbishedApple's own certified refurbished store, read as data: every listing currently in stock in one category.

    Arguments

    NameTypeRequired
    category"mac" | "ipad" | "iphone" | "watch" | "appletv" | "homepod" | "airpods" | "accessories"Yes

    Returns AppleRefurbishedCatalog

    interface AppleRefurbishedListing {
      partNumber: string;
      name: string;
      price: number | null;
      priceCurrency: string | null;
      url: string;
      image: string | null;
    }
    
    interface AppleRefurbishedCatalog {
      category: "mac" | "ipad" | "iphone" | "watch" | "appletv" | "homepod" | "airpods" | "accessories";
      listings: AppleRefurbishedListing[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/listRefurbished

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.listRefurbished("mac");
  • listStoresEvery Apple Store in the US on one call.

    Arguments

    None.

    Returns AppleStoreList

    interface AppleStoreListing {
      storeNumber: string;
      name: string;
      url: string;
    }
    
    interface AppleStoreList {
      stores: AppleStoreListing[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/listStores

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.listStores();
  • listTodaySessionsThe free Today at Apple sessions one store is running.

    Arguments

    NameTypeRequired
    storeSlugOrUrlstringYes

    Returns AppleTodaySessionList

    interface AppleTodaySession {
      sessionId: string;
      title: string;
      prefix: string;
      description: string;
      startTime: string;
      endTime: string;
      timeZone: string;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
      storeNum: string;
      storeName: string;
      icalUrl: string;
    }
    
    interface AppleTodaySessionList {
      storeSlug: string;
      sessions: AppleTodaySession[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/listTodaySessions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.listTodaySessions("unionsquare");
  • listTradeInValuesThe whole Apple Trade In price list in one call. "smartphone" is the rich catalogue behind the estimator.

    Arguments

    NameTypeRequired
    category"smartphone" | "computer" | "watch"Yes

    Returns AppleTradeInCatalog

    interface AppleTradeInDeviceValue {
      modelId: string | null;
      modelName: string;
      maxValueUsd: number;
    }
    
    interface AppleTradeInCatalog {
      category: "smartphone" | "computer" | "watch";
      devices: AppleTradeInDeviceValue[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/listTradeInValues

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.listTradeInValues("smartphone");
  • resolveLocationTurn the place a person said.

    Arguments

    NameTypeRequired
    placestringYes

    Returns AppleResolvedLocation

    interface AppleLocationSuggestion {
      displayValue: string;
      city: string;
      state: string;
    }
    
    interface AppleResolvedLocation {
      place: string;
      location: string;
      city: string;
      state: string;
      alternates: AppleLocationSuggestion[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/resolveLocation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.resolveLocation("cupertino");
  • searchSupportSearch Apple's own support library the way a person describes a problem.

    Arguments

    NameTypeRequired
    querystringYes

    Returns AppleSupportSearchResponse

    interface AppleSupportResult {
      docid: string;
      title: string;
      url: string;
      snippet: string;
    }
    
    interface AppleSupportSearchResponse {
      query: string;
      results: AppleSupportResult[];
      totalResults: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/searchSupport

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.searchSupport("iphone battery draining");
  • suggestSearchesType the first two letters of what you want.

    Arguments

    NameTypeRequired
    querystringYes

    Returns AppleSuggestResponse

    interface AppleSuggestionRow {
      label: string;
      url: string;
    }
    
    interface AppleSuggestResponse {
      query: string;
      suggestions: AppleSuggestionRow[];
      quickLinks: AppleSuggestionRow[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/suggestSearches

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.suggestSearches("airpo");
Act 3
  • addToBagAdd a product to the shopping bag (cart) by part number.

    Arguments

    NameTypeRequired
    partstringYes
    atbtokenstringYes
    apiKeystringYes
    storefrontstringYes
    optionsRecord<string, unknown>No

    Returns AppleAddToBagResult

    interface AppleAddToBagResult {
      addedToBag: boolean;
      bagQuantity?: number;
      errorCode?: string;
      message?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/addToBag

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.addToBag({
      part: "<part>",
      atbtoken: "<atbtoken>",
      apiKey: "<apiKey>",
      storefront: "<storefront>"
    });
  • bookGeniusBarAppointmentSubmit a Genius Bar / repair reservation's confirmation step.

    Arguments

    NameTypeRequired
    request{ locale: string; authToken: string; body: Record<string, unknown> }Yes

    Returns AppleGeniusBarBookingResult

    interface AppleGeniusBarBookingResult {
      raw: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/bookGeniusBarAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.bookGeniusBarAppointment({});
  • removeFromBagRemove an item from the shopping bag by its UUID.

    Arguments

    NameTypeRequired
    itemUuidstringYes
    csrfTokenstringYes

    Returns AppleRemoveFromBagResult

    interface AppleRemoveFromBagResult {
      success: boolean;
      message?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/apple/removeFromBag

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.apple.removeFromBag({ itemUuid: "<itemUuid>", csrfToken: "<csrfToken>" });

Use it from code