# Clind MCP Server

Customer-facing AI agent for Shopify store operations using the Model Context Protocol (MCP).

## Features

- **Order Tracking**: Track orders by order number + email
- **Product Search**: Search products, get recommendations, best sellers
- **Cart & Checkout**: Add to cart, create checkout links
- **Shipping**: Check shipping by zipcode, get delivery estimates

## Setup

1. Install dependencies:
```bash
npm install
```

2. Configure environment variables:
```bash
cp .env.example .env
```

Edit `.env`:
```
SHOPIFY_STORE_URL=your-store.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpca_xxxxx
PORT=3000
```

3. Start the server:
```bash
npm start
```

## Available Tools (11 total)

### Order Tracking
| Tool | Description |
|------|-------------|
| `track_order` | Track order by order number + email |
| `get_order_status` | Get simple status message with tracking |

### Product Discovery
| Tool | Description |
|------|-------------|
| `search_products` | Search by name, type, or tags |
| `get_product_details` | Get detailed product info |
| `get_recommendations` | Get product recommendations |
| `get_best_sellers` | Get top selling products |
| `get_collections` | Get product collections |

### Cart & Checkout
| Tool | Description |
|------|-------------|
| `add_to_cart` | Generate add-to-cart link |
| `create_checkout_link` | Create direct checkout link |

### Shipping
| Tool | Description |
|------|-------------|
| `check_shipping` | Check shipping by zipcode |
| `get_shipping_zones` | Get available shipping zones |

## API Usage

### MCP Protocol (JSON-RPC 2.0)
```bash
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_products",
      "arguments": { "query": "mug" }
    }
  }'
```

### REST API
```bash
curl -X POST http://localhost:3000/call \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "search_products",
    "arguments": { "query": "mug" }
  }'
```

## Example Responses

### Search Products
```json
{
  "products": [
    {
      "id": "123",
      "title": "Paint-a-Mug Kit",
      "price": "49.00",
      "url": "https://store.com/products/paint-a-mug"
    }
  ],
  "count": 1
}
```

### Track Order
```json
{
  "success": true,
  "order": {
    "order_number": "1001",
    "fulfillment_status": "fulfilled",
    "tracking": [
      {
        "tracking_number": "1Z999...",
        "tracking_url": "https://..."
      }
    ]
  }
}
```

### Check Shipping
```json
{
  "zipcode": "90210",
  "shipping_zone": "West Coast",
  "estimated_delivery": "3-5 business days",
  "shipping_options": [
    { "name": "Standard", "estimate": "3-5 days" },
    { "name": "Express", "estimate": "1-2 days" }
  ]
}
```

## Deployment

Deploy to Railway:
```bash
railway up
```

Set environment variables in Railway dashboard.