store.nekuda.ai

{
  "name": "authenticate",
  "kind": "action",
  "impl": "imperative",
  "description": "Initiate user authentication. Opens a sign-in modal. Use this when the user needs to log in before accessing other tools.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
  }
}

{
  "name": "search_products",
  "kind": "read",
  "impl": "imperative",
  "description": "Search and browse the nekuda hat catalog. Use for any product discovery: finding hats by style/theme, browsing the collection, or showing what's available. Set max_results to 10 when the customer wants to see everything.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "What the customer is looking for (e.g., \"space themed hats\", \"nature designs\", \"hats\" for browsing all)"
      },
      "max_results": {
        "type": "number",
        "description": "Maximum number of results to return (default: 3, use 10 for browsing)"
      }
    },
    "required": [
      "query"
    ]
  }
}

{
  "name": "get_product_details",
  "kind": "read",
  "impl": "imperative",
  "description": "Get full details for a specific hat by its product ID. Use when a customer asks about a particular product they've already seen.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_id": {
        "type": "string",
        "description": "The product ID (e.g., \"space-explorer\", \"tech-circuit\", \"botanical-bots\", \"mecha-wildlife\", \"cosmic-adventure\")"
      }
    },
    "required": [
      "product_id"
    ]
  }
}

{
  "name": "checkout",
  "kind": "read",
  "impl": "imperative",
  "description": "Start the checkout process. Use when the customer says they want to pay, checkout, complete their order, or proceed to payment.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
  }
}

{
  "name": "add_to_cart",
  "kind": "write",
  "impl": "imperative",
  "description": "Add a product to the shopping cart. Use when the customer wants to buy a hat, add it to cart, or says \"I'll take it\".",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_id": {
        "type": "string",
        "description": "The product ID to add (e.g., \"space-explorer\")"
      },
      "quantity": {
        "type": "number",
        "description": "Number of items to add (default 1)"
      }
    },
    "required": [
      "product_id"
    ]
  }
}

{
  "name": "get_deals",
  "kind": "read",
  "impl": "imperative",
  "description": "Get current deals, promotions, and discount codes. Use when the customer asks about sales, discounts, promo codes, or ways to save money.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
  }
}

{
  "name": "price_history",
  "kind": "action",
  "impl": "imperative",
  "description": "Get historical price data for a specific product. Use when the customer asks about price trends, whether a product is on sale, or if the price has changed.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_id": {
        "type": "string",
        "description": "The product ID to get price history for (e.g., \"space-explorer\")"
      }
    },
    "required": [
      "product_id"
    ]
  }
}

{
  "name": "check_availability",
  "kind": "read",
  "impl": "imperative",
  "description": "Check if a product is available for in-store pickup at nearby locations. Use when the customer asks about store stock, pickup options, or local availability.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_id": {
        "type": "string",
        "description": "The product ID to check availability for"
      }
    },
    "required": [
      "product_id"
    ]
  }
}

{
  "name": "get_best_sellers",
  "kind": "read",
  "impl": "imperative",
  "description": "Get the store's best-selling products. Use only when the customer specifically asks about best sellers, most popular hats, or top picks. For general browsing use search_products.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
  }
}

{
  "name": "faq_support",
  "kind": "action",
  "impl": "imperative",
  "description": "Answer questions about store policies: shipping, returns, sizing, materials, gift wrapping, care instructions, etc. Use when the customer asks a non-product question about how the store works.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "question": {
        "type": "string",
        "description": "The customer question about policies, shipping, returns, sizing, etc."
      }
    },
    "required": [
      "question"
    ]
  }
}

{
  "name": "track_order",
  "kind": "action",
  "impl": "imperative",
  "description": "Track the shipping status of an order. Returns order status, carrier, tracking number, and estimated delivery.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "order_id": {
        "type": "string",
        "description": "The order ID to track. If not provided, tracks the most recent order."
      }
    }
  }
}

{
  "name": "request_return",
  "kind": "action",
  "impl": "imperative",
  "description": "Start a return for an order. Opens the return form for the customer to fill out.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "order_id": {
        "type": "string",
        "description": "The order ID to return"
      },
      "reason": {
        "type": "string",
        "description": "Reason for the return"
      }
    }
  }
}

{
  "name": "leave_review",
  "kind": "action",
  "impl": "imperative",
  "description": "Open a review form for a purchased product. Lets the customer rate and review a product.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_name": {
        "type": "string",
        "description": "The name of the product to review"
      }
    }
  }
}