merchant-hq.vercel.app

{
  "name": "get_dashboard_summary",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns quick counts of what needs the merchant's attention right now: unfulfilled orders, low-stock inventory items, and open customer messages. Good first call to orient on the state of the store.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
  }
}

{
  "name": "list_orders",
  "kind": "answer",
  "impl": "imperative",
  "description": "Lists orders, optionally filtered by status. Call this before update_order_status to find a valid orderId.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "status": {
        "type": "string",
        "enum": [
          "unfulfilled",
          "fulfilled",
          "refund_requested"
        ],
        "description": "Filter to orders with this status. Omit to list all orders."
      }
    },
    "required": []
  }
}

{
  "name": "update_order_status",
  "kind": "act",
  "impl": "imperative",
  "description": "Marks an order as fulfilled, refund_requested, or unfulfilled. Requires a valid orderId from list_orders.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "orderId": {
        "type": "string",
        "description": "The order id, e.g. ord_1001. Get this from list_orders."
      },
      "status": {
        "type": "string",
        "enum": [
          "unfulfilled",
          "fulfilled",
          "refund_requested"
        ],
        "description": "The new status to set."
      }
    },
    "required": [
      "orderId",
      "status"
    ]
  }
}

{
  "name": "list_inventory",
  "kind": "answer",
  "impl": "imperative",
  "description": "Lists inventory items, optionally filtered to only items whose stock is below their restock threshold.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "lowStockOnly": {
        "type": "boolean",
        "description": "If true, only return items with stock below their threshold."
      }
    },
    "required": []
  }
}

{
  "name": "restock_item",
  "kind": "act",
  "impl": "imperative",
  "description": "Increases an inventory item's stock by a given quantity. Requires a valid sku from list_inventory.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "sku": {
        "type": "string",
        "description": "The item's sku, e.g. MUG-001. Get this from list_inventory."
      },
      "addQty": {
        "type": "number",
        "minimum": 1,
        "description": "How many units to add to current stock. Must be a positive number."
      }
    },
    "required": [
      "sku",
      "addQty"
    ]
  }
}

{
  "name": "list_messages",
  "kind": "answer",
  "impl": "imperative",
  "description": "Lists customer messages, optionally filtered by status.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "status": {
        "type": "string",
        "enum": [
          "open",
          "replied"
        ],
        "description": "Filter to messages with this status. Omit to list all messages."
      }
    },
    "required": []
  }
}

{
  "name": "draft_message_reply",
  "kind": "act",
  "impl": "imperative",
  "description": "Saves a draft reply to a customer message and marks it replied. Requires a valid messageId from list_messages.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "messageId": {
        "type": "string",
        "description": "The message id, e.g. msg_2001. Get this from list_messages."
      },
      "replyText": {
        "type": "string",
        "description": "The reply text to save as the draft."
      }
    },
    "required": [
      "messageId",
      "replyText"
    ]
  }
}

{
  "name": "create_discount_code",
  "kind": "act",
  "impl": "imperative",
  "description": "Creates a new active discount code for the store. If code is omitted, one is auto-generated from the percentage off. Requires the merchant to explicitly approve the code in a confirmation dialog before it's created.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "percentOff": {
        "type": "number",
        "minimum": 1,
        "maximum": 100,
        "description": "The discount percentage, between 1 and 100."
      },
      "code": {
        "type": "string",
        "description": "Optional custom code. Auto-generated if omitted."
      }
    },
    "required": [
      "percentOff"
    ]
  }
}