Summary
Connects Claude to the Wonderkraftz Shopify storefront via the Storefront API. Exposes product search, collection browsing, cart management (create, add, update, remove), checkout URL generation, and store policy retrieval. Runs over stdio for local AI tools or as a hosted HTTP endpoint for ChatGPT and Grok. You'd reach for this if you're building conversational commerce into an AI assistant and want users to browse gifts, get recommendations, and build carts through natural language without leaving the chat interface. The server handles all the Shopify GraphQL calls and returns structured product data, pricing, variants, and cart state.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
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
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
SHOPIFY_STORE_DOMAIN*Shopify store domain (e.g., your-store.myshopify.com)
SHOPIFY_STOREFRONT_ACCESS_TOKEN*secretPublic Storefront API access token from the Shopify Headless channel