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.
- Site
- samsung.com
- Functions
- 15
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/samsungOne MCP server for Samsung and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth 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.
checkWarrantyStatusA signed-in shopper's registered device's warranty status.Arguments
Name Type Required serialOrModelstringYes Returns
CheckWarrantyStatusResponseinterface 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/checkWarrantyStatusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.checkWarrantyStatus({ serialOrModel: "TEST" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.checkWarrantyStatus({"serialOrModel": "TEST"}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/checkWarrantyStatus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"serialOrModel":"TEST"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.checkWarrantyStatus({ serialOrModel: "TEST" });compareProductsSamsung's own side-by-side spec comparison for two or more models.Arguments
Name Type Required productsstring[]One or more product URLs or SKUs to compare.Yes Returns
CompareProductsResponseinterface 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/compareProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.compareProducts({ products: [] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.compareProducts({"products": []}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/compareProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"products":[]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.compareProducts({ products: [] });findStoreSamsung's own retail network.Arguments
Name Type Required zipstring5-digit US zip, EITHER this OR city+state, never both.No citystringNo statestringTwo-letter abbreviation, required alongside city.No Returns
FindStoreResponseinterface 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/findStoreCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.findStore({ zip: "10001" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.findStore({"zip": "10001"}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/findStore \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"zip":"10001"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.findStore({ zip: "10001" });getOrderStatusWhere one specific order stands.Arguments
Name Type Required orderIdstringRead off a row from listOrders.Yes Returns
GetOrderStatusResponseinterface 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/getOrderStatusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.getOrderStatus({ orderId: "US0000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.getOrderStatus({"orderId": "US0000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/getOrderStatus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"orderId":"US0000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required productstringURL or SKU.Yes Returns
GetProductResponseinterface 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/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.getProduct({ product: "<product>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.getProduct({"product": "<product>"}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"product":"<product>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
GetRewardsBalanceResponseinterface 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/getRewardsBalanceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.getRewardsBalance();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.getRewardsBalance())curl -X POST https://api.bowmark.ai/v1/sites/samsung/getRewardsBalance \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.getRewardsBalance();getTradeInQuoteSamsung's own trade-in estimate for a device someone already owns.Arguments
Name Type Required devicestringE.g. "galaxy s24 ultra", resolved against the trade-in program's own device search.Yes Returns
GetTradeInQuoteResponseinterface 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/getTradeInQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.getTradeInQuote({ device: "galaxy s24 ultra" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.getTradeInQuote({"device": "galaxy s24 ultra"}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/getTradeInQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"device":"galaxy s24 ultra"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
ListCarrierOffersResponseinterface 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/listCarrierOffersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.listCarrierOffers({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.listCarrierOffers({}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/listCarrierOffers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.listCarrierOffers({});listCategoriesThe site's own product taxonomy.Arguments
None.
Returns
ListCategoriesResponseinterface SamsungCategory { name: string; slug: string; } interface ListCategoriesResponse { categories: SamsungCategory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/samsung/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.listCategories({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.listCategories({}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.listCategories({});listCategoryProductsBrowse a whole product family with no keyword at all.Arguments
Name Type Required categorystringYes Returns
ListCategoryProductsResponseinterface 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/listCategoryProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.listCategoryProducts({ category: "smartphones" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.listCategoryProducts({"category": "smartphones"}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/listCategoryProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"category":"smartphones"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.listCategoryProducts({ category: "smartphones" });listDealsWhat is discounted right now across the whole site.Arguments
None.
Returns
ListDealsResponseinterface 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/listDealsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.listDeals({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.listDeals({}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/listDeals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.listDeals({});listMyProductsThe devices a signed-in shopper has registered to their Samsung account.Arguments
None.
Returns
ListMyProductsResponseinterface 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/listMyProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.listMyProducts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.listMyProducts())curl -X POST https://api.bowmark.ai/v1/sites/samsung/listMyProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.listMyProducts();listOrdersThe signed-in shopper's own Samsung.com order history.Arguments
None.
Returns
ListOrdersResponseinterface 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/listOrdersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.listOrders();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.listOrders())curl -X POST https://api.bowmark.ai/v1/sites/samsung/listOrders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.listOrders();listSupportArticlesSamsung's own how-to and troubleshooting articles for a product.Arguments
Name Type Required querystringFree text, e.g. "galaxy s25 ultra battery" or a bare model name.Yes Returns
ListSupportArticlesResponseinterface 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/listSupportArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.listSupportArticles({ query: "galaxy s25 ultra battery" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.listSupportArticles({"query": "galaxy s25 ultra battery"}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/listSupportArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"galaxy s25 ultra battery"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.listSupportArticles({ query: "galaxy s25 ultra battery" });searchRuns Samsung's own AI-powered site search (the box that redirects to /us/aisearch/) and returns what it shows: each result's name, price…Arguments
Name Type Required querystringYes Returns
SearchResponseinterface SamsungSearchResult { 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; url: string; } interface SearchResponse { results: SamsungSearchResult[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/samsung/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsung.search({ query: "galaxy watch" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsung.search({"query": "galaxy watch"}))curl -X POST https://api.bowmark.ai/v1/sites/samsung/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"query":"galaxy watch"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsung.search({ query: "galaxy watch" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/samsung/<function> - OpenAPI
/v1/sites/samsung/openapi.json