kroger

@striderlabs/mcp-kroger

MCP server connector for Kroger - America's largest supermarket chain. Enables AI agents to search products, manage shopping carts, clip digital coupons, check fuel points, schedule delivery/pickup, and place grocery orders.

Installation

npm install @striderlabs/mcp-kroger

Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "kroger": {
      "command": "npx",
      "args": ["@striderlabs/mcp-kroger"]
    }
  }
}

Available Tools

Tool	Description
kroger_login	Authenticate with Kroger account
kroger_set_store	Set preferred Kroger store by zip code or ID
kroger_search_products	Search for products by name, brand, or category
kroger_get_product_details	Get detailed product info including nutrition
kroger_add_to_cart	Add products to shopping cart
kroger_view_cart	View cart contents and totals
kroger_update_cart_item	Update quantity or remove items
kroger_get_coupons	Get available digital coupons
kroger_clip_coupon	Clip coupons to Kroger Plus card
kroger_get_fuel_points	Check fuel points balance and rewards
kroger_get_delivery_slots	Get delivery time slots
kroger_get_pickup_slots	Get pickup time slots
kroger_checkout	Proceed to checkout
kroger_get_order_history	View recent orders
kroger_reorder	Reorder from a previous order

Example Usage

// Log in to Kroger
await client.call("kroger_login", {
  email: "user@example.com",
  password: "password123"
});

// Set store by zip code
await client.call("kroger_set_store", {
  zipCode: "45202"
});

// Search for products
const results = await client.call("kroger_search_products", {
  query: "organic milk",
  onSale: true
});

// Add to cart
await client.call("kroger_add_to_cart", {
  productId: "0001111045963",
  quantity: 2
});

// Get available coupons
const coupons = await client.call("kroger_get_coupons", {
  personalizedOnly: true
});

// Clip a coupon
await client.call("kroger_clip_coupon", {
  couponId: "123456"
});

// Check fuel points
const fuelPoints = await client.call("kroger_get_fuel_points", {});

// Get pickup slots
const slots = await client.call("kroger_get_pickup_slots", {});

// Checkout
await client.call("kroger_checkout", {
  fulfillmentType: "pickup",
  slotId: "slot_123"
});

Kroger Family of Stores

This connector works with all Kroger-owned banners:

• Kroger
• Ralphs
• Fred Meyer
• King Soopers
• Fry's
• Smith's
• QFC
• Harris Teeter
• And more...

Features

• Product Search: Search by name, brand, category, or sale items
• Digital Coupons: Browse and clip coupons automatically
• Fuel Points: Track fuel rewards balance
• Flexible Fulfillment: Support for both delivery and pickup
• Order History: View past orders and easy reordering
• Cart Management: Full cart manipulation capabilities

Requirements

• Node.js 18+
• Kroger account with Kroger Plus card

License

MIT

Links

• Strider Labs
• GitHub Repository