Samsung MCP server for AI agents

Let Claude, ChatGPT or your own agent read Samsung: 15 typed functions through one MCP server. No Samsung API key needed.

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

Connect

Just Samsung

An MCP server for Samsung 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/samsung
Every site

One MCP server for Samsung 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 15
  • checkWarrantyStatusA signed-in shopper's registered device's warranty status.

    Arguments

    NameTypeRequired
    serialOrModelstringYes

    Returns CheckWarrantyStatusResponse

    interface WarrantyStatus {
      serialNumber?: string;
      modelNumber?: string;
      warrantyStartDate?: string;
      warrantyEndDate?: string;
      warrantyStatus: "active" | "expired" | "unknown";
      daysRemaining?: number;
    }
    
    interface CheckWarrantyStatusResponse {
      warranty: WarrantyStatus;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/samsung/checkWarrantyStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.checkWarrantyStatus({ serialOrModel: "TEST" });
  • compareProductsSamsung's own side-by-side spec comparison for two or more models.

    Arguments

    NameTypeRequired
    productsstring[]
    One or more product URLs or SKUs to compare.
    Yes

    Returns CompareProductsResponse

    interface ComparedProduct {
      name: string;
      sku: string;
      price: string | null;
      image: string | null;
    }
    
    interface ComparisonSpec {
      name: string;
      values: Record<string, string>;
    }
    
    interface CompareProductsResponse {
      products: ComparedProduct[];
      specs: ComparisonSpec[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/samsung/compareProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.compareProducts({ products: [] });
  • findStoreSamsung's own retail network.

    Arguments

    NameTypeRequired
    zipstring
    5-digit US zip, EITHER this OR city+state, never both.
    No
    citystringNo
    statestring
    Two-letter abbreviation, required alongside city.
    No

    Returns FindStoreResponse

    interface SamsungStoreLocation {
      name: string;
      city: string;
      state: string;
      address: string;
      phone: string;
      hours: string;
      url: string;
      distanceMiles: number; // NaN when this store's own zip could not be geocoded
    }
    
    interface FindStoreResponse {
      stores: SamsungStoreLocation[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/samsung/findStore

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.findStore({ zip: "10001" });
  • getOrderStatusWhere one specific order stands.

    Arguments

    NameTypeRequired
    orderIdstring
    Read off a row from listOrders.
    Yes

    Returns GetOrderStatusResponse

    interface SamsungOrderStatus {
      [key: string]: unknown; // Samsung's own per-order-detail shape, unmeasured against a real signed-in account; kept as the site's own JSON rather than guessed at
    }
    
    interface GetOrderStatusResponse {
      order: SamsungOrderStatus;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.getOrderStatus({ orderId: "US0000000000" });
  • getProductRead one exact model's page the way a shopper reads it: name, price, star rating and review count, in-stock state, every storage/color/carrier…

    Arguments

    NameTypeRequired
    productstring
    URL or SKU.
    Yes

    Returns GetProductResponse

    interface ProductVariant {
      name: string;
      sku: string;
      price: string | null;
      availability: string | null;  // the site's own labels, read the values off a result, never guess one from prose
    }
    
    interface SamsungProductDetail {
      name: string;
      price: string | null;
      rating: number | null;
      reviewCount: number | null;
      availability: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      image: string | null;
      variants: ProductVariant[];
      specs: Record<string, string>;
      category: string | null;
      url: string;
    }
    
    interface GetProductResponse {
      product: SamsungProductDetail;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.getProduct({ product: "<product>" });
  • getRewardsBalanceA signed-in shopper's Samsung Rewards points balance and available redemptions, off /us/rewards/ and /us/mypage/rewards/.

    Arguments

    None.

    Returns GetRewardsBalanceResponse

    interface GetRewardsBalanceResponse {
      rewards: {
        balance: number;
        tier: string;  // the site's own labels, read the values off a result, never guess one from prose
        tierName?: string;
        earnedTowardNextTier?: number;
        nextTierThreshold?: number;
        redemptionOptions?: Array<{
          name: string;
          pointsRequired: number;
          description?: string;
        }>;
        [key: string]: unknown;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/samsung/getRewardsBalance

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.getRewardsBalance();
  • getTradeInQuoteSamsung's own trade-in estimate for a device someone already owns.

    Arguments

    NameTypeRequired
    devicestring
    E.g. "galaxy s24 ultra", resolved against the trade-in program's own device search.
    Yes

    Returns GetTradeInQuoteResponse

    interface GetTradeInQuoteResponse {
      device: string;
      matchedDeviceName: string;
      estimatedCredit: number | null; // the program's own "Get Up To $X" figure, an estimate, not a binding offer
      currency: "USD";
      isTradeEligible: boolean;
      otherMatches: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/samsung/getTradeInQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.getTradeInQuote({ device: "galaxy s24 ultra" });
  • listCarrierOffersSamsung's own "save up to $X with eligible trade-in on this carrier" promotions.

    Arguments

    None.

    Returns ListCarrierOffersResponse

    interface SamsungCarrierOffer {
      carrier: string;
      deviceName: string;
      offerText: string;
      url: string;
      image: string | null;
    }
    
    interface ListCarrierOffersResponse {
      offers: SamsungCarrierOffer[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/samsung/listCarrierOffers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.listCarrierOffers({});
  • listCategoriesThe site's own product taxonomy.

    Arguments

    None.

    Returns ListCategoriesResponse

    interface SamsungCategory {
      name: string;
      slug: string;
    }
    
    interface ListCategoriesResponse {
      categories: SamsungCategory[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.listCategories({});
  • listCategoryProductsBrowse a whole product family with no keyword at all.

    Arguments

    NameTypeRequired
    categorystringYes

    Returns ListCategoryProductsResponse

    interface SamsungCategoryProduct {
      name: string;
      price: string | null;
      availability: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      rating: number | null;
      reviewCount: number | null;
      url: string;
    }
    
    interface ListCategoryProductsResponse {
      products: SamsungCategoryProduct[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.listCategoryProducts({ category: "smartphones" });
  • listDealsWhat is discounted right now across the whole site.

    Arguments

    None.

    Returns ListDealsResponse

    interface SamsungDeal {
      name: string;
      originalPrice: string | null;
      salePrice: string | null;
      discountPercent: number | null;
      url: string;
      image: string | null;
    }
    
    interface ListDealsResponse {
      deals: SamsungDeal[];
      warnings: string[]; // names a deal whose real sale price could not be read; empty on a clean run
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.listDeals({});
  • listMyProductsThe devices a signed-in shopper has registered to their Samsung account.

    Arguments

    None.

    Returns ListMyProductsResponse

    interface SamsungProduct {
      [key: string]: unknown; // Samsung's own registered-device shape, unmeasured against a real signed-in account; kept as the site's own JSON rather than guessed at
    }
    
    interface ListMyProductsResponse {
      products: SamsungProduct[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/samsung/listMyProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.listMyProducts();
  • listOrdersThe signed-in shopper's own Samsung.com order history.

    Arguments

    None.

    Returns ListOrdersResponse

    interface SamsungOrder {
      [key: string]: unknown; // Samsung's own per-order shape, unmeasured against a real signed-in account; kept as the site's own JSON rather than guessed at
    }
    
    interface ListOrdersResponse {
      orders: SamsungOrder[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.listOrders();
  • listSupportArticlesSamsung's own how-to and troubleshooting articles for a product.

    Arguments

    NameTypeRequired
    querystring
    Free text, e.g. "galaxy s25 ultra battery" or a bare model name.
    Yes

    Returns ListSupportArticlesResponse

    interface SupportArticle {
      title: string;
      url: string | null; // null for an FAQ with no landing page, read snippet instead
      type: "answer" | "troubleshooting_guide" | "faq"; // Yext's own three support content types
      snippet: string | null;
    }
    
    interface ListSupportArticlesResponse {
      articles: SupportArticle[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/samsung/listSupportArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsung.listSupportArticles({ query: "galaxy s25 ultra battery" });

Use it from code