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.

Functions
8
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Sam's Club

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/samsclub
Every site

One 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/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

Open a function to see its arguments, what it returns and how to call it.

Read 8
  • browseCategoryReads the current live grid (~50 rows) for one of samsclub.com's own department/category pages.

    Arguments

    NameTypeRequired
    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/browseCategory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsclub.browseCategory("1040209");
  • checkStockAnswers whether one item is in stock right now, and at what price, at a SPECIFIC club.

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    location{ clubId: string } | { zip: string }Yes

    Returns SamsclubStock

    interface 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/checkStock

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsclub.checkStock("13593313344", { zip: "75231" });
  • findClubsFinds nearby Sam's Club warehouse locations for a 5-digit US zip.

    Arguments

    NameTypeRequired
    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/findClubs

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsclub.findClubs("75231");
  • getFuelPricesReads the current fuel-center gas price at a specific club.

    Arguments

    NameTypeRequired
    clubIdstringYes

    Returns SamsclubFuelPrices

    interface 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/getFuelPrices

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsclub.getFuelPrices("6372");
  • getInstantSavingsReads one page (47 rows) of samsclub.com's live Instant Savings promotional catalog.

    Arguments

    NameTypeRequired
    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/getInstantSavings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getMembershipPlans

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsclub.getMembershipPlans();
  • getProductReads one product's full page.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns SamsclubProduct

    interface 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/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.samsclub.getProduct("13593313344");

Use it from code