Sam's Club MCP server for AI agents
Let Claude, ChatGPT or your own agent read Sam's Club: 8 typed functions through one MCP server. No Sam's Club API key needed.
- Site
- samsclub.com
- Functions
- 8
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Sam's Club 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/samsclubOne MCP server for Sam's Club 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
Open a function to see its arguments, what it returns and how to call it.
browseCategoryReads the current live grid (~50 rows) for one of samsclub.com's own department/category pages.Arguments
Name Type Required categoryIdstringYes Returns
SamsclubCategoryItem[]interface SamsclubCategoryItem { id: string; name: string; brand: string | null; url: string; image: string | null; price: string | null; wasPrice: 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 }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/samsclub/browseCategoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsclub.browseCategory("1040209");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsclub.browseCategory("1040209"))curl -X POST https://api.bowmark.ai/v1/sites/samsclub/browseCategory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"categoryId":"1040209"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsclub.browseCategory("1040209");checkStockAnswers whether one item is in stock right now, and at what price, at a SPECIFIC club.Arguments
Name Type Required idOrUrlstringYes location{ clubId: string } | { zip: string }Yes Returns
SamsclubStockinterface SamsclubStock { itemId: string; itemName: string; // The club that actually ANSWERED. Read this rather than what you asked for: // geo targeting is nearest-available, not guaranteed-exact. Null on the rare // item this club does not offer for pickup at all, an honest gap and not a // parse failure, and clubId alone still identifies the club. clubId: string | null; clubName: string | null; inStock: boolean; availabilityStatus: string | null; // the site's own string, "In stock" / "Out of stock" // The club's own PICKUP price, falling back to the page's general price on an // item that carries no separate pickup-channel price. price: string | null; quantityAvailable: number | null; // null where the site publishes no unit count }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/samsclub/checkStockCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsclub.checkStock("13593313344", { zip: "75231" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsclub.checkStock("13593313344", {"zip": "75231"}))curl -X POST https://api.bowmark.ai/v1/sites/samsclub/checkStock \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"13593313344","location":{"zip":"75231"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsclub.checkStock("13593313344", { zip: "75231" });findClubsFinds nearby Sam's Club warehouse locations for a 5-digit US zip.Arguments
Name Type Required zipstringYes Returns
SamsclubClub[]interface SamsclubClubHours { day: string; start: string | null; end: string | null; closed: boolean; } interface SamsclubClub { id: string; name: string; distanceMiles: number | null; phoneNumber: string | null; address: { addressLine1: string | null; addressLine2: string | null; city: string; state: string; postalCode: string; country: string }; open24Hours: boolean; hours: SamsclubClubHours[]; services: string[]; // the SITE'S OWN labels, verbatim: "Sam’s Fuel Station" (NOT "Fuel Center"), // "Pharmacy", "Optical Center", "Auto & Tires", "Sam’s Cafe", "Bakery", "Deli", "Liquor", // "Tobacco", "Photo Center", "Hearing Aid Center", "Fresh Flowers", "Wireless Mobile", // "Grocery Pickup and Delivery". Note the CURLY apostrophe (U+2019), a filter written // with a straight one matches nothing. Read the values off a result, never guess from prose. geoPoint: { latitude: number; longitude: number } | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/samsclub/findClubsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsclub.findClubs("75231");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsclub.findClubs("75231"))curl -X POST https://api.bowmark.ai/v1/sites/samsclub/findClubs \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"zip":"75231"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsclub.findClubs("75231");getFuelPricesReads the current fuel-center gas price at a specific club.Arguments
Name Type Required clubIdstringYes Returns
SamsclubFuelPricesinterface SamsclubFuelPrice { grade: string; // the site's own labels: "Unleaded", "Premium", "Diesel" where the club sells it pricePerGallon: number; } interface SamsclubFuelPrices { clubId: string; clubName: string; address: { city: string; state: string; postalCode: string }; prices: SamsclubFuelPrice[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/samsclub/getFuelPricesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsclub.getFuelPrices("6372");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsclub.getFuelPrices("6372"))curl -X POST https://api.bowmark.ai/v1/sites/samsclub/getFuelPrices \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"clubId":"6372"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsclub.getFuelPrices("6372");getInstantSavingsReads one page (47 rows) of samsclub.com's live Instant Savings promotional catalog.Arguments
Name Type Required pagenumberNo Returns
SamsclubInstantSavingsItem[]interface SamsclubInstantSavingsItem { id: string; name: string; brand: string | null; url: string; image: string | null; wasPrice: string | null; nowPrice: string | null; savingsLabel: string | null; savingsAmount: number | null; expiresLabel: string | null; limitLabel: string | null; availability: string | null; // the site's own labels, read the values off a result, never guess one from prose }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/samsclub/getInstantSavingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsclub.getInstantSavings();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsclub.getInstantSavings())curl -X POST https://api.bowmark.ai/v1/sites/samsclub/getInstantSavings \ -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.samsclub.getInstantSavings();getMembershipPlansReads the site's own published membership tiers (Club, Plus).Arguments
None.
Returns
SamsclubMembershipPlan[]interface SamsclubMembershipBenefit { name: string; description: string | null; included: boolean; extraDetails: string | null; } interface SamsclubMembershipPlan { name: string; price: string; regularPrice: string | null; description: string; benefits: SamsclubMembershipBenefit[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/samsclub/getMembershipPlansCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsclub.getMembershipPlans();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsclub.getMembershipPlans())curl -X POST https://api.bowmark.ai/v1/sites/samsclub/getMembershipPlans \ -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.samsclub.getMembershipPlans();getProductReads one product's full page.Arguments
Name Type Required idOrUrlstringYes Returns
SamsclubProductinterface SamsclubProduct { id: string; name: string; brand: string | null; url: string; category: string[]; price: string | null; wasPrice: string | null; nonMemberPrice: 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 description: string | null; images: string[]; thumbnailUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/samsclub/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsclub.getProduct("13593313344");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsclub.getProduct("13593313344"))curl -X POST https://api.bowmark.ai/v1/sites/samsclub/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"13593313344"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsclub.getProduct("13593313344");searchSearches samsclub.com's catalog for a keyword and returns matching products.Arguments
Name Type Required querystringYes Returns
SamsclubCategoryItem[]interface SamsclubCategoryItem { id: string; name: string; brand: string | null; url: string; image: string | null; price: string | null; wasPrice: 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 }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/samsclub/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.samsclub.search("paper towels");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.samsclub.search("paper towels"))curl -X POST https://api.bowmark.ai/v1/sites/samsclub/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"paper towels"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.samsclub.search("paper towels");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/samsclub/<function> - OpenAPI
/v1/sites/samsclub/openapi.json