Amazon MCP server for AI agents

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

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

Connect

Just Amazon

An MCP server for Amazon 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/amazon
Every site

One MCP server for Amazon 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 19
  • getCartRead what is in the cart, line items, quantities, per-item and total price, and, for a cart with items, a checkout handoff URL (checkout) for the…

    Arguments

    NameTypeRequired
    opts{ connection?: string }No

    Returns AmazonCart

    interface AmazonCartItem {
      asin: string;
      title: string;
      quantity: number;
      price: number | null;
    }
    
    interface AmazonCart {
      itemCount: number;
      items: AmazonCartItem[];
      readAs?: "signed-in" | "guest"; // addToCart and getCart, which cart answered
      // The checkout handoff. Amazon never gets an order from Bowmark: give the person handoff.url, tell them
      // handoff.account.hint, and stop. status "ready_to_checkout" (urlKind "carries_items": Amazon's own
      // add-to-cart link carrying every cart row, for a guest cart; or "signed_in_cart" with
      // account.signedInAs: the account's own cart page), "needs_login" (signed in, account name unknown:
      // the cart page, after signing in to the connected account), or "unavailable" with a reason
      // (out_of_stock, region_not_served, not_sold_online). Absent on getCart for an empty cart. A status
      // you do not recognise means: show the person handoff.url and stop.
      checkout?: {
        status: string;
        url: string;
        urlKind?: string;
        account: { site: string; hint: string; signedInAs?: string };
        summary: unknown;
        warnings: string[];
        reason?: string;
        detail?: string;
      };
      warnings?: string[]; // only when the cart read answered but no handoff could be built from it
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/getCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.getCart();
  • getDeliveryEstimateWhen a product would actually arrive at a given US ZIP, and what it costs to get it there.

    Arguments

    NameTypeRequired
    productstring
    Required: or pass it as asin, which the runtime reads as the same field.
    No
    asinstringNo
    zipstringYes

    Returns AmazonDeliveryEstimate

    interface AmazonDeliveryEstimate {
      asin: string;
      zip: string;
      zipResolved: boolean; // false = the fields below are Amazon's default location, not this zip
      deliveryDate: string | null;
      priceLabel: string | null;
      condition: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      options: { kind: "standard" | "fastest"; deliveryDate: string | null; deliveryDateIso: string | null; priceLabel: string | null; condition: string | null; cutoff: string | null }[]; // every promise the buy box renders; "fastest" = Prime/paid same- or next-day
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.getDeliveryEstimate({ product: "B00006JSUA", zip: "10001" });
  • getProductRead one product page on any Amazon market the way a shopper reads it.

    Arguments

    NameTypeRequired
    asinOrUrlstringYes
    options.marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No

    Returns AmazonProductDetail

    interface AmazonBestSellerRankEntry {
      category: string;
      rank: number;
    }
    
    interface AmazonProductDetail {
      asin: string;
      title: string;
      url: string;
      brand: string | null;
      price: number | null;
      listPrice: number | null;
      currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in)
      inStock: boolean;
      availabilityText: string | null;
      rating: number | null;
      ratingCount: number | null;
      features: string[]; // the site's own free-text bullet points, read them off a result, never guess one from prose
      specifications: Record<string, string>;
      breadcrumbs: string[];
      bestSellersRank: AmazonBestSellerRankEntry[];
      images: string[];
      soldBy: string | null;
      sellerId: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.getProduct("B00006JSUA");
  • getReviewSummaryWhat reviewers say about a product, as Amazon shows it to a shopper who is not logged in: the star rating, the rating count, the percent at each…

    Arguments

    NameTypeRequired
    asinOrUrlstringYes
    options.marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No

    Returns AmazonReviewSummary

    interface AmazonReviewAspect {
      label: string; // Amazon's own, e.g. "ease of cleaning"
      sentiment: string; // "positive" | "negative" | "mixed"
      mentions: number | null; // how many reviews mention it
      summary: string;
      excerpts: Array<{ reviewId: string; text: string }>; // real review excerpts, verbatim
    }
    
    interface AmazonReviewSummary {
      asin: string;
      rating: number | null;
      ratingCount: number | null;
      histogram: Record<string, number>; // percent at each star, keyed "5" … "1"
      summary: string | null; // the "Customers say" paragraph
      aspects: AmazonReviewAspect[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/getReviewSummary

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.getReviewSummary("B00006JSUA");
  • getSellerRead a marketplace seller's storefront.

    Arguments

    NameTypeRequired
    sellerIdstringYes
    options.marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No

    Returns AmazonSeller

    interface AmazonSellerRatingPeriod {
      averageRating: number | null;
      ratingCount: number | null;
    }
    
    interface AmazonSeller {
      sellerId: string;
      name: string;
      positivePercentageLast12Months: number | null; // Amazon's own headline figure; no lifetime equivalent is published
      ratings: {
        last30Days: AmazonSellerRatingPeriod;
        last90Days: AmazonSellerRatingPeriod;
        last12Months: AmazonSellerRatingPeriod;
        lifetime: AmazonSellerRatingPeriod;
      };
      businessName: string | null;
      businessAddress: string[];
      aboutSeller: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/getSeller

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.getSeller("AYBHI2AQPIRDU");
  • listBestSellerCategoriesList the departments Amazon publishes rankings for.

    Arguments

    NameTypeRequired
    marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No

    Returns AmazonBestSellerCategory[]

    interface AmazonBestSellerCategory {
      name: string;
      slug: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/listBestSellerCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.listBestSellerCategories();
  • listBestSellersAmazon's hourly-updated top 100 in a department.

    Arguments

    NameTypeRequired
    argsstring | ListBestSellersArgsYes
    options.marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No
    type AmazonMarket = "com" | "in" | "com.br" | "ca" | "co.uk" | "de" | "fr" | "com.mx";
    
    interface ListBestSellersArgs {
      market?: AmazonMarket; // which Amazon store: "com" (default), "in", "com.br", "ca", "co.uk", "de", "fr", "com.mx"
      department: string;
      page?: number;
    }

    Returns AmazonBestSellerEntry[]

    interface AmazonBestSellerEntry {
      asin: string;
      rank: number;
      title: string;
      url: string;
      price: number | null;
      currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in)
      rating: number | null;
      ratingCount: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/listBestSellers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.listBestSellers("kitchen");
  • listCategoryProductsBrowse a whole department with no keyword at all.

    Arguments

    NameTypeRequired
    marketAmazonMarket
    Which Amazon store: "com" (default), "in", "com.br", "ca", "co.uk", "de", "fr", "com.mx".
    No
    departmentstringYes
    sortstringNo
    pagenumberNo

    Returns AmazonCategoryListing

    interface AmazonProduct {
      asin: string;
      title: string;
      url: string;
      price: number | null;
      listPrice: number | null;
      currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in)
      rating: number | null;
      ratingCount: number | null;
      sponsored: boolean;
      image: string | null; // the card's thumbnail URL
    }
    
    interface AmazonCategoryListing {
      department: string; // display label, e.g. "Kitchen & Dining", not an input anywhere
      departmentAlias: string; // the &i= alias that produced the page: pass THIS back to listCategoryProducts / searchProducts as department (not a listBestSellers slug)
      products: AmazonProduct[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/listCategoryProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.listCategoryProducts({ department: "kitchen", sort: "review-rank" });
  • listDealsToday's Deals, what is discounted right now, with the deal price, the price it was, the percentage off and any "limited time" wording.

    Arguments

    NameTypeRequired
    marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No

    Returns AmazonDeal[]

    interface AmazonDeal {
      asin: string;
      title: string;
      url: string;
      dealPrice: number;
      listPrice: number | null;
      currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in)
      percentOff: number | null;
      limitedTimeText: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/listDeals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.listDeals();
  • listMostWishedForWhat people in a department are adding to wish lists and registries most.

    Arguments

    NameTypeRequired
    departmentstringYes
    options.marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No

    Returns AmazonBestSellerEntry[]

    interface AmazonBestSellerEntry {
      asin: string;
      rank: number;
      title: string;
      url: string;
      price: number | null;
      currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in)
      rating: number | null;
      ratingCount: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/listMostWishedFor

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.listMostWishedFor("kitchen");
  • listNewReleasesWhat is newly out in a department, in Amazon's own hot-new-releases order.

    Arguments

    NameTypeRequired
    argsstring | ListBestSellersArgsYes
    options.marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No
    type AmazonMarket = "com" | "in" | "com.br" | "ca" | "co.uk" | "de" | "fr" | "com.mx";
    
    interface ListBestSellersArgs {
      market?: AmazonMarket; // which Amazon store: "com" (default), "in", "com.br", "ca", "co.uk", "de", "fr", "com.mx"
      department: string;
      page?: number;
    }

    Returns AmazonBestSellerEntry[]

    interface AmazonBestSellerEntry {
      asin: string;
      rank: number;
      title: string;
      url: string;
      price: number | null;
      currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in)
      rating: number | null;
      ratingCount: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/listNewReleases

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.listNewReleases("kitchen");
  • listOrdersThe signed-in customer's own Amazon orders, newest first.

    Arguments

    NameTypeRequired
    args{ limit?: number; cursor?: string }No

    Returns SignedInOrderPage

    interface SignedInOrder {
      id: string;               // Amazon's order number, e.g. "114-1234567-1234567"
      placedAt: string | null;  // YYYY-MM-DD
      status: string;           // Amazon's own words: "Delivered October 5", "Cancelled", "Refunded"
      total: number | null;     // dollars
      currency: string | null;  // "USD"
      merchant: string | null;  // always null here, Amazon's card does not name a seller
      itemCount: number | null;
      url: string;              // the order's details page
    }
    
    interface SignedInOrderPage {
      orders: SignedInOrder[];  // newest first
      nextCursor: string | null; // pass back as { cursor } for older orders
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.listOrders();
  • listRelatedProductsThe other products Amazon puts next to this one.

    Arguments

    NameTypeRequired
    asinOrUrlstringYes
    options.marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No

    Returns AmazonRelatedProducts

    interface AmazonRelatedProduct {
      asin: string;
      title: string;
      url: string;
      price: number | null;
      currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in)
      rating: number | null; // null on a "Frequently bought together" row, that rail never shows one
      ratingCount: number | null;
    }
    
    interface AmazonRelatedProducts {
      boughtTogether: AmazonRelatedProduct[]; // complements, never the current ASIN
      related: AmazonRelatedProduct[]; // "Customers who viewed this item also viewed", substitutes
      unavailableRails: string[]; // sims-consolidated-N_feature_div ids Amazon lazy-loads rather than serving inline
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/listRelatedProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.listRelatedProducts("B00006JSUA");
  • listReviewsRead what customers actually wrote about a product.

    Arguments

    NameTypeRequired
    asinOrUrlstringYes
    options.marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No

    Returns AmazonReview[]

    interface AmazonReview {
      reviewId: string;
      author: string;
      rating: number;
      title: string;
      date: string; // the site's own sentence, e.g. "Reviewed in the United States on August 9, 2026"
      variant: string | null; // e.g. "Style: Skillet, Size: 15-inch"
      verifiedPurchase: boolean;
      body: string; // paragraphs joined with a blank line, in the site's own order
      helpfulCount: number;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.listReviews("B00006JSUA");
  • listSellerOffersEvery seller offering the same product, side by side.

    Arguments

    NameTypeRequired
    asinOrUrlstringYes
    options.marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No

    Returns AmazonSellerOffersResult

    interface AmazonSellerOffer {
      condition: string; // e.g. "New", "Used - Good", "Used - Acceptable", read the values off a result, never guess one from prose
      price: number | null;
      currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in)
      shippingCost: number | null; // derived from shippingLabel ("FREE" -> 0)
      shippingLabel: string | null; // the site's own delivery-price label, e.g. "FREE" or "$3.99"
      deliveryEstimate: string | null; // e.g. "September 24 - 29"
      sellerName: string; // "Amazon.com" when Amazon itself is the seller
      sellerId: string | null; // null when sold by Amazon.com itself, getSeller's argument otherwise
      sellerRating: number | null; // 0-5
      sellerRatingCount: number | null;
    }
    
    interface AmazonSellerOffersResult {
      asin: string;
      totalOfferCount: number | null; // Amazon's own count, including offers this page did not render
      offers: AmazonSellerOffer[]; // page one only, up to 10, see the note on listSellerOffers
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/listSellerOffers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.listSellerOffers("0486404536");
  • listVariationsList every version of a product that is really the same listing.

    Arguments

    NameTypeRequired
    asinOrUrlstringYes
    options.marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No

    Returns AmazonVariation[]

    interface AmazonVariation {
      asin: string;
      dimensions: Record<string, string>; // e.g. { style_name: "Skillet", size_name: "12-inch" }, the site's own dimension names
      isCurrent: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/listVariations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.listVariations("B00006JSUA");
  • searchProductsSearch any Amazon market by keywords.

    Arguments

    NameTypeRequired
    argsSearchProductsArgsYes
    type AmazonMarket = "com" | "in" | "com.br" | "ca" | "co.uk" | "de" | "fr" | "com.mx";
    
    // `query` is the same field as `keywords`: the runtime reads either, so the type admits either.
    // `market` picks which Amazon store: "com" (default), "in", "com.br", "ca", "co.uk", "de", "fr", "com.mx".
    type SearchProductsArgs =
      | { market?: AmazonMarket; keywords: string; department?: string; sort?: string; priceMin?: number; priceMax?: number; brand?: string; page?: number }
      | { market?: AmazonMarket; query: string; department?: string; sort?: string; priceMin?: number; priceMax?: number; brand?: string; page?: number };

    Returns AmazonSearchResult

    interface AmazonProduct {
      asin: string;
      title: string;
      url: string;
      price: number | null;
      listPrice: number | null;
      currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in)
      rating: number | null;
      ratingCount: number | null;
      sponsored: boolean;
      image: string | null; // the card's thumbnail URL
    }
    
    interface AmazonSearchResult {
      products: AmazonProduct[];
      totalResultCount: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/searchProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.searchProducts({ keywords: "cast iron skillet" });
  • searchWholeFoodsSearch Whole Foods Market groceries on amazon.com by keyword and get product cards with current price and list price.

    Arguments

    NameTypeRequired
    keywordsstringYes
    sortstringNo
    pagenumberNo

    Returns AmazonSearchResult

    interface AmazonProduct {
      asin: string;
      title: string;
      url: string;
      price: number | null;
      listPrice: number | null;
      currency: string; // ISO 4217 of the prices on this row: the call's market ("USD" on amazon.com, "INR" on amazon.in)
      rating: number | null;
      ratingCount: number | null;
      sponsored: boolean;
      image: string | null; // the card's thumbnail URL
    }
    
    interface AmazonSearchResult {
      products: AmazonProduct[];
      totalResultCount: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/searchWholeFoods

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.searchWholeFoods({ keywords: "organic bananas" });
  • suggestKeywordsAsk Amazon's own search box what it would autocomplete a prefix to.

    Arguments

    NameTypeRequired
    prefixstringYes
    options.marketAmazonMarket
    Which Amazon store to ask; amazon.com when omitted.
    No

    Returns AmazonKeywordSuggestion[]

    interface AmazonKeywordSuggestion {
      value: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/suggestKeywords

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.suggestKeywords("cast iron");
Act 1
  • addToCartAdd a product to the cart and hand back a checkout link for everything the cart now holds; Bowmark never places the order and never reaches checkout…

    Arguments

    NameTypeRequired
    asinOrUrlstring | { asin: string; quantity?: number } | { product: string | { asin: string }; quantity?: number } | { url: string; quantity?: number }Yes
    opts{ connection?: string }No

    Returns AmazonCart

    interface AmazonCartItem {
      asin: string;
      title: string;
      quantity: number;
      price: number | null;
    }
    
    interface AmazonCart {
      itemCount: number;
      items: AmazonCartItem[];
      readAs?: "signed-in" | "guest"; // addToCart and getCart, which cart answered
      // The checkout handoff. Amazon never gets an order from Bowmark: give the person handoff.url, tell them
      // handoff.account.hint, and stop. status "ready_to_checkout" (urlKind "carries_items": Amazon's own
      // add-to-cart link carrying every cart row, for a guest cart; or "signed_in_cart" with
      // account.signedInAs: the account's own cart page), "needs_login" (signed in, account name unknown:
      // the cart page, after signing in to the connected account), or "unavailable" with a reason
      // (out_of_stock, region_not_served, not_sold_online). Absent on getCart for an empty cart. A status
      // you do not recognise means: show the person handoff.url and stop.
      checkout?: {
        status: string;
        url: string;
        urlKind?: string;
        account: { site: string; hint: string; signedInAs?: string };
        summary: unknown;
        warnings: string[];
        reason?: string;
        detail?: string;
      };
      warnings?: string[]; // only when the cart read answered but no handoff could be built from it
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/amazon/addToCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.amazon.addToCart("<asinOrUrl>");

Use it from code