Walmart MCP server for AI agents

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

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

Connect

Just Walmart

An MCP server for Walmart 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/walmart
Every site

One MCP server for Walmart 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 23
  • browseBrandLists the products on a brand's own Walmart page (e.g. Samsung) with prices, the way a shopper browses by brand rather than by keyword.

    Arguments

    NameTypeRequired
    args{ brandId: string }Yes

    Returns walmartSearchResult[]

    interface walmartSearchResult {
      itemId: string;
      name: string;
      brand: string | null;
      url: string;
      image: string | null;
      price: number | null;
      wasPrice: number | null;
      priceRangeMin: number | null;
      conditionCode: number | null;
      inStock: boolean;
      rating: number | null;
      reviewCount: number;
      sponsored: boolean;
      totalMatches: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/browseBrand

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.browseBrand({ brandId: "10005060" });
  • browseCategoryLists products under one of the site's own department/category pages (e.g. Electronics, Grocery, Home) rather than a keyword search.

    Arguments

    NameTypeRequired
    args{ browseId: string }Yes

    Returns walmartSearchResult[]

    interface walmartSearchResult {
      itemId: string;
      name: string;
      brand: string | null;
      url: string;
      image: string | null;
      price: number | null;
      wasPrice: number | null;
      priceRangeMin: number | null;
      conditionCode: number | null;
      inStock: boolean;
      rating: number | null;
      reviewCount: number;
      sponsored: boolean;
      totalMatches: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/browseCategory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.browseCategory({ browseId: "3944" });
  • findBrandFinds a brand's Walmart page by name (e.g. "Samsung") off the site's own brand directory, returning the brandId browseBrand takes.

    Arguments

    NameTypeRequired
    args{ name: string; limit?: number }Yes

    Returns walmartBrand[]

    interface walmartBrand {
      name: string;
      brandId: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/findBrand

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.findBrand({ name: "Samsung" });
  • findStoresFinds nearby Walmart stores for a 5-digit US ZIP code.

    Arguments

    NameTypeRequired
    args{ zip: string }Yes

    Returns walmartStore[]

    interface walmartStore {
      id: string;
      displayName: string;
      name: string;
      phoneNumber: string | null;
      isSparkStore: boolean;
      address: {
        addressLineOne: string;
        addressLineTwo: string | null;
        city: string;
        state: string;
        postalCode: string;
        country: string;
      };
      geoPoint: { latitude: number; longitude: number } | null;
      distanceMiles: number | null;
      open24Hours: boolean;
      operationalHours: Array<{ day: string; start: string; end: string; closed: boolean }>;
      capabilities: Array<{ accessPointId: string; accessPointType: string }>;
      services: Array<{ name: string; displayName: string; phone: string | null }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/findStores

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.findStores({ zip: "77063" });
  • getAccountProfileReads the signed-in shopper's profile.

    Arguments

    None.

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/getAccountProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.getAccountProfile();
  • getCartReads what is in the cart, items, quantities, prices and the subtotal.

    Arguments

    None.

    Returns never

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.getCart();
  • getListReads one saved list's items and prices for a list id listLists returned.

    Arguments

    NameTypeRequired
    args{ listId: string }Yes

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/getList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.getList({ listId: "0000-test" });
  • getOrderReads one of the signed-in shopper's orders in full.

    Arguments

    NameTypeRequired
    args{ orderId: string }Yes

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/getOrder

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.getOrder({ orderId: "200012345678901" });
  • getPickupDeliverySlotsReads the available pickup or delivery time windows for a store/zip.

    Arguments

    NameTypeRequired
    args{ storeId?: string }No

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/getPickupDeliverySlots

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.getPickupDeliverySlots({ storeId: "5117" });
  • getProductReads one product's full page.

    Arguments

    NameTypeRequired
    args{ itemId: string }Yes

    Returns walmartProduct

    interface walmartProduct {
      itemId: string;
      name: string;
      brand: string | null;
      url: string;
      price: number | null;
      wasPrice: number | 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;
      images: string[];
      description: string | null;
      specText: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.getProduct({ itemId: "5129928603" });
  • getSellerReads a Marketplace seller's page.

    Arguments

    NameTypeRequired
    args{ sellerId: string }Yes

    Returns walmartSeller

    interface walmartSeller {
      sellerId: string;
      name: string;
      rating: number | null;
      reviewCount: number;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.getSeller({ sellerId: "3652" });
  • getStoreReads one store's page, address, phone, opening hours, and which departments and services (pharmacy, auto care, pickup) it has, for a store id…

    Arguments

    NameTypeRequired
    args{ storeId: string }Yes

    Returns walmartStore

    interface walmartStore {
      id: string;
      displayName: string;
      name: string;
      phoneNumber: string | null;
      isSparkStore: boolean;
      address: {
        addressLineOne: string;
        addressLineTwo: string | null;
        city: string;
        state: string;
        postalCode: string;
        country: string;
      };
      geoPoint: { latitude: number; longitude: number } | null;
      distanceMiles: number | null;
      open24Hours: boolean;
      operationalHours: Array<{ day: string; start: string; end: string; closed: boolean }>;
      capabilities: Array<{ accessPointId: string; accessPointType: string }>;
      services: Array<{ name: string; displayName: string; phone: string | null }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/getStore

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.getStore({ storeId: "5117" });
  • getWeeklyAdReads the Walmart weekly ad live at a 5-digit US ZIP.

    Arguments

    NameTypeRequired
    args{ zip: string }Yes

    Returns walmartWeeklyAd

    interface walmartWeeklyAdItem {
      id: number;
      name: string;
      brand: string | null;
      priceText: string | null;
      discountPercent: number | null;
      validFrom: string | null;
      validTo: string | null;
      imageUrl: string | null;
    }
    
    interface walmartWeeklyAd {
      zip: string;
      flyerId: number | null;
      validFrom: string | null;
      validTo: string | null;
      items: walmartWeeklyAdItem[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/getWeeklyAd

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.getWeeklyAd({ zip: "60614" });
  • listAddressesLists the delivery addresses saved on the signed-in account.

    Arguments

    None.

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/listAddresses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.listAddresses();
  • listDealsLists what is on sale right now.

    Arguments

    None.

    Returns walmartSearchResult[]

    interface walmartSearchResult {
      itemId: string;
      name: string;
      brand: string | null;
      url: string;
      image: string | null;
      price: number | null;
      wasPrice: number | null;
      priceRangeMin: number | null;
      conditionCode: number | null;
      inStock: boolean;
      rating: number | null;
      reviewCount: number;
      sponsored: boolean;
      totalMatches: number;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.listDeals();
  • listDepartmentsLists Walmart's departments and their sub-categories with the browse id each one opens.

    Arguments

    None.

    Returns walmartDepartment[]

    interface walmartDepartmentLink {
      title: string;
      url: string;
      browseId: string | null;
    }
    
    interface walmartDepartment extends walmartDepartmentLink {
      subcategories: walmartDepartmentLink[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/listDepartments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.listDepartments();
  • listListsLists the signed-in shopper's saved lists.

    Arguments

    None.

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/listLists

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.listLists();
  • listOrdersLists the signed-in shopper's orders.

    Arguments

    None.

    Returns never

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.listOrders();
  • listPurchasedItemsLists the items the signed-in shopper has bought before.

    Arguments

    None.

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/listPurchasedItems

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.listPurchasedItems();
  • listReviewsReads a product's customer reviews.

    Arguments

    NameTypeRequired
    args{ itemId: string }Yes

    Returns walmartProductReviews

    interface walmartReview {
      reviewId: string;
      rating: number;
      title: string | null;
      text: string | null;
      date: string | null;
      verifiedPurchase: boolean;
      authorName: string | null;
      helpfulVotes: number;
    }
    
    interface walmartReviewSummary {
      averageRating: number | null;
      totalReviewCount: number;
      ratingCounts: { 1: number; 2: number; 3: number; 4: number; 5: number };
      recommendedPercentage: number | null;
    }
    
    interface walmartProductReviews {
      summary: walmartReviewSummary;
      reviews: walmartReview[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.listReviews({ itemId: "5129928603" });
  • listSellerOffersLists every seller offering one item.

    Arguments

    NameTypeRequired
    args{ itemId: string }Yes

    Returns walmartSellerOffer[]

    interface walmartSellerOffer {
      sellerId: string | null;
      catalogSellerId: string | null;
      sellerName: string;
      price: number | null;
      shipping: string | null;
      condition: 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/walmart/listSellerOffers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.listSellerOffers({ itemId: "5129928603" });
  • suggestSearchesAutocomplete for the search bar.

    Arguments

    NameTypeRequired
    args{ term: string; limit?: number }Yes

    Returns walmartSuggestion[]

    interface walmartSuggestion {
      displayName: string;
      query: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/suggestSearches

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.suggestSearches({ term: "lapt" });
Act 9
  • addAddressSaves a new US delivery address on the signed-in account.

    Arguments

    NameTypeRequired
    args{ firstName: string; lastName: string; addressLineOne: string; addressLineTwo?: string; city: string; state: string; postalCode: string; phone?: string }Yes

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/addAddress

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.addAddress({});
  • addToCartPuts an item in the cart in the quantity asked for and reports what the cart then holds.

    Arguments

    NameTypeRequired
    args{ itemId: string; quantity?: number }Yes

    Returns never

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.addToCart({});
  • addToListAdds an item to one of the shopper's saved lists.

    Arguments

    NameTypeRequired
    args{ listId: string; itemId: string }Yes

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/addToList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.addToList({});
  • createListCreates a new saved list with a name.

    Arguments

    NameTypeRequired
    args{ name: string }Yes

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/createList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.createList({});
  • removeFromCartTakes an item out of the cart.

    Arguments

    NameTypeRequired
    args{ itemId: string }Yes

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/removeFromCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.removeFromCart({});
  • removeFromListRemoves an item from one of the shopper's saved lists.

    Arguments

    NameTypeRequired
    args{ listId: string; itemId: string }Yes

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/removeFromList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.removeFromList({});
  • setPreferredStoreSets the shopper's store, so stock, prices and pickup slots answer for that store.

    Arguments

    NameTypeRequired
    args{ storeId: string }Yes

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/setPreferredStore

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.setPreferredStore({});
  • updateCartItemChanges the quantity of an item already in the cart.

    Arguments

    NameTypeRequired
    args{ itemId: string; quantity: number }Yes

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/updateCartItem

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.updateCartItem({});
  • updateProfileEdits the signed-in shopper's profile name.

    Arguments

    NameTypeRequired
    args{ firstName?: string; lastName?: string }Yes

    Returns never

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/walmart/updateProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.walmart.updateProfile({});

Use it from code