Wonderkraftz MCP Server
An MCP (Model Context Protocol) server that connects AI assistants to the Wonderkraftz Premium Gifting Studio. Browse products, get personalized gift recommendations, manage your cart, and checkout — all through natural language in your AI assistant.
Features
- Product Search — Search the catalog by keyword, occasion, or gift type
- Product Details — Get full product info including variants, pricing, and images
- Collections — Browse curated gift collections (Corporate Gifts, Wedding Hampers, etc.)
- Recommendations — Get product suggestions based on a product you like
- Cart Management — Create carts, add/update/remove items
- Checkout — Get a checkout URL to complete your purchase in a browser
- Store Policies — View shipping, returns, and privacy policies
Quick Start
Option 1: npx (no install needed)
SHOPIFY_STORE_DOMAIN=64cd5c-2.myshopify.com \
SHOPIFY_STOREFRONT_ACCESS_TOKEN=aeeec5ab77309d1c339d2971f56b6506 \
npx wonderkraftz-mcp
Option 2: Install globally
npm install -g wonderkraftz-mcp
Setup
Cursor IDE
Add to your project's .cursor/mcp.json:
{
"mcpServers": {
"wonderkraftz": {
"command": "npx",
"args": ["-y", "wonderkraftz-mcp"],
"env": {
"SHOPIFY_STORE_DOMAIN": "64cd5c-2.myshopify.com",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN": "aeeec5ab77309d1c339d2971f56b6506"
}
}
}
}
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"wonderkraftz": {
"command": "npx",
"args": ["-y", "wonderkraftz-mcp"],
"env": {
"SHOPIFY_STORE_DOMAIN": "64cd5c-2.myshopify.com",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN": "aeeec5ab77309d1c339d2971f56b6506"
}
}
}
}
ChatGPT / Grok / Remote AI Tools
Use the hosted HTTP endpoint -- no install needed:
https://wonderkraftz-mcp.onrender.com/mcp
Point your MCP client to this URL. It supports Streamable HTTP transport.
Self-Hosted HTTP (optional)
To run the HTTP transport yourself:
SHOPIFY_STORE_DOMAIN=64cd5c-2.myshopify.com \
SHOPIFY_STOREFRONT_ACCESS_TOKEN=aeeec5ab77309d1c339d2971f56b6506 \
npx wonderkraftz-mcp-http
The server starts on http://localhost:3000/mcp (or set PORT env var).
Transports
| Transport | Entry Point | Use Case |
|---|---|---|
| stdio | wonderkraftz-mcp | Cursor, Claude Desktop, local AI tools |
| Streamable HTTP | wonderkraftz-mcp-http | ChatGPT, Grok, remote/cloud AI tools |
Environment Variables
| Variable | Description | Required |
|---|---|---|
SHOPIFY_STORE_DOMAIN | Shopify store domain (e.g., your-store.myshopify.com) | Yes |
SHOPIFY_STOREFRONT_ACCESS_TOKEN | Public Storefront API access token | Yes |
PORT | HTTP server port (default: 3000, HTTP transport only) | No |
Available Tools
| Tool | Description |
|---|---|
search_products | Search the product catalog by keyword |
get_product_details | Get full details for a product by handle or ID |
get_collections | List all product collections |
get_collection_products | Browse products in a specific collection |
get_recommendations | Get product recommendations based on a product |
create_cart | Create a new shopping cart with items |
add_to_cart | Add items to an existing cart |
update_cart | Update item quantities in a cart |
remove_from_cart | Remove items from a cart |
get_cart | View cart contents and totals |
get_checkout_url | Get checkout URL to complete purchase |
get_store_policies | View store shipping, return, and privacy policies |
Available Resources
| URI | Description |
|---|---|
wonderkraftz://store/info | Store information, branding, and payment settings |
wonderkraftz://collections | List of all product collections |
Example Conversations
"Show me corporate gift options under 2000 rupees"
"I need a wedding gift hamper. What do you recommend?"
"Add the luxury gift box to my cart and give me the checkout link"
"What's your return policy?"
Development
git clone https://github.com/rachit1987/wonderkraftz-mcp.git
cd wonderkraftz-mcp
npm install
cp .env.example .env # Add your Shopify credentials
npm run build
npm start # stdio transport
npm run start:http # HTTP transport
License
MIT