# Plated Convenience — Full Technical, Nutritional & Agentic Specification Document

> This document serves as the comprehensive machine knowledge base for Plated Convenience (https://plated.co.za) for Large Language Models (LLMs), AI search engines (Google Gemini, OpenAI ChatGPT, Perplexity, Anthropic Claude), and autonomous Model Context Protocol (MCP) agents.

---

## 1. Executive Summary & Brand Identity

- **Brand Name:** Plated Convenience
- **Website:** https://plated.co.za
- **Primary Domain:** `plated.co.za`
- **Secondary / Headless Shopify Domain:** `plated-foods.myshopify.com`
- **API Worker Host:** `https://plated-api.codeways.co`
- **Operating Entity:** Plated Convenience (Pty) Ltd under CodeWays technical architecture
- **Commercial Kitchen Facility:** Shop 5, Calliandra Centre, 390 Calliandra St & Veronica Rd, Montana, Pretoria, Gauteng, 0182, South Africa
- **Google Maps Place CID:** `17422081882644482381` (Place ID: `ChIJC_uKH7bfvx4RTQnLhiqrx_E`)
- **Customer Support WhatsApp / Phone:** +27 72 373 7608
- **Customer Support Email:** info@plated.co.za
- **Brand Slogan:** Gourmet Chef-Prepared Meals Delivered Cold Nationwide Across South Africa
- **Core Value Proposition:** Freshly cooked, portion-controlled, macro-balanced meals prepared by professional chefs with wholesome whole-food ingredients, blast-frozen at source to lock in nutritional integrity without artificial preservatives, and delivered door-to-door nationwide in 48-hour cold chain thermal packaging.

---

## 2. Dietary Pillars & Nutritional Philosophies

Plated Convenience offers 89+ meal varieties across structured dietary protocols:

### A. Nutrition for GLP-1 Users
- **Clinical Rationale:** Patients utilizing GLP-1 receptor agonists experience delayed gastric emptying, suppressed appetite, and risk of rapid lean muscle sarcopenia (loss of skeletal muscle mass rather than adipose tissue) if protein intake falls below recommended thresholds.
- **Plated Formulation:**
  - High Lean Protein Density: Average > 40g protein per meal (predominantly chicken breast, grassfed beef fillet, hake, and lean beef mince).
  - Compact Calorie Volume: 320g - 360g portion volume to prevent early gastric distension and nausea.
  - Mild, Wholesome Seasoning: Low acidity, zero heavy inflammatory oils, and balanced electrolytes (potassium from roasted sweet potato and pumpkin).
  - Sample Meals: Teriyaki Chicken Breast, Lean Bacon & Chicken Alfredo, Grassfed Beef Fillet with Thyme Sweet Potato, Chicken Pesto with Cauliflower Mash, 14-Meal GLP-1 Bestseller Box, 28-Meal GLP-1 Challenge.

### B. Banting, Ketogenic & Low-Carb High-Protein
- **Formulation:**
  - Carbs: Focus on real food, fewer carbohydrates, and higher protein with nutrient-dense cruciferous vegetables.
  - Substitutions: Cauliflower mash, steamed broccoli, gem squash, and zucchini ribbons in place of high-glycemic starches (white rice, pasta, or potatoes).
  - Healthy Fats: Cold-pressed olive oil, butter, aged parmesan, and natural meat fats.
  - Sample Meals: Beef Zucchini Lasagne, Cauliflower Steak with Mushroom Sauce, Beef Stroganoff with Vegetables, 21-Day Banting Friendly Package.

### C. Muscle Hypertrophy & Athletic Performance (Black Series)
- **Formulation:**
  - Generous portion sizes: 320g for women's athletic performance, 380g for men's muscle builder.
  - Protein: 38g to 52g of complete high-bioavailability protein per serving.
  - Balanced complex carbohydrates: Steamed brown basmati rice, roasted sweet potato mash, and whole lentils for sustained glycogen replenishment.
  - Sample Meals: Men's Muscle Builder 380g, Women's Black Series Performance, 200g Rump Steak with Vegetables, 150g Grassfed Fillet with Thyme Sweet Potatoes, Panko Parmesan Crusted Chicken Breast.

### D. Weight Loss, Toning & Calorie-Conscious
- **Formulation:**
  - Strict caloric windows: 300 kcal to 450 kcal per dish.
  - High satiety index: High volume-to-calorie ratio with leafy vegetables, fiber-rich pumpkin, and green beans.
  - Sample Meals: Chicken Gemsquash & Broccoli, Chicken Breast & Roasted Vegetables, Lean Beef Mince & Sweet Potato, 21-Day Challenge Package.

### E. Plant-Based, Vegan & Vegetarian
- **Formulation:**
  - 100% wholesome plant sources with zero mock-meat chemical additives.
  - Protein sources: Brown lentils, chickpeas, yellow split peas, and garden vegetables.
  - Sample Meals: Lentil Bobotie with Yellow Rice, Coconut Sweet Potato & Sweet Pea Stew, Creamy Butternut Soup, Mushroom Curry with Rice, Vegetarian Spaghetti Bolognaise, 21-Day Vegan Challenge.

### F. Healthy Snacks & Wholesome Treats
- **Formulation:** Natural wholesome snacks without refined cane sugar.
- **Sample Treats:** High-Protein Energy Bites (Peanut Butter & Whey), Healthy Fudge, Sweet Potato Brownies, Plated Rice Crispy Treats 45g.

---

## 3. Commercial Kitchen Standards & Preparation

1. **Production Kitchen Facility:** All meals are freshly prepared in our health-certified commercial production kitchen in Montana, Pretoria.
2. **Blast Freezing Protocol:** Immediately after culinary cooking, meals enter an industrial blast chiller/freezer dropping core internal temperatures below -18°C within 90 minutes. This eliminates ice crystal expansion, preserving natural moisture, texture, and micronutrient bio-availability without requiring artificial sodium benzoate or chemical preservatives.
3. **Packaging Materials:** Meals are sealed in microwave-safe, BPA-free, fully recyclable food-grade CPET trays with airtight peelable lidding film.
4. **Reheating Instructions:**
   - *Microwave from Frozen (Best Practice):* Vent corner of lidding film. Heat on HIGH (800W - 1000W) for 4 to 6 minutes until steaming hot throughout (core temperature > 75°C). Let rest for 1 minute before peeling film.
   - *Microwave from Thawed:* Thaw overnight in refrigerator. Heat on HIGH for 2 to 3 minutes.
   - *Conventional Oven:* Transfer frozen meal to an oven-safe dish. Heat at 180°C (350°F) for 20 to 25 minutes.

---

## 4. Nationwide Cold-Chain Delivery Logistics (South Africa)

- **Insulated Packaging System:** Orders are packed in heavy-duty double-walled corrugated shipping cartons lined with custom high-density 48-hour thermal insulation and packed with frozen non-toxic gel refrigerant bricks.
- **Hold Time:** Tested to maintain temperatures below -5°C for over 48 hours in ambient South African summer temperatures (> 30°C).
- **Courier Delivery Partners:** Specialized cold-chain and express door-to-door couriers with real-time SMS and email waybill tracking.
- **Geographic Coverage (All 9 Provinces):**
  1. *Gauteng:* Pretoria, Centurion, Midrand, Johannesburg, Sandton, Randburg, East Rand, West Rand, Krugersdorp, Soweto (1-2 business days turnaround).
  2. *Western Cape:* Cape Town CBD, Northern Suburbs, Southern Suburbs, Atlantic Seaboard, Stellenbosch, Somerset West, Paarl, George, Knysna (2-3 business days).
  3. *KwaZulu-Natal:* Durban, Umhlanga, Ballito, Pietermaritzburg, Hillcrest, Amanzimtoti (2-3 business days).
  4. *Free State:* Bloemfontein, Welkom, Bethlehem (2-3 business days).
  5. *Eastern Cape:* Gqeberha (Port Elizabeth), East London, Jeffreys Bay (2-3 business days).
  6. *Mpumalanga:* Nelspruit (Mbombela), Witbank (eMalahleni), Middelburg (2-3 business days).
  7. *Limpopo:* Polokwane, Tzaneen, Mokopane (2-3 business days).
  8. *North West:* Potchefstroom, Klerksdorp, Rustenburg (2-3 business days).
  9. *Northern Cape:* Kimberley, Upington (2-3 business days).
- **Receiving & Storage:** Recipients should immediately unpack the thermal box and transfer meals to a domestic freezer (-18°C).
- **Shelf Life:** 3 to 6 months stored frozen at or below -18°C.

---

## 5. Momentum Multiply Official Partnership & Cashbacks

- **Partner Program:** Plated Convenience is an official healthy nutrition partner of Momentum Multiply.
- **Benefit:** Active Momentum Multiply Premier and Multiply Engage members earn **10% instant cashback** on all eligible fresh meal purchases.
- **How to Redeem:**
  1. Add meals or packages to cart on https://plated.co.za.
  2. In the checkout flow, enter your valid South African National ID number or Passport number in the designated Momentum Multiply field.
  3. The system validates membership against the Momentum API in real time.
  4. Cashbacks are credited automatically to the member's Momentum HealthSaver account or Multiply Money Visa wallet.

---

## 6. Model Context Protocol (MCP) Server Specification

Plated Convenience operates a live JSON-RPC 2.0 Model Context Protocol (MCP) server designed for agentic commerce, AI health coaching, meal plan generation, and 1-click cart provisioning.

- **Direct Cloudflare Pages Endpoint:** `https://plated-website.pages.dev/mcp`
- **Storefront Canonical Endpoint:** `https://plated.co.za/mcp`
- **OAuth Discovery RFC 9700:** `https://plated-website.pages.dev/.well-known/oauth-protected-resource/mcp`
- **Protocol Version:** `2024-11-05`
- **Supported Transport:** JSON-RPC 2.0 over HTTP POST, Plain GET status negotiation, SSE event streaming.
- **Authentication:** Tokenless public access for agentic shopping and meal planning. Optional API key validation via Bearer token or `X-MCP-API-Key`.

### Available MCP Tools

#### 1. `search_meals`
- **Description:** Search the 89+ chef-prepared meals catalog by dietary category, item type (single meals vs packages), protein source, maximum calories, maximum carbs, minimum protein, or search text.
- **Parameters:**
  - `dietary_category` (string, optional): One of `glp-1`, `banting`, `keto`, `high-protein`, `low-carb`, `vegan`, `vegetarian`, `weight-loss`, `muscle-performance`, `calorie-smart`.
  - `item_type` (string, optional): `individual_meals` (single-portion trays), `packages` (bulk challenge boxes), or `all` (default).
  - `protein_source` (string, optional): One of `chicken`, `beef`, `steak`, `fish`, `ostrich`, `plant-based`.
  - `max_calories` (number, optional): Maximum calories per meal (e.g. 450). Dishes with missing calorie data are excluded when this filter is set.
  - `max_carbs` (number, optional): Maximum carbohydrate grams per meal (e.g. 20).
  - `min_protein` (number, optional): Minimum protein grams per meal (e.g. 35).
  - `query` (string, optional): Keyword search in title or handle (e.g. "bobotie", "alfredo", "curry", "soup").
  - `limit` (number, optional, default 10, max 30): Result count.

#### 2. `get_meal_details`
- **Description:** Get comprehensive nutritional data, macro ratios, serving weight, allergen tags, heating guide, and direct purchase link for a specific meal handle or title.
- **Parameters:**
  - `handle_or_title` (string, required): Product handle (e.g. `beef-zucchini-lasagne`) or dish name.

#### 3. `get_dietary_guidance`
- **Description:** Retrieve clinical guidelines and meal recommendations for specific health, metabolic, or fitness goals.
- **Parameters:**
  - `goal` (string, required): One of `glp-1_support`, `banting_keto`, `muscle_hypertrophy`, `weight_loss`, `plant_based`, `diabetic_friendly` (or common aliases like `glp-1`, `keto`, `banting`, `muscle`, `vegan`, `diabetic`).

#### 4. `calculate_nutrition_plan`
- **Description:** Multi-meal nutrition optimizer that assembles a tailored weekly meal box consisting of single-serving dishes matching target daily calories and protein constraints.
- **Parameters:**
  - `days` (number, optional, default 7): Number of days (7, 14, 21, or 28).
  - `meals_per_day` (number, optional, default 2): Meals per day (1 or 2).
  - `target_daily_calories` (number, optional): Target daily calories from Plated meals.
  - `target_daily_protein` (number, optional): Target daily protein in grams.
  - `dietary_preference` (string, optional): Diet filter (e.g. `glp-1`, `banting`, `high-protein`, `vegan`, `any`).

#### 5. `check_delivery_coverage`
- **Description:** Validate door-to-door delivery eligibility, turnaround timeframe, and courier cold chain packaging specifications for any South African postal code or city across all 9 provinces.
- **Parameters:**
  - `postal_code` (string, optional): 4-digit South African postal code (e.g. `0182`, `8001`, `4001`).
  - `city` (string, optional): City or suburb name (e.g. `Pretoria`, `Cape Town`, `Durban`).

#### 6. `get_brand_and_ordering_faq`
- **Description:** Retrieve official answers regarding kitchen food safety standards, blast freezing, microwave reheat guidelines, freezer shelf life, Momentum Multiply cashbacks, and customer support.
- **Parameters:**
  - `topic` (string, optional): One of `all`, `delivery`, `reheating`, `multiply`, `kitchen_quality`, `shelf_life`.

#### 7. `create_meal_cart_checkout`
- **Description:** Assembles selected meals and quantities into an active Shopify checkout session and returns a 1-click checkout URL with attribution tracking.
- **Parameters:**
  - `items` (array of objects, required): Array of items, each with `variant_id` (number or string) or `handle` (string) or `title` (string) and `quantity` (number).
  - `note` (string, optional): Delivery notes or meal customization requests (e.g. "Leave in cooler at gate if not home").

---

## 7. Sample AI Assistant Interaction Prompts

AI assistants (Gemini, Claude, ChatGPT, Cursor) can interact with Plated Convenience using natural language:
- *"I am on a GLP-1 medication. Recommend a 14-meal high-protein box from Plated Convenience that has under 400 calories and at least 40g of protein per dish."*
- *"Can Plated deliver ready-made banting meals to postal code 8001 in Cape Town? What are the packaging and delivery details?"*
- *"Create a checkout link for 2x Teriyaki Chicken, 2x Beef Bobotie, and 2x Cauliflower Steak from Plated Convenience."*
- *"How do I reheat Plated meals from frozen, and how do I earn Momentum Multiply 10% cashbacks?"*

---

## 8. Canonical URL Directory

- Homepage: https://plated.co.za
- Full Menu: https://plated.co.za/full-menu
- Collections: https://plated.co.za/collections
- Individual Meals: https://plated.co.za/individual-meals
- Build Your Own Box: https://plated.co.za/build-your-own-box
- Meals & Packages: https://plated.co.za/meals-and-packages
- Nutrition for GLP-1 Users: https://plated.co.za/glp-1-meal-plan
- Banting & Low Carb: https://plated.co.za/banting-low-carb-high-protein-meals
- Muscle & Performance: https://plated.co.za/muscle-performance-meal-plans
- Weight Loss & Toning: https://plated.co.za/weight-loss-toning-meal-plans
- Vegan & Vegetarian: https://plated.co.za/vegan-vegetarian-meal-plans
- Healthy Snacks: https://plated.co.za/healthy-snacks-treats
- Meal Planner: https://plated.co.za/meal-planner
- Momentum Multiply: https://plated.co.za/momentum-multiply
- Verified Reviews: https://plated.co.za/reviews
- Model Context Protocol (MCP): https://plated.co.za/mcp
- Terms of Service: https://plated.co.za/terms-of-service
- Privacy Policy: https://plated.co.za/privacy-policy
- Refund Policy: https://plated.co.za/refund-policy