io.github.markswendsen-code/kroger
MCP server for Kroger - search products, manage cart, place grocery orders
Open source Open in the app JSON README (API)
About
MCP server for Kroger - search products, manage cart, place grocery orders
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- markswendsen-code
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.0
- Last push
- 2026-03-16T04:07:56Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-29 04:00:29
- Updated
- 2026-08-29 04:00:29
- Origin id
io.github.markswendsen-code/kroger
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
```bash
npm install @striderlabs/mcp-kroger
```
## Configuration
Add to your MCP client configuration:
```json
{
"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
```typescript
// 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](https://striderlabs.ai)
- [GitHub Repository](https://github.com/markswendsen-code/mcp-kroger)