Servana MCP

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

{
  "title": "Search service categories",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "state",
    "city"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "City name or slug (e.g. 'new-york', 'tampa', 'los-angeles'). For New York City use 'new-york'."
    },
    "need": {
      "type": "string",
      "description": "The user's specific need in their own words, e.g. 'declutter and organize a cluttered house, best packages'. Ranks businesses whose own description matches it first; never invents a match."
    },
    "state": {
      "type": "string",
      "description": "US state, as a name or slug (e.g. 'new-york', 'florida'). Two-letter codes like 'NY' also work."
    },
    "service": {
      "type": "string",
      "description": "Optional service category slug: 'cleaning-and-organizing' (house cleaning, decluttering), 'laundry-washing' (wash and fold), 'med-spa' (botox, facials, skincare), 'yoga', 'personal-training', 'photography', 'home-services' (handyman, home upkeep), 'personal-services'. Use search_services if none fits."
    }
  }
}

{
  "title": "Find local businesses",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

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

{
  "title": "Get business profile",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "state",
    "city",
    "service"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "City name or slug (e.g. 'new-york', 'tampa', 'los-angeles'). For New York City use 'new-york'."
    },
    "hours": {
      "type": "number",
      "description": "Optional: estimated hours needed, if known. Overrides job_size for hourly-rate services."
    },
    "state": {
      "type": "string",
      "description": "US state, as a name or slug (e.g. 'new-york', 'florida'). Two-letter codes like 'NY' also work."
    },
    "service": {
      "type": "string",
      "description": "Service category slug: 'cleaning-and-organizing' (house cleaning, decluttering), 'laundry-washing' (wash and fold), 'med-spa' (botox, facials, skincare), 'yoga', 'personal-training', 'photography', 'home-services' (handyman, home upkeep), 'personal-services'"
    },
    "job_size": {
      "enum": [
        "small",
        "medium",
        "large"
      ],
      "type": "string",
      "description": "Rough size of the job. Defaults to 'medium'."
    }
  }
}

{
  "title": "Estimate service cost",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "vendor_slug",
    "message"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "The enquiry: what the user needs, when and where, plus the user's name and preferred contact (email or phone) so the business can reply"
    },
    "vendor_slug": {
      "type": "string",
      "description": "The vendor's slug"
    },
    "customer_name": {
      "type": "string",
      "description": "The user's name, as they gave it. Needed so the business knows who is asking."
    },
    "customer_email": {
      "type": "string",
      "description": "The user's email, as they gave it. Servana emails the user a link to read the business's reply. Never invent one."
    },
    "customer_phone": {
      "type": "string",
      "description": "Optional phone number, only if the user gave one."
    },
    "also_vendor_slugs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 2,
      "description": "Optional: up to 2 more Servana businesses (slugs from search_vendors) to send the same enquiry to. Only when the user asked to contact several businesses and approved the one message for all of them."
    }
  }
}

{
  "title": "Message a business",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "enquiry_refs"
  ],
  "properties": {
    "enquiry_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 5,
      "description": "The enquiry_refs returned by send_message_to_vendor"
    }
  }
}

{
  "title": "Check for replies",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "vendor_slugs"
  ],
  "properties": {
    "notes": {
      "type": "string",
      "description": "Anything else the user wants to say"
    },
    "details": {
      "type": "object",
      "description": "What the user already said, keyed by field: date_window, time_window, area, home_size, job_details, frequency, session_goal, session_count, treatment, shoot_type, duration, people_count, load_size, budget. Leave out what you do not know; never invent.",
      "additionalProperties": {
        "type": "string"
      }
    },
    "service": {
      "type": "string",
      "description": "Service category slug, e.g. 'cleaning-and-organizing'"
    },
    "vendor_slugs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 3,
      "minItems": 1,
      "description": "1 to 3 business slugs from search_vendors"
    },
    "customer_name": {
      "type": "string",
      "description": "The user's name, if they gave it"
    },
    "customer_email": {
      "type": "string",
      "description": "The user's email, if they gave it"
    }
  }
}

{
  "title": "Prepare a quote request",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "vendor_slugs",
    "details",
    "customer_name",
    "customer_email"
  ],
  "properties": {
    "notes": {
      "type": "string"
    },
    "details": {
      "type": "object",
      "description": "Field values keyed by: date_window, time_window, area, home_size, job_details, frequency, session_goal, session_count, treatment, shoot_type, duration, people_count, load_size, budget",
      "additionalProperties": {
        "type": "string"
      }
    },
    "service": {
      "type": "string",
      "description": "Service category slug"
    },
    "vendor_slugs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 3,
      "minItems": 1
    },
    "customer_name": {
      "type": "string"
    },
    "customer_email": {
      "type": "string"
    },
    "customer_phone": {
      "type": "string"
    }
  }
}

{
  "title": "Send a quote request",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": true
}

ui://servana/vendor-cards.html

ui://servana/quote-request.html