About kroger
kroger is an MCP server for Kroger and its affiliated store brands. It lets AI agents search groceries, manage carts, use coupons and fuel rewards, and arrange delivery or pickup orders.
Key features
- 01Search products and view nutrition details
- 02Manage cart items and totals
- 03Browse and clip digital coupons
- 04Check fuel points and rewards
- 05Find delivery and pickup slots
- 06Review orders and reorder
Use cases
- 01Find products by name, brand, or category
- 02Build a grocery cart and adjust quantities
- 03Apply digital coupons and check fuel rewards
- 04Schedule fulfillment or repeat a past order
MCP support
The server exposes Kroger shopping and account operations as tools for MCP clients, including product search, cart management, fulfillment, and ordering.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
15Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| string | Yes | Kroger account email | |
| password | string | Yes | Kroger account password |
Details
From the project README@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: "[email protected]",
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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.