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