Wonderkraftz - Premium Gifting Studio

io.github.rachit1987Published by GitHub account rachit1987v1.0.0Updated Oct 24, 2026

Browse and shop Wonderkraftz premium gifts. Recommendations, cart, and checkout via AI.

Overview

AI-generated overview

Lets an assistant browse the Wonderkraftz gift catalog, get recommendations, manage a shopping cart, and produce a checkout link.

What you can do
Connects an assistant to the Wonderkraftz Premium Gifting Studio storefront. Tools cover product search, product details, collections, recommendations, cart creation and updates, cart viewing, checkout URL generation, and store policies. Two resources expose store information and the collection list.
When to use it
Useful when someone wants to shop for premium or corporate gifts conversationally: finding items by occasion or keyword, comparing options, building a cart, and getting a link to finish the purchase in a browser.
Requirements
Runs as a local process via npx or a global npm install, so Node.js is needed. Requires the environment variables SHOPIFY_STORE_DOMAIN and SHOPIFY_STOREFRONT_ACCESS_TOKEN. A hosted HTTP endpoint is also described for remote clients. Desktop only.
Before you install
The README shows the store domain and the SHOPIFY_STOREFRONT_ACCESS_TOKEN value in plain text in its setup examples; treat those as exposed and use your own credentials rather than copying them. Cart tools write to a cart, and checkout hands off to a browser to complete a real purchase. The hosted HTTP endpoint sends requests to a third-party server.

Installation

In SourceWeft

  1. Open Wonderkraftz - Premium Gifting Studio in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Wonderkraftz Logo]

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)

bash
SHOPIFY_STORE_DOMAIN=64cd5c-2.myshopify.com \SHOPIFY_STOREFRONT_ACCESS_TOKEN=aeeec5ab77309d1c339d2971f56b6506 \npx wonderkraftz-mcp

Option 2: Install globally

bash
npm install -g wonderkraftz-mcp

Setup

Cursor IDE

Add to your project's .cursor/mcp.json:

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:

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:

bash
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

TransportEntry PointUse Case
stdiowonderkraftz-mcpCursor, Claude Desktop, local AI tools
Streamable HTTPwonderkraftz-mcp-httpChatGPT, Grok, remote/cloud AI tools

Environment Variables

VariableDescriptionRequired
SHOPIFY_STORE_DOMAINShopify store domain (e.g., your-store.myshopify.com)Yes
SHOPIFY_STOREFRONT_ACCESS_TOKENPublic Storefront API access tokenYes
PORTHTTP server port (default: 3000, HTTP transport only)No

Available Tools

ToolDescription
search_productsSearch the product catalog by keyword
get_product_detailsGet full details for a product by handle or ID
get_collectionsList all product collections
get_collection_productsBrowse products in a specific collection
get_recommendationsGet product recommendations based on a product
create_cartCreate a new shopping cart with items
add_to_cartAdd items to an existing cart
update_cartUpdate item quantities in a cart
remove_from_cartRemove items from a cart
get_cartView cart contents and totals
get_checkout_urlGet checkout URL to complete purchase
get_store_policiesView store shipping, return, and privacy policies

Available Resources

URIDescription
wonderkraftz://store/infoStore information, branding, and payment settings
wonderkraftz://collectionsList 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

bash
git clone https://github.com/rachit1987/wonderkraftz-mcp.gitcd wonderkraftz-mcpnpm installcp .env.example .env  # Add your Shopify credentialsnpm run buildnpm start             # stdio transportnpm run start:http    # HTTP transport

License

MIT

Source: README.md at commit 4854687

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.