mcp-customer
@evolve-platform/mcp-customer is a customer-facing MCP server built on
mcp-core. It exposes the tools that an AI assistant needs to help customers
browse products, manage their cart, view orders, and handle their account.
Available tools
Authentication
| Tool | Description |
|---|---|
customer_login | Log in with email and password |
customer_logout | Log out and revert to a guest session |
get_current_user | Get the currently authenticated customer |
Products
| Tool | Description |
|---|---|
get_products | Search products with filters and sorting |
get_product_detail_page | Get full product details by slug |
get_products_by_skus | Batch retrieve products by SKU |
get_categories | Browse product categories |
Cart
| Tool | Description |
|---|---|
get_cart | Get the active cart |
cart_line_items_add | Add products to the cart |
cart_line_items_remove | Remove items from the cart |
cart_line_items_update | Update item quantities |
add_discount_code | Apply a discount code |
remove_discount_code | Remove a discount code |
Shopping lists
| Tool | Description |
|---|---|
get_customer_shopping_lists | List all shopping lists (paginated) |
get_customer_shopping_list | Get a specific shopping list |
add_to_shopping_list | Add items to a shopping list |
remove_shopping_list_item | Remove items from a shopping list |
info
Shopping list tools require an authenticated session. The AI client should call
customer_login first.
Customer account
| Tool | Description |
|---|---|
get_customer | Get customer data with addresses |
create_customer_address | Create a new address |
update_customer_address | Update an existing address |
Orders
| Tool | Description |
|---|---|
order_history_query | Get the customer's order history |
Example interaction
Here is what a typical AI-assisted shopping session looks like from the tool invocation perspective:
Running locally
cd backend/services/mcp-customer
# Generate tools from GraphQL operations
pnpm codegen
# Start with HTTP transport (port 6000)
pnpm dev
# Start with stdio transport (for Claude Desktop)
pnpm dev:stdio
warning
The GraphQL gateway must be running for the MCP server to function. Start it
with pnpm dev:backend from the repository root.
Store context
The mcp-customer service supports multi-store configurations. When connecting over HTTP, clients can pass store context via headers:
| Header | Description |
|---|---|
X-StoreContext-Locale | Locale for the session (e.g., en-US) |
X-StoreContext-Currency | Currency code (e.g., EUR) |
X-StoreContext-StoreKey | Store identifier |
X-StoreContext-CustomerGroup | Customer group for pricing |