Bezal Local Commerce MCP · Bezal

{
  "name": "search_businesses",
  "description": "Search local business profiles on Bezal by name, category, or location. Every business includes name, category, city, state, rating, review count, tier and quote_request_url (its public Bezal profile, where a person can send a request). Phone, website, address, hours, photos and coordinates are included only for providers on a paid Bezal plan, and the description only for providers on a higher paid plan.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "query": {
        "description": "Free-text search across business name and description",
        "type": "string",
        "maxLength": 200
      },
      "category": {
        "description": "Category keyword (e.g. \"plumbing\", \"hr consulting\")",
        "type": "string",
        "maxLength": 100
      },
      "city": {
        "description": "City name",
        "type": "string",
        "maxLength": 100
      },
      "state": {
        "description": "Two-letter state code or full state name",
        "type": "string",
        "maxLength": 40
      },
      "limit": {
        "default": 5,
        "description": "Number of results to return (1-20)",
        "type": "number",
        "minimum": 1,
        "maximum": 20
      }
    }
  }
}

{
  "name": "get_business",
  "description": "Get the public Bezal profile for one business by UUID. Every business includes name, category, city, state, rating, review count, tier and quote_request_url (its public Bezal profile, where a person can send a request). Phone, website, address, hours, photos and coordinates are included only for providers on a paid Bezal plan, and the description only for providers on a higher paid plan. For services, use get_service_catalog.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
        "description": "The UUID of the business to look up"
      }
    },
    "required": [
      "id"
    ]
  }
}

{
  "name": "list_categories",
  "description": "List all available business categories in the directory.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "name": "search_by_service",
  "description": "Find businesses that list a specific service, when you know the exact service rather than the category (for example \"Drain cleaning\" rather than \"plumbing\"). Every business includes name, category, city, state, rating, review count, tier and quote_request_url (its public Bezal profile, where a person can send a request). Phone, website, address, hours, photos and coordinates are included only for providers on a paid Bezal plan, and the description only for providers on a higher paid plan.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "service_type": {
        "type": "string",
        "maxLength": 100,
        "description": "Exact service offered (matched against the services list)"
      },
      "location": {
        "description": "Optional city or state to filter by",
        "type": "string",
        "maxLength": 100
      }
    },
    "required": [
      "service_type"
    ]
  }
}

{
  "name": "get_reviews",
  "description": "Get reviews for a specific business: Bezal reviews (rating, text, verified flag, date and the reviewer as first name and last initial) plus the Google rating and review count.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "business_id": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
        "description": "Business UUID"
      },
      "limit": {
        "description": "Max reviews to return",
        "default": 10,
        "type": "number",
        "minimum": 1,
        "maximum": 50
      }
    },
    "required": [
      "business_id"
    ]
  }
}

{
  "name": "get_service_catalog",
  "description": "Get services and pricing for a specific business. Falls back to the list of service names if no priced catalog exists.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "business_id": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
        "description": "Business UUID"
      }
    },
    "required": [
      "business_id"
    ]
  }
}

{
  "name": "check_business_availability",
  "description": "Check whether a business is open on a date, based on its posted opening hours. Hours are shared only for providers on a paid Bezal plan, and other listings come back with open set to \"unknown\". It doesn't know about bookings, so confirm a time with the business.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "business_id": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
        "description": "Business UUID"
      },
      "date": {
        "type": "string",
        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
        "description": "ISO date (YYYY-MM-DD)"
      }
    },
    "required": [
      "business_id",
      "date"
    ]
  }
}

{
  "name": "compare_businesses",
  "description": "Compare up to 5 businesses side by side: the public profile fields plus services, BezalRank and whether the profile is claimed. Every business includes name, category, city, state, rating, review count, tier and quote_request_url (its public Bezal profile, where a person can send a request). Phone, website, address, hours, photos and coordinates are included only for providers on a paid Bezal plan, and the description only for providers on a higher paid plan.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "business_ids": {
        "minItems": 1,
        "maxItems": 5,
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "description": "Array of business UUIDs to compare"
      }
    },
    "required": [
      "business_ids"
    ]
  }
}

{
  "name": "search_by_city",
  "description": "Search for businesses in a specific city, optionally filtered by category. Every business includes name, category, city, state, rating, review count, tier and quote_request_url (its public Bezal profile, where a person can send a request). Phone, website, address, hours, photos and coordinates are included only for providers on a paid Bezal plan, and the description only for providers on a higher paid plan.",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "city": {
        "type": "string",
        "maxLength": 100,
        "description": "City name"
      },
      "state": {
        "description": "Two-letter state code or full name",
        "type": "string",
        "maxLength": 40
      },
      "category": {
        "description": "Category keyword filter",
        "type": "string",
        "maxLength": 100
      },
      "limit": {
        "description": "Max results",
        "default": 10,
        "type": "number",
        "minimum": 1,
        "maximum": 20
      }
    },
    "required": [
      "city"
    ]
  }
}