Lets the customer search for products by name, keyword, or category. Returns matching products with prices, images, and stock availability.
| Platform | Status | Notes |
|---|
| iOS | Yes | — |
| Android | Yes | — |
Description
Search for products in the Pick n Pay catalog
Parameters
| Name | Type | Required | Default | Description |
|---|
query | string | Yes | — | Search query text |
limit | integer | No | 20 | Maximum number of results to return |
sort | string | No | — | Sort order for results (values: relevance, price-asc, price-desc, name-asc, name-desc) |
category | string | No | — | Category filter to narrow results |
Response
| Field | Type | Description |
|---|
total_results | integer | Total number of matching products |
products | array | List of matching products |
code | string | Unique product code |
name | string | Product display name |
price | string | Formatted price (e.g. "R29.99") |
image_url | string | Product image URL |
in_stock | boolean | Whether the product is currently available |
unit | string | Unit of measure (e.g. "per kg", "each") |
Error Codes
| Code | Description |
|---|
SEARCH_FAILED | Product search service returned an error |
INVALID_PARAMS | Missing or invalid search parameters |
Source Files
- iOS:
one-app-ios-chat/Chat/Sources/Chat/MCP/EcommerceMCPServer.swift
- Android:
chat-pnp-android/mcp-ecommerce/src/main/java/pnp/app/mcp/ecommerce/tools/EcommerceMCPTools.kt