kush.pw

{
  "name": "search_items",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the full government catalog, independently of visible filters. Returns a paginated snapshot; prices can be bids, not purchase prices. Does not change the page. Use show_item to open a result.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Keywords in title, location, category or description."
      },
      "source": {
        "type": "string",
        "description": "Agency name, e.g. GSA surplus, Treasury, HUD."
      },
      "category": {
        "type": "string"
      },
      "location": {
        "type": "string"
      },
      "max_price": {
        "type": "number",
        "minimum": 0,
        "description": "Maximum published USD amount; excludes missing prices. May be a bid or acquisition cost, not total purchase cost."
      },
      "priced_only": {
        "type": "boolean"
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 20
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "default": 0
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "page": "/you-can-buy-a-what"
}

{
  "name": "get_whimsical_items",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return the handpicked Most whimsical collection in editorial order. This is a curated selection, not a whimsy score.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": [],
    "additionalProperties": false
  },
  "page": "/you-can-buy-a-what"
}

{
  "name": "get_item",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get a listing with description, restrictions, price type, checked time and official documents. Availability and eligibility must be verified with the official source.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "minLength": 1,
        "description": "Exact item ID returned by search_items or get_whimsical_items."
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  },
  "page": "/you-can-buy-a-what"
}

{
  "name": "set_shortlist",
  "kind": "act",
  "impl": "imperative",
  "description": "Add or remove one item from the current visit’s shortlist. Updates the visible saved hearts. Idempotent; saved items reset on reload.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "minLength": 1,
        "description": "Exact item ID returned by search_items or get_whimsical_items."
      },
      "saved": {
        "type": "boolean",
        "description": "true to save, false to remove."
      }
    },
    "required": [
      "id",
      "saved"
    ],
    "additionalProperties": false
  },
  "page": "/you-can-buy-a-what"
}

{
  "name": "get_shortlist",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return items saved during this page visit, including saves made with the website’s hearts. The shortlist resets on reload.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": [],
    "additionalProperties": false
  },
  "page": "/you-can-buy-a-what"
}

{
  "name": "show_item",
  "kind": "act",
  "impl": "imperative",
  "description": "Open an item’s detail panel on the page for the user. Does not navigate to an auction or place bids.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "minLength": 1,
        "description": "Exact item ID returned by search_items or get_whimsical_items."
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  },
  "page": "/you-can-buy-a-what"
}