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

Environment Variables

Available Tools

Available Resources

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