{
  "name": "MOKWN MCP Server",
  "version": "1.0.0",
  "protocol": "Model Context Protocol (2024-11-05)",
  "description": "Official MCP Server for MOKWN. Allows AI agents to search the catalog, calculate quotes, and place complete orders with Cash on Delivery (COD) in Egypt.",
  "endpoint": "https://mokwn.com/mcp",
  "transport": "streamable-http (JSON-RPC 2.0 via POST)",
  "capabilities": {
    "tools": [
      {
        "name": "search_catalog",
        "description": "Search MOKWN electronics catalog by keywords (supports English and Arabic names). Returns matching items with price in EGP, current stock quantity, UUID, slug, and category."
      },
      {
        "name": "get_product_details",
        "description": "Get detailed specifications, live stock, exact price in EGP, and pinout/logic level details for a specific product by UUID or slug."
      },
      {
        "name": "list_categories",
        "description": "List all hardware component categories available in the store (Arduino, ESP32, sensors, motors, power, ICs, cables)."
      },
      {
        "name": "get_shipping_rates",
        "description": "Get shipping delivery rates in EGP and delivery estimates across Egyptian governorates (Cairo, Giza, Alexandria, Delta, Upper Egypt, Sinai, etc.) and free shipping rules."
      },
      {
        "name": "validate_coupon",
        "description": "Validate a promotional discount coupon code against an order total."
      },
      {
        "name": "quote_order",
        "description": "Calculate an itemized pre-checkout quotation before placing an order. Returns verified item prices, subtotal, shipping fee based on governorate, coupon discount, and final total in EGP."
      },
      {
        "name": "place_order",
        "description": "MAKE THE WHOLE ORDER. Submits and confirms an official order with Cash on Delivery (COD) across Egypt. Validates recipient info, stock availability, and creates the order securely on MOKWN."
      },
      {
        "name": "track_order",
        "description": "Lookup the status, delivery tracking, and item details of an existing MOKWN order using the order ID and customer phone or email."
      },
      {
        "name": "ask_volt",
        "description": "Consult Volt, MOKWN’s Senior AI Embedded Systems Engineer. Ask hardware questions, pinout explanations, power rail budgeting, protocol choices (I2C/SPI/UART), microcontroller comparisons (ESP32 vs Arduino vs Pico), and troubleshooting in English or Egyptian Arabic."
      },
      {
        "name": "volt_get_project_bom",
        "description": "Generate an engineered Bill of Materials (BOM) for any hardware/robotics/IoT project. Volt architects the circuit, includes necessary power subsystems, driver modules, and accessories (jumpers, breadboards, cables), and automatically matches items against MOKWN’s live inventory with live UUIDs, stock, and prices in EGP ready for direct checkout."
      },
      {
        "name": "volt_check_compatibility",
        "description": "Audit electrical, power, and logic-level compatibility between a set of components before buying. Detects 3.3V vs 5V logic mismatches, inductive loads needing external power/drivers, ADC constraints, and missing accessories (cables, breadboards, jumper wires)."
      },
      {
        "name": "volt_generate_wiring_and_code",
        "description": "Generate point-to-point pin wiring diagrams and compile-ready Arduino C++ or MicroPython firmware for a list of components and project behavior."
      }
    ],
    "resources": [
      {
        "uri": "mokwn://store/info",
        "name": "MOKWN Store Overview",
        "mimeType": "text/markdown",
        "description": "Store policies, authentic sourcing guarantee, currency (EGP), and warehouse details."
      },
      {
        "uri": "mokwn://store/shipping-rate-card",
        "name": "Egypt Shipping Rate Card",
        "mimeType": "application/json",
        "description": "Full shipping fees and delivery estimates by Egyptian governorate."
      }
    ]
  },
  "documentation": "https://mokwn.com/llms.txt",
  "support": "support@mokwn.com"
}