Book It MCP

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "trade",
    "zip"
  ],
  "properties": {
    "zip": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "The 5-digit US ZIP code where the work is."
    },
    "need": {
      "type": "string",
      "maxLength": 300,
      "description": "What the person needs in a few words, such as \"furnace blowing cold air\". Used to surface matching services."
    },
    "trade": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2,
      "description": "The trade or a common name for it: \"hvac\", \"furnace repair\", \"plumber\", \"roofer\", \"lawn care\", \"tree service\"."
    }
  }
}

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

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "business_id"
  ],
  "properties": {
    "business_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 3,
      "description": "The business_id exactly as find_provider returned it, such as \"juniper-ridge-roofing\"."
    }
  }
}

{
  "title": "Get a business's services",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "business_id"
  ],
  "properties": {
    "service": {
      "type": "string",
      "maxLength": 80,
      "description": "Instead of service_id, the service name as the business lists it, such as \"Furnace repair\"."
    },
    "service_id": {
      "type": "string",
      "maxLength": 40,
      "description": "The service_id from get_services or find_provider."
    },
    "business_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 3,
      "description": "The business_id exactly as find_provider returned it, such as \"juniper-ridge-roofing\"."
    }
  }
}

{
  "title": "Get a business's price range",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "business_id"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 14,
      "minimum": 1,
      "description": "How many days to show, 1 to 14. Defaults to 7."
    },
    "from_date": {
      "type": "string",
      "maxLength": 10,
      "description": "First date to show, YYYY-MM-DD, in the business's time zone. Defaults to today there."
    },
    "business_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 3,
      "description": "The business_id exactly as find_provider returned it, such as \"juniper-ridge-roofing\"."
    }
  }
}

{
  "title": "Check request windows",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "business_id",
    "customer_name",
    "customer_phone",
    "customer_zip",
    "need",
    "consent_confirmed"
  ],
  "properties": {
    "need": {
      "type": "string",
      "maxLength": 600,
      "minLength": 5,
      "description": "What the person needs, in their words, such as \"Furnace runs but blows cold air.\""
    },
    "service_id": {
      "type": "string",
      "maxLength": 40,
      "description": "Optional service_id from get_services."
    },
    "business_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 3,
      "description": "The business_id exactly as find_provider returned it, such as \"juniper-ridge-roofing\"."
    },
    "customer_zip": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "The 5-digit ZIP where the work is. It must be in the business's service area."
    },
    "customer_name": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2,
      "description": "The person's name, at least a first name."
    },
    "customer_phone": {
      "type": "string",
      "maxLength": 25,
      "minLength": 10,
      "description": "A US or Canadian phone number the business can call or text, such as (406) 555-0123."
    },
    "consent_confirmed": {
      "type": "boolean",
      "description": "True only after the person read the business's booking_consent_text and agreed to it."
    },
    "preferred_time_note": {
      "type": "string",
      "maxLength": 120,
      "description": "A short preferred time in words, such as \"any weekday morning\", when no window fits."
    },
    "preferred_window_id": {
      "type": "string",
      "maxLength": 40,
      "description": "A window_id from check_availability, such as \"2026-10-15@08:00-12:00\"."
    }
  }
}

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