SAP Commerce MCP Server

This Model Context Protocol (MCP) server integrates with SAP Commerce Cloud's OCC APIs to enable natural language interactions with product data through Claude.

Features

- Product Search: Search through products using natural language queries
- Advanced Search: Filter products by category, price range, and more
- Product Details: Get detailed information about specific products
- Stock Availability: Check product stock levels and availability
- Categories: Browse and search products by categories
- Promotions: Get information about active promotions
- Reviews: Access product reviews and ratings
- Product Suggestions: Get personalized product recommendations
- Cart Management: Full shopping cart operations support
- Health Monitoring: Real-time service health tracking
- Performance Analytics: Historical performance analysis and insights

Tools Available

1. search-products: Basic product search with pagination support
- Parameters:
- query: Search query string
- currentPage: (Optional) Page number
- pageSize: (Optional) Results per page

2. search-products-advanced: Advanced product search with filters
- Parameters:
- query: (Optional) Search query string
- categoryCode: (Optional) Category code filter
- minPrice: (Optional) Minimum price filter
- maxPrice: (Optional) Maximum price filter
- sort: (Optional) Sort order
- currentPage: (Optional) Page number
- pageSize: (Optional) Results per page

3. get-product-details: Get detailed product information
- Parameters:
- productCode: Product code/SKU

4. check-product-availability: Check product stock levels
- Parameters:
- productCode: Product code/SKU
- location: (Optional) Warehouse/store location code

5. get-categories: Browse product categories
- Parameters:
- categoryId: (Optional) Specific category ID

6. get-products-by-category: Get products in a category
- Parameters:
- categoryId: Category ID
- currentPage: (Optional) Page number
- pageSize: (Optional) Results per page
- sort: (Optional) Sort order

7. get-promotions: Get promotion information
- Parameters:
- promotionId: (Optional) Specific promotion ID

8. get-product-reviews: Get product reviews
- Parameters:
- productCode: Product code/SKU

9. get-product-suggestions: Get product recommendations
- Parameters:
- productCode: Reference product code/SKU
- maxResults: (Optional) Maximum number of suggestions

10. create-cart: Create a new shopping cart
- Parameters: None

11. get-cart: Get cart details
- Parameters:
- cartId: Cart ID to retrieve

12. add-to-cart: Add a product to cart
- Parameters:
- cartId: Cart ID
- productCode: Product code/SKU
- quantity: (Optional) Quantity to add (default: 1)

13. update-cart-entry: Update product quantity in cart
- Parameters:
- cartId: Cart ID
- entryNumber: Entry number in cart
- quantity: New quantity

14. remove-from-cart: Remove a product from cart
- Parameters:
- cartId: Cart ID
- entryNumber: Entry number to remove

15. get-order-status: Check order status
- Parameters:
- orderId: Order ID

16. get-order-history: View order history
- Parameters:
- userId: User ID

17. check-service-health: Get current service health status
- Parameters: None

18. analyze-performance: Get historical performance insights
- Parameters: None

Configuration

The server can be configured using environment variables:

```env