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
- Install dependencies:
npm install
- Configure environment variables:
cp .env.example .env
Edit .env:
SHOPIFY_STORE_URL=your-store.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpca_xxxxx
PORT=3000
- Start the server:
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)
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
curl -X POST http://localhost:3000/call \
-H "Content-Type: application/json" \
-d '{
"tool": "search_products",
"arguments": { "query": "mug" }
}'
Example Responses
Search Products
{
"products": [
{
"id": "123",
"title": "Paint-a-Mug Kit",
"price": "49.00",
"url": "https://store.com/products/paint-a-mug"
}
],
"count": 1
}
Track Order
{
"success": true,
"order": {
"order_number": "1001",
"fulfillment_status": "fulfilled",
"tracking": [
{
"tracking_number": "1Z999...",
"tracking_url": "https://..."
}
]
}
}
Check Shipping
{
"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:
railway up
Set environment variables in Railway dashboard.