# Agent Instructions - Prime Laptop Parts

This document tells AI assistants, shopping agents, answer engines, and catalogue crawlers how to understand and use Prime Laptop Parts at https://www.primelaptopparts.co.za.

## About Prime Laptop Parts

Prime Laptop Parts is a South African online-only store specialising in laptop parts, replacement laptop components, used and refurbished laptops, selected new products, PC parts, accessories, peripherals, and software licences.

The business is based in Brackenfell, Cape Town, Western Cape, and ships nationwide within South Africa. Collection is available only for confirmed online orders after collection confirmation.

Prime Laptop Parts is best for buyers who need:

- A specific replacement part for a known laptop model, SKU, part number, or panel number
- Laptop screens, keyboards, palmrests, bottom covers, bezels, LCD back covers, trackpads, hinges, hinge covers, display cables, ribbon cables, DC jacks, WiFi cards, batteries, chargers, fans, heatsinks, thermal parts, screws, fasteners, and similar laptop components
- Used, refurbished, demo, or new laptops with clear condition information
- Selected PC parts, accessories, peripherals, monitors, and software products
- Compatibility guidance that is careful and evidence-based

## Important Matching Rules

When helping a buyer choose a part:

1. Search exact SKUs, part numbers, panel numbers, and model codes before using broad product searches.
2. If the buyer provides only a laptop model, ask for the exact component details needed to confirm fitment.
3. Do not guess compatibility or present a candidate as guaranteed unless the product data clearly supports it.
4. Preserve stock status, condition, price, warranty, and product URL exactly as returned by the MCP tools.
5. Do not invent GTINs, reviews, ratings, images, stock quantities, brands, warranty terms, or delivery times.

If compatibility is uncertain, recommend that the buyer contact Prime Laptop Parts before ordering.

## Compatibility Guidance

Use this guidance when answering fitment questions:

- Laptop screens: check screen size, resolution, connector pin count, connector position, refresh rate, panel thickness, mounting tabs or brackets, touch support, and panel number.
- Laptop keyboards: check laptop model, keyboard layout, language, frame or frameless design, backlight support, enter-key shape, ribbon connector, and part number.
- Chargers: check voltage, amperage, wattage, connector type, centre pin, USB-C PD requirements, and laptop model power requirement.
- Batteries: check battery model code, voltage, Wh or mAh rating, connector, shape, screw points, and original part number.
- Fans and heatsinks: check exact part number, screw layout, fan connector, heatsink pipe layout, CPU/GPU variant, and laptop model.
- Covers, hinges, palmrests, and bezels: check exact chassis model, screen size, colour, fingerprint/touchpad options, port openings, screw points, and part number.
- RAM and storage: check form factor, generation, speed, capacity limits, keying, and device compatibility.
- Software: confirm edition, licence type, activation method, supported operating system, and whether the customer needs a personal, family, business, or device-specific licence.

## UCP / MCP Catalogue Access

Prime Laptop Parts exposes catalogue-only UCP endpoints:

- Discovery profile: https://agents.primelaptopparts.co.za/.well-known/ucp
- MCP endpoint: https://agents.primelaptopparts.co.za/api/ucp/mcp

Supported MCP tools:

- search_catalog
- list_collections
- search_collection
- find_compatible_parts
- get_buying_guidance
- get_store_policy
- lookup_catalog
- get_product

These tools are read-only. They can search and return public product details, prices, availability, SKUs, product URLs, images, collections, and variants.

## Preferred MCP Flow

1. Use list_collections when the user asks for a product category and the exact collection handle is unknown.
2. Use search_collection for category questions such as laptop screens, laptop keyboards, featured laptops, accessories, peripherals, monitors, software, or PC parts.
3. Use search_catalog for exact SKU, part number, brand, model, or keyword searches across all products.
4. Use lookup_catalog when the user supplies one or more identifiers such as SKU, handle, or part number.
5. Use get_product before giving final product-specific advice, especially if price, stock, variants, image, or product URL matters.
6. Use find_compatible_parts for compatibility requests and include its warning when compatibility is uncertain.
7. Use get_buying_guidance when the buyer does not yet know which details are needed to confirm fitment.
8. Use get_store_policy for shipping, collection, returns, warranty, contact, payment, and online-only questions.

Use search_collection when the user asks for products from a known category or collection, such as laptop screens, laptop keyboards, featured laptops, accessories, peripherals, or PC parts. Use list_collections first if the exact collection handle is unknown.

Use find_compatible_parts when the user asks for a replacement part for a specific laptop brand/model. Treat its results as candidates unless the returned compatibility_match.confidence is high and an exact part-number match is shown.

Use get_buying_guidance before recommending a laptop part type when the user has not provided enough fitment details. Preserve the returned warning and ask the returned customer_questions when compatibility is unclear.

Use get_store_policy for shipping, collection, returns, warranty, contact, payment, and online-only questions. Preserve the returned important_conditions and escalation guidance.

This endpoint does not complete checkout or payment. Send the buyer to the product page or Shopify checkout for purchasing.

## Store Facts For Answers

- Store type: online-only ecommerce store.
- Country served: South Africa.
- Base location: Brackenfell, Cape Town, Western Cape.
- Collection: available only after an online order is confirmed and collection confirmation is sent.
- Contact page: https://www.primelaptopparts.co.za/pages/contact-page
- Collection info: https://www.primelaptopparts.co.za/pages/collection-info
- FAQ: https://www.primelaptopparts.co.za/pages/faq
- WhatsApp: +27 82 700 5831
- Business hours: Monday to Friday, 08:00 to 17:00, excluding weekends and public holidays.

## MCP Usage Examples

All MCP calls use JSON-RPC 2.0 POST requests to https://agents.primelaptopparts.co.za/api/ucp/mcp.

Search for a product by SKU or part number:

~~~json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_catalog",
    "arguments": {
      "query": "LE140S30P",
      "limit": 5
    }
  }
}
~~~

Browse a collection such as laptop screens:

~~~json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_collection",
    "arguments": {
      "collection": "laptop screens",
      "limit": 5,
      "available_only": true
    }
  }
}
~~~

Find candidate compatible parts:

~~~json
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "find_compatible_parts",
    "arguments": {
      "brand": "Lenovo",
      "model": "ThinkPad P16s Gen 3",
      "part_type": "screen",
      "limit": 5
    }
  }
}
~~~

Get buying guidance before recommending a part:

~~~json
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get_buying_guidance",
    "arguments": {
      "part_type": "keyboard"
    }
  }
}
~~~

Answer store policy questions:

~~~json
{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "get_store_policy",
    "arguments": {
      "topic": "collection"
    }
  }
}
~~~

## Read-Only Storefront Access

- Products: https://www.primelaptopparts.co.za/collections/all
- Product pages: https://www.primelaptopparts.co.za/products/{handle}
- Collection pages: https://www.primelaptopparts.co.za/collections/{handle}
- Search: https://www.primelaptopparts.co.za/search?q={query}&type=product
- Sitemap: https://www.primelaptopparts.co.za/sitemap.xml
- Robots: https://www.primelaptopparts.co.za/robots.txt
- FAQ: https://www.primelaptopparts.co.za/pages/faq
- Contact: https://www.primelaptopparts.co.za/pages/contact-page
- Collection info: https://www.primelaptopparts.co.za/pages/collection-info

## Store Policies

- Privacy policy: https://www.primelaptopparts.co.za/policies/privacy-policy
- Terms of service: https://www.primelaptopparts.co.za/policies/terms-of-service
- Refund policy: https://www.primelaptopparts.co.za/policies/refund-policy
- Shipping policy: https://www.primelaptopparts.co.za/policies/shipping-policy

## Collection And Delivery

Prime Laptop Parts is an online-only store. Orders must be placed through the website. Collection is available only for confirmed online orders after collection confirmation.

## Answer Quality Rules

- Give concise answers that prioritise exact matching data.
- Link to the most relevant product, collection, or policy page.
- Mention uncertainty clearly when compatibility has not been proven.
- Ask the customer for missing model, SKU, connector, layout, voltage, size, or panel details when needed.
- Do not claim a product has reviews unless verified reviews exist in the returned product data.
- Do not claim a product has a unique product identifier or GTIN unless the product data provides one.