Wonderkraftz Premium Gifting Studio

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