Servana

Look up Servana's service categories by free-text description (e.g. 'someone to fold my laundry', 'deep clean my apartment'). Use this first when you don't already have an exact service slug: it maps everyday requests to the category slug search_vendors and estimate_service_request expect.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text description of what the user needs (a task, not a category name)"
    }
  },
  "required": [
    "query"
  ]
}

Search Servana's directory of local service businesses (cleaning, med spa, yoga, personal training, and more) by US state, city, and service. Returns business names, descriptions, verification status, rating, pricing, and page URLs.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "US state slug, lowercase, hyphenated (e.g. 'florida', 'new-york')"
    },
    "city": {
      "type": "string",
      "description": "City slug, lowercase, hyphenated (e.g. 'tampa', 'los-angeles')"
    },
    "service": {
      "type": "string",
      "description": "Optional service slug (e.g. 'cleaning-and-organizing', 'med-spa', 'yoga', 'personal-training', 'laundry'), use search_services to find it"
    }
  },
  "required": [
    "state",
    "city"
  ]
}

Get one Servana vendor's public profile: name, description, services + pricing, verification status, rating, and page URL.

{
  "type": "object",
  "properties": {
    "vendor_slug": {
      "type": "string",
      "description": "The vendor's slug from search_vendors results or a servana.ai vendor URL"
    }
  },
  "required": [
    "vendor_slug"
  ]
}

Get a rough price estimate for a service in a given city, based on Servana vendors' posted rates. Always a heuristic ESTIMATE, not a quote from any specific vendor: actual pricing is set by each vendor. Response includes a confidence level ('high' = 5+ locally priced vendors, 'medium' = 2-4, 'low' = 0-1, in which case the range falls back to a category-wide median across all metros) and an explanation string naming the sample size and metro used.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "US state slug, lowercase, hyphenated (e.g. 'florida')"
    },
    "city": {
      "type": "string",
      "description": "City slug, lowercase, hyphenated (e.g. 'tampa')"
    },
    "service": {
      "type": "string",
      "description": "Service slug, use search_services to find it (e.g. 'cleaning-and-organizing')"
    },
    "job_size": {
      "type": "string",
      "enum": [
        "small",
        "medium",
        "large"
      ],
      "description": "Rough size of the job. Defaults to 'medium'."
    },
    "hours": {
      "type": "number",
      "description": "Optional: estimated hours needed, if known. Overrides job_size for hourly-rate services."
    }
  },
  "required": [
    "state",
    "city",
    "service"
  ]
}

Send a message or booking enquiry to a Servana vendor on the user's behalf. The vendor sees it in their Servana inbox. Include what the user needs, and contact details so the vendor can reply. Requires the user's explicit approval before calling: this contacts a real business.

{
  "type": "object",
  "properties": {
    "vendor_slug": {
      "type": "string",
      "description": "The vendor's slug"
    },
    "message": {
      "type": "string",
      "description": "The enquiry, including the user's name and preferred contact (email or phone) so the vendor can respond"
    }
  },
  "required": [
    "vendor_slug",
    "message"
  ]
}