Overview

The Wunderkind Profiles MCP server connects your AI assistant or chatbot to Wunderkind shopper intelligence via the Model Context Protocol (MCP). Your assistant can retrieve personalized product recommendations for a shopper — refreshed regularly on a daily recompute cycle — and weave them into the conversation, no custom API integration required.

The server works with any MCP-compatible client, such as Claude, Claude Code, Cursor, or Visual Studio Code (GitHub Copilot). See Profile MCP Setup Guide to get started.

What you can do

Personalize shopper conversations
Retrieve product recommendations for a shopper, ranked most relevant first
Ground your assistant's suggestions in each shopper's Wunderkind profile, refreshed on a daily recompute cycle
Fall back gracefully for shoppers the system doesn't know yet — an unknown shopper is a normal result, not an error

Example prompts

Here are a few prompts to get you started:

"What products should I suggest to this shopper?"
"Recommend something for the current shopper and explain why each pick fits."
"Get recommendations for current shopper and, if there are none, suggest our bestsellers instead."

Security and privacy

No personal data: responses contain only product IDs — no personal or profile data is ever returned.
Read-only: the server exposes no write operations. Nothing in your Wunderkind configuration is created, modified, or deleted through it.
Stateless: the server stores no conversation, shopper, or session data; every request is passed through to Wunderkind's profile systems.

Limitations

Recommendations are refreshed on a daily recompute cycle — they are not recalculated per request in real time.
The shopper's device_id must be supplied by your integration. The server does not resolve shoppers by email or other identifiers.
Responses contain product IDs only — join them against your own catalog for titles, prices, and images.

Troubleshooting

Issue	Solution
Tools not showing up	Restart your MCP client after adding the config, and verify the JSON syntax.
Connection errors	Confirm the server URL includes the /mcp path and matches the endpoint provided by your Wunderkind representative.
Empty recommendations for every shopper	Verify that the device_id you pass is the from your on-site integration. An empty list for a single shopper is normal — see Behavior notes.

Feedback

Contact your Wunderkind representative to report issues or share suggestions for the Profiles MCP server.