io.github.QasperAI/qasper

Official10 toolsLive

by QasperAI · JavaScript

Discover and book businesses via AI agents.

A server that describes a model context protocol (MCP) implementation for discovering and booking businesses via AI agents. It provides a concise description and is suitable for catalog pages and developer exploration.

🛠️ Key Features

Name: io.github.QasperAI/qasper
Description: Discover and book businesses via AI agents.
Supports integration with AI-driven discovery and booking flows.
Lightweight metadata suitable for catalog indexing.

🚀 Use Cases

AI agents locating businesses by context and availability
Automated booking workflows guided by model context
Catalog-driven discovery for developer experiments

⚡ Developer Benefits

Clear, concise server description for documentation
Grounded data suitable for SEO-friendly catalog pages
Helpful for onboarding developers to MCP-related integrations

⚠️ Limitations

Data fields provided are minimal (name, description); deeper metadata may require additional source material

Captured live from the server via tools/list.

get_refinement_options

List the refinement dimensions (specializations, practice areas, service types, service modes, etc.) available for a specific subcategory. Call this BEFORE search_businesses when the user's request is broad (e.g. 'therapist in Greece', 'lawyer in London') so you can politely ask the user whether to narrow by any of these dimensions — and always offer them the option to see all results without filtering. Returns the attributes defined for the vertical with their possible option values, plus the universal serviceMode options. If refinementAvailable is false, skip refinement and go directly to search_businesses.

Parameters1

subCategory

string

required

The exact subcategory enum the user is asking about (e.g. 'Therapist', 'Plumber', 'Dentist'). Pick the most specific value from ProfessionalProfileSubCategory based on the user's words. Use 'None' only when the user's request truly does not name a profession.

Raw schema

{
  "type": "object",
  "properties": {
    "subCategory": {
      "description": "The exact subcategory enum the user is asking about (e.g. 'Therapist', 'Plumber', 'Dentist'). Pick the most specific value from ProfessionalProfileSubCategory based on the user's words. Use 'None' only when the user's request truly does not name a profession.",
      "type": "string",
      "enum": [
        "None",
        "Doctor",
        "Dentist",
        "Therapist",
        "Psychologist",
        "Psychiatrist",
        "Physiotherapist",
        "Nutritionist",
        "Optometrist",
        "Veterinarian",
        "Chiropractor",
        "Nurse",
        "Dermatologist",
        "Gynecologist",
        "Pediatrician",
        "Cardiologist",
        "Orthopedist",
        "Urologist",
        "Endocrinologist",
        "Neurologist",
        "Oncologist",
        "Ophthalmologist",
        "Rheumatologist",
        "Gastroenterologist",
        "Pulmonologist",
        "ENTSpecialist",
        "Radiologist",
        "Anesthesiologist",
        "Pathologist",
        "Surgeon",
        "PlasticSurgeon",
        "SpeechTherapist",
        "OccupationalTherapist",
        "Midwife",
        "Pharmacist",
        "Osteopath",
        "Podiatrist",
        "Dietitian",
        "Homeopath",
        "Acupuncturist",
        "PediatricClinic",
        "DentalClinic",
        "PhysicalTherapyClinic",
        "ChiropracticClinic",
        "PlasticSurgeryClinic",
        "MedicalWeightLossClinic",
        "HormoneTherapyClinic",
        "FunctionalMedicineClinic",
        "PediatricTherapyClinic",
        "AbaTherapyCenter",
        "HearingCenter",
        "AddictionTreatmentCenter",
        "InterventionalRadiologyClinic",
        "AnorectalCareClinic",
        "GeneralClinic",
        "SkilledNursingFacility",
        "Lawyer",
        "Notary",
        "FamilyLawyer",
        "CriminalLawyer",
        "CorporateLawyer",
        "ImmigrationLawyer",
        "RealEstateLawyer",
        "LaborLawyer",
        "IntellectualPropertyLawyer",
        "TaxLawyer",
        "Mediator",
        "PersonalInjuryLawyer",
        "Accountant",
        "FinancialAdvisor",
        "TaxConsultant",
        "InsuranceAgent",
        "MortgageBroker",
        "InvestmentAdvisor",
        "Auditor",
        "Bookkeeper",
        "WealthManager",
        "CryptoAdvisor",
        "Plumber",
        "Electrician",
        "Mechanic",
        "Carpenter",
        "Painter",
        "Locksmith",
        "Cleaner",
        "Gardener",
        "PestControl",
        "HvacTechnician",
        "InteriorDesigner",
        "Architect",
        "Roofer",
        "Tiler",
        "Plasterer",
        "WindowCleaner",
        "PoolMaintenance",
        "SecurityInstaller",
        "SolarInstaller",
        "Handyman",
        "Mover",
        "WasteRemoval",
        "CarRental",
        "PetTransport",
        "PetGroomer",
        "PetSitter",
        "DogWalker",
        "PetPhysiotherapist",
        "CanineHydrotherapist",
        "PetPhotographer",
        "HairSalon",
        "Barber",
        "NailTechnician",
        "MassageTherapist",
        "PersonalTrainer",
        "YogaInstructor",
        "TattooArtist",
        "MakeupArtist",
        "Aesthetician",
        "Eyebrow",
        "Eyelash",
        "WaxingSpecialist",
        "PermanentMakeup",
        "NailArtist",
        "BodyPiercer",
        "Trichologist",
        "SpaTherapist",
        "SunbedStudio",
        "MedSpa",
        "FitnessStudio",
        "HairStylist",
        "WellnessRecoveryClinic",
        "Tutor",
        "MusicTeacher",
        "LanguageTeacher",
        "DrivingInstructor",
        "LifeCoach",
        "MathTutor",
        "ScienceTutor",
        "ArtTeacher",
        "DanceInstructor",
        "SwimmingInstructor",
        "MartialArtsInstructor",
        "ChessCoach",
        "CodingInstructor",
        "ExamCoach",
        "CareerCoach",
        "SportsCoach",
        "ItSupport",
        "WebDeveloper",
        "Photographer",
        "Videographer",
        "GraphicDesigner",
        "SoftwareDeveloper",
        "MobileAppDeveloper",
        "DataAnalyst",
        "CyberSecurityConsultant",
        "SeoSpecialist",
        "SocialMediaManager",
        "ContentCreator",
        "UxDesigner",
        "DroneOperator",
        "VideoEditor",
        "SoundEngineer",
        "ThreeDDesigner",
        "AnimationArtist",
        "Consultant",
        "MarketingConsultant",
        "Translator",
        "BusinessCoach",
        "HrConsultant",
        "PrSpecialist",
        "CopyWriter",
        "VirtualAssistant",
        "ProjectManager",
        "SupplyChainConsultant",
        "BrandingConsultant",
        "SeniorLivingPlacementAgency",
        "EventPlanner",
        "WeddingPlanner",
        "Caterer",
        "Dj",
        "Chef",
        "PrivateChef",
        "BartenderMixologist",
        "Florist",
        "Entertainer",
        "PhotoboothRental",
        "TourOperator",
        "OnlineRetailer",
        "Artist",
        "FineArtPainter",
        "Illustrator",
        "PortraitArtist",
        "Muralist",
        "Printmaker",
        "Caricaturist",
        "Calligrapher"
      ]
    }
  },
  "required": [
    "subCategory"
  ]
}

find_next_available_appointments

Find the next available bookable appointment starts across matching local service businesses. Use this ONLY when the user explicitly asks for availability, booking, the soonest appointment, or a specific appointment time. Examples: 'book me a dentist', 'who has availability tomorrow?', 'find the soonest groomer appointment', 'get me a dermatologist next Wednesday'. Do NOT use this for generic discovery requests like 'find me a dentist in Paris' or 'show me pet groomers near me'; use search_businesses for discovery. The CALLER (you, the agent) extracts the structured search fields the same way as search_businesses, and passes the service or activity wording in serviceQuery. The response only includes businesses with direct booking support, a matching service, and at least one slot whose bookingStartPolicy and remainingCapacity allow booking. An empty result does NOT mean no matching businesses exist; it only means no directly bookable matching slots were indexed. If this returns no results, call search_businesses before responding to the user.

Parameters12

subCategory	string	required	Exact ProfessionalProfileSubCategory enum value derived from the user's request (e.g. 'EventPlanner', 'Dentist', 'Therapist'). Required.
serviceQuery	string	required	Service or activity wording from the user, e.g. 'boat trip', 'therapy session', 'haircut'.
startDate	string	required	First local date to search from (YYYY-MM-DD). Use today's date when the user asks for the next available option.
locationText	string \| null	optional	Place name as the user said it. Pass null only for remote or nationwide service searches.
countryCode	string \| null	optional	ISO-3166 alpha-2 country code (e.g. 'GR', 'US', 'GB'). Set when deducible.
latitude	number \| null	optional	Latitude of the search location. Pass when the client has a map viewport or GPS position.
longitude	number \| null	optional	Longitude of the search location. Pass alongside latitude.
radiusKm	number	optional	Search radius in kilometers, default 10.
serviceMode	string \| null	optional	Hard filter on how the business delivers service. One of: 'in_person', 'remote', 'service_area', 'nationwide'.
attributeFilters	string \| null	optional	Hard filter on vertical-specific attributes as a JSON object. Keys and values come from get_refinement_options.
daysToSearch	integer	optional	Number of calendar days to scan starting at startDate. Defaults to 14 and is clamped between 1 and 31.
resultLimit	integer	optional	Maximum number of available appointment matches to return. Defaults to 5 and is clamped between 1 and 20.

Raw schema

{
  "type": "object",
  "properties": {
    "subCategory": {
      "description": "Exact ProfessionalProfileSubCategory enum value derived from the user's request (e.g. 'EventPlanner', 'Dentist', 'Therapist'). Required.",
      "type": "string",
      "enum": [
        "None",
        "Doctor",
        "Dentist",
        "Therapist",
        "Psychologist",
        "Psychiatrist",
        "Physiotherapist",
        "Nutritionist",
        "Optometrist",
        "Veterinarian",
        "Chiropractor",
        "Nurse",
        "Dermatologist",
        "Gynecologist",
        "Pediatrician",
        "Cardiologist",
        "Orthopedist",
        "Urologist",
        "Endocrinologist",
        "Neurologist",
        "Oncologist",
        "Ophthalmologist",
        "Rheumatologist",
        "Gastroenterologist",
        "Pulmonologist",
        "ENTSpecialist",
        "Radiologist",
        "Anesthesiologist",
        "Pathologist",
        "Surgeon",
        "PlasticSurgeon",
        "SpeechTherapist",
        "OccupationalTherapist",
        "Midwife",
        "Pharmacist",
        "Osteopath",
        "Podiatrist",
        "Dietitian",
        "Homeopath",
        "Acupuncturist",
        "PediatricClinic",
        "DentalClinic",
        "PhysicalTherapyClinic",
        "ChiropracticClinic",
        "PlasticSurgeryClinic",
        "MedicalWeightLossClinic",
        "HormoneTherapyClinic",
        "FunctionalMedicineClinic",
        "PediatricTherapyClinic",
        "AbaTherapyCenter",
        "HearingCenter",
        "AddictionTreatmentCenter",
        "InterventionalRadiologyClinic",
        "AnorectalCareClinic",
        "GeneralClinic",
        "SkilledNursingFacility",
        "Lawyer",
        "Notary",
        "FamilyLawyer",
        "CriminalLawyer",
        "CorporateLawyer",
        "ImmigrationLawyer",
        "RealEstateLawyer",
        "LaborLawyer",
        "IntellectualPropertyLawyer",
        "TaxLawyer",
        "Mediator",
        "PersonalInjuryLawyer",
        "Accountant",
        "FinancialAdvisor",
        "TaxConsultant",
        "InsuranceAgent",
        "MortgageBroker",
        "InvestmentAdvisor",
        "Auditor",
        "Bookkeeper",
        "WealthManager",
        "CryptoAdvisor",
        "Plumber",
        "Electrician",
        "Mechanic",
        "Carpenter",
        "Painter",
        "Locksmith",
        "Cleaner",
        "Gardener",
        "PestControl",
        "HvacTechnician",
        "InteriorDesigner",
        "Architect",
        "Roofer",
        "Tiler",
        "Plasterer",
        "WindowCleaner",
        "PoolMaintenance",
        "SecurityInstaller",
        "SolarInstaller",
        "Handyman",
        "Mover",
        "WasteRemoval",
        "CarRental",
        "PetTransport",
        "PetGroomer",
        "PetSitter",
        "DogWalker",
        "PetPhysiotherapist",
        "CanineHydrotherapist",
        "PetPhotographer",
        "HairSalon",
        "Barber",
        "NailTechnician",
        "MassageTherapist",
        "PersonalTrainer",
        "YogaInstructor",
        "TattooArtist",
        "MakeupArtist",
        "Aesthetician",
        "Eyebrow",
        "Eyelash",
        "WaxingSpecialist",
        "PermanentMakeup",
        "NailArtist",
        "BodyPiercer",
        "Trichologist",
        "SpaTherapist",
        "SunbedStudio",
        "MedSpa",
        "FitnessStudio",
        "HairStylist",
        "WellnessRecoveryClinic",
        "Tutor",
        "MusicTeacher",
        "LanguageTeacher",
        "DrivingInstructor",
        "LifeCoach",
        "MathTutor",
        "ScienceTutor",
        "ArtTeacher",
        "DanceInstructor",
        "SwimmingInstructor",
        "MartialArtsInstructor",
        "ChessCoach",
        "CodingInstructor",
        "ExamCoach",
        "CareerCoach",
        "SportsCoach",
        "ItSupport",
        "WebDeveloper",
        "Photographer",
        "Videographer",
        "GraphicDesigner",
        "SoftwareDeveloper",
        "MobileAppDeveloper",
        "DataAnalyst",
        "CyberSecurityConsultant",
        "SeoSpecialist",
        "SocialMediaManager",
        "ContentCreator",
        "UxDesigner",
        "DroneOperator",
        "VideoEditor",
        "SoundEngineer",
        "ThreeDDesigner",
        "AnimationArtist",
        "Consultant",
        "MarketingConsultant",
        "Translator",
        "BusinessCoach",
        "HrConsultant",
        "PrSpecialist",
        "CopyWriter",
        "VirtualAssistant",
        "ProjectManager",
        "SupplyChainConsultant",
        "BrandingConsultant",
        "SeniorLivingPlacementAgency",
        "EventPlanner",
        "WeddingPlanner",
        "Caterer",
        "Dj",
        "Chef",
        "PrivateChef",
        "BartenderMixologist",
        "Florist",
        "Entertainer",
        "PhotoboothRental",
        "TourOperator",
        "OnlineRetailer",
        "Artist",
        "FineArtPainter",
        "Illustrator",
        "PortraitArtist",
        "Muralist",
        "Printmaker",
        "Caricaturist",
        "Calligrapher"
      ]
    },
    "serviceQuery": {
      "description": "Service or activity wording from the user, e.g. 'boat trip', 'therapy session', 'haircut'.",
      "type": "string"
    },
    "startDate": {
      "description": "First local date to search from (YYYY-MM-DD). Use today's date when the user asks for the next available option.",
      "type": "string"
    },
    "locationText": {
      "description": "Place name as the user said it. Pass null only for remote or nationwide service searches.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "countryCode": {
      "description": "ISO-3166 alpha-2 country code (e.g. 'GR', 'US', 'GB'). Set when deducible.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "latitude": {
      "description": "Latitude of the search location. Pass when the client has a map viewport or GPS position.",
      "type": [
        "number",
        "null"
      ],
      "default": null
    },
    "longitude": {
      "description": "Longitude of the search location. Pass alongside latitude.",
      "type": [
        "number",
        "null"
      ],
      "default": null
    },
    "radiusKm": {
      "description": "Search radius in kilometers, default 10.",
      "type": "number",
      "default": 10
    },
    "serviceMode": {
      "description": "Hard filter on how the business delivers service. One of: 'in_person', 'remote', 'service_area', 'nationwide'.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "attributeFilters": {
      "description": "Hard filter on vertical-specific attributes as a JSON object. Keys and values come from get_refinement_options.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "daysToSearch": {
      "description": "Number of calendar days to scan starting at startDate. Defaults to 14 and is clamped between 1 and 31.",
      "type": "integer",
      "default": 14
    },
    "resultLimit": {
      "description": "Maximum number of available appointment matches to return. Defaults to 5 and is clamped between 1 and 20.",
      "type": "integer",
      "default": 5
    }
  },
  "required": [
    "subCategory",
    "serviceQuery",
    "startDate"
  ]
}

book_appointment

Book an appointment with a local service business. Creates a booking record and adds the appointment to the business calendar. Returns a reference number and a status field indicating the actual resulting state — 'pending' (the business reviews each booking), 'confirmed' (auto-approved by the business), or 'completed' (the business auto-finalizes). Use a dateTime returned by check_availability for the selected service so bookingStartPolicy is respected. For services with maxParticipants > 1, the start can be booked until remainingCapacity reaches 0. Read the status and statusDescription verbatim and relay them accurately: do NOT tell the customer 'confirmed' when the status is 'pending'. If the selected service has requiresCustomerAddress=true, ask the customer for their full service address before calling this tool and pass it as customerAddress. ONLY call this if the business has 'booking' in its enabledFeatures array.

Parameters9

slug	string	required	The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.
serviceName	string	required	The name of the service to book
dateTime	string	required	Appointment start date and time in ISO 8601 format (e.g. '2026-04-07T14:00:00+03:00')
customerName	string	required	Full name of the customer
customerPhone	string	required	Customer phone number
customerEmail	string	required	Customer email address
jobDescription	string	required	Detailed description of the job or reason for appointment. Include any visual details about the issue — damage, location, severity, photos described in text form.
clientRequestId	string	required	REQUIRED. Stable UUID identifying this booking attempt. Generate ONCE at the moment you decide to book; reuse the SAME value on every retry of the same logical attempt so the server can dedup. A fresh value on retry will mint a duplicate calendar event.
customerAddress	string \| null	optional	Customer's full service address. Required when the selected service has requiresCustomerAddress=true; omit or leave blank for services that do not need an address.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.",
      "type": "string"
    },
    "serviceName": {
      "description": "The name of the service to book",
      "type": "string"
    },
    "dateTime": {
      "description": "Appointment start date and time in ISO 8601 format (e.g. '2026-04-07T14:00:00+03:00')",
      "type": "string"
    },
    "customerName": {
      "description": "Full name of the customer",
      "type": "string"
    },
    "customerPhone": {
      "description": "Customer phone number",
      "type": "string"
    },
    "customerEmail": {
      "description": "Customer email address",
      "type": "string"
    },
    "jobDescription": {
      "description": "Detailed description of the job or reason for appointment. Include any visual details about the issue — damage, location, severity, photos described in text form.",
      "type": "string"
    },
    "clientRequestId": {
      "description": "REQUIRED. Stable UUID identifying this booking attempt. Generate ONCE at the moment you decide to book; reuse the SAME value on every retry of the same logical attempt so the server can dedup. A fresh value on retry will mint a duplicate calendar event.",
      "type": "string"
    },
    "customerAddress": {
      "description": "Customer's full service address. Required when the selected service has requiresCustomerAddress=true; omit or leave blank for services that do not need an address.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "slug",
    "serviceName",
    "dateTime",
    "customerName",
    "customerPhone",
    "customerEmail",
    "jobDescription",
    "clientRequestId"
  ]
}

ask_business_agent

Ask one specific Qasper business agent through the same chat path as that business's public agent page. Use this only after selecting a business and copying its exact slug from search_businesses or get_business_info. The business agent can use its configured business tools for services, pricing, availability, bookings, and inquiries when appropriate.

Parameters3

slug	string	required	The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.
question	string	required	The customer's direct question or request for this specific business agent.
conversationId	string \| null	optional	Optional existing Qasper business-agent conversation id for audit grouping. Leave null for a new conversation.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.",
      "type": "string"
    },
    "question": {
      "description": "The customer's direct question or request for this specific business agent.",
      "type": "string"
    },
    "conversationId": {
      "description": "Optional existing Qasper business-agent conversation id for audit grouping. Leave null for a new conversation.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "slug",
    "question"
  ]
}

get_services

Get the service catalog for a local service business, including service names, descriptions, estimated durations, price ranges, max participants, booking start policy, and whether the customer's address is required to book. Always available for any business.

Parameters1

slug

string

required

The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

send_inquiry

Send a general inquiry to a local service business. Use this when the customer has a question, needs a custom quote, or wants to describe an issue that doesn't fit a specific bookable service. The business owner will be notified immediately via every enabled inquiry channel and will contact the customer directly. ONLY call this if the business has 'inquiry' or 'email_inquiry' in its enabledFeatures array.

Parameters6

slug	string	required	The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.
customerName	string	required	Full name of the person making the inquiry
customerPhone	string	required	Customer phone number
customerEmail	string	required	Customer email address
message	string	required	Detailed description of the inquiry, question, or issue. Include any visual details about damage, location, severity, and urgency.
clientRequestId	string	required	Required stable UUID for this inquiry attempt. Generate once and reuse on retries of the same logical attempt.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.",
      "type": "string"
    },
    "customerName": {
      "description": "Full name of the person making the inquiry",
      "type": "string"
    },
    "customerPhone": {
      "description": "Customer phone number",
      "type": "string"
    },
    "customerEmail": {
      "description": "Customer email address",
      "type": "string"
    },
    "message": {
      "description": "Detailed description of the inquiry, question, or issue. Include any visual details about damage, location, severity, and urgency.",
      "type": "string"
    },
    "clientRequestId": {
      "description": "Required stable UUID for this inquiry attempt. Generate once and reuse on retries of the same logical attempt.",
      "type": "string"
    }
  },
  "required": [
    "slug",
    "customerName",
    "customerPhone",
    "customerEmail",
    "message",
    "clientRequestId"
  ]
}

get_pricing

Get a price quote for a specific service from a local business. Takes into account emergency requests, weekend rates, and other pricing rules. Always available for any business.

Parameters4

slug	string	required	The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.
serviceName	string	required	The name of the service to get pricing for
isEmergency	boolean	optional	Whether this is an emergency/urgent request
requestedDate	string \| null	optional	The requested date (YYYY-MM-DD), used to determine weekend rates

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.",
      "type": "string"
    },
    "serviceName": {
      "description": "The name of the service to get pricing for",
      "type": "string"
    },
    "isEmergency": {
      "description": "Whether this is an emergency/urgent request",
      "type": "boolean",
      "default": false
    },
    "requestedDate": {
      "description": "The requested date (YYYY-MM-DD), used to determine weekend rates",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "slug",
    "serviceName"
  ]
}

search_businesses

Search for local service businesses by structured fields. Use this as the FIRST discovery tool for requests such as 'find me a dentist in Paris', 'show me groomers near me', 'recommend a dermatologist', or 'I need a plumber'. This returns businesses even when they do not support direct booking. Do NOT skip this tool just because the user mentions a professional category; availability search is only for explicit booking, availability, soonest-slot, or specific appointment-time requests. The CALLER (you, the agent) is responsible for extracting subCategory, locationText, and countryCode from the user's request — pick the most specific subCategory enum, pass the user's place wording in locationText, and infer countryCode when deducible. The server handles SQL filtering, geocoding, ranking, and bucketing. IMPORTANT: If the user's request is broad (e.g. 'therapist in Greece', 'lawyer in London') and they haven't named a specific specialization or service mode, call get_refinement_options FIRST with the subCategory, ask the user what to narrow by, then call this tool with the answer in attributeFilters and/or serviceMode. Skip that step when the user already named specifics or explicitly asked to see everything. Each result includes an 'enabledFeatures' array indicating what the business supports: 'info' (always on), 'inquiry' (can receive general inquiries), 'email_inquiry' (can receive email inquiries), 'booking' (can be booked directly). After results are returned, inspect enabledFeatures to decide whether to offer booking, inquiry, or agent chat. Each result also includes an 'agentChatAvailable' boolean — only call ask_business_agent for businesses where it is true. Use 'attributeDetails' (natural-language sentences about each business's offerings, approach, and specialties) to reason about fit for the user. The 'cardChips', 'cardChipGroups', and 'matchedFilterValues' fields are UI-only display data — ignore them. Each result also includes the exact slug to reuse verbatim in later tool calls. Pass latitude/longitude only when the client has an explicit map viewport or GPS position that should override the coordinates geocoded from locationText.

Parameters9

subCategory	string	required	Exact ProfessionalProfileSubCategory enum value derived from the user's request (e.g. 'Therapist', 'Plumber', 'Dentist'). Required. Use 'None' only if the user truly hasn't named a profession — in that case the server refuses with a clarification response, and you should ask the user instead of guessing.
locationText	string \| null	optional	Place name as the user said it, in their language. Examples: 'Athens', 'Greece', 'Πεκίνο', 'New York City'. Pass null when the user did not name a location.
countryCode	string \| null	optional	ISO-3166 alpha-2 country code (e.g. 'GR', 'US', 'GB'). Set when deducible from locationText or context, even if locationText is just a city — the server uses it to short-circuit geocoding for country-scope queries.
latitude	number \| null	optional	Latitude of the search location. Pass when the client has a map viewport or GPS position that should override coordinates geocoded from locationText.
longitude	number \| null	optional	Longitude of the search location. Pass alongside latitude.
radiusKm	number	optional	Search radius in kilometers, default 10.
serviceMode	string \| null	optional	Hard filter on how the business delivers service. One of: 'in_person', 'remote', 'service_area', 'nationwide'. Only profiles matching the mode are returned. Leave null when the user has no preference.
attributeFilters	string \| null	optional	Hard filter on vertical-specific attributes as a JSON object. Keys and option values come from get_refinement_options. Example: '{"specializations":["trauma_ptsd"],"approaches":["emdr"]}'. Multiple values within a key are ALL required (AND). Multiple keys are ALL required (AND). Leave null when the user has no preference.
resultLimit	integer	optional	Maximum number of businesses to return. Defaults to 5 and is clamped between 1 and 20.

Raw schema

{
  "type": "object",
  "properties": {
    "subCategory": {
      "description": "Exact ProfessionalProfileSubCategory enum value derived from the user's request (e.g. 'Therapist', 'Plumber', 'Dentist'). Required. Use 'None' only if the user truly hasn't named a profession — in that case the server refuses with a clarification response, and you should ask the user instead of guessing.",
      "type": "string",
      "enum": [
        "None",
        "Doctor",
        "Dentist",
        "Therapist",
        "Psychologist",
        "Psychiatrist",
        "Physiotherapist",
        "Nutritionist",
        "Optometrist",
        "Veterinarian",
        "Chiropractor",
        "Nurse",
        "Dermatologist",
        "Gynecologist",
        "Pediatrician",
        "Cardiologist",
        "Orthopedist",
        "Urologist",
        "Endocrinologist",
        "Neurologist",
        "Oncologist",
        "Ophthalmologist",
        "Rheumatologist",
        "Gastroenterologist",
        "Pulmonologist",
        "ENTSpecialist",
        "Radiologist",
        "Anesthesiologist",
        "Pathologist",
        "Surgeon",
        "PlasticSurgeon",
        "SpeechTherapist",
        "OccupationalTherapist",
        "Midwife",
        "Pharmacist",
        "Osteopath",
        "Podiatrist",
        "Dietitian",
        "Homeopath",
        "Acupuncturist",
        "PediatricClinic",
        "DentalClinic",
        "PhysicalTherapyClinic",
        "ChiropracticClinic",
        "PlasticSurgeryClinic",
        "MedicalWeightLossClinic",
        "HormoneTherapyClinic",
        "FunctionalMedicineClinic",
        "PediatricTherapyClinic",
        "AbaTherapyCenter",
        "HearingCenter",
        "AddictionTreatmentCenter",
        "InterventionalRadiologyClinic",
        "AnorectalCareClinic",
        "GeneralClinic",
        "SkilledNursingFacility",
        "Lawyer",
        "Notary",
        "FamilyLawyer",
        "CriminalLawyer",
        "CorporateLawyer",
        "ImmigrationLawyer",
        "RealEstateLawyer",
        "LaborLawyer",
        "IntellectualPropertyLawyer",
        "TaxLawyer",
        "Mediator",
        "PersonalInjuryLawyer",
        "Accountant",
        "FinancialAdvisor",
        "TaxConsultant",
        "InsuranceAgent",
        "MortgageBroker",
        "InvestmentAdvisor",
        "Auditor",
        "Bookkeeper",
        "WealthManager",
        "CryptoAdvisor",
        "Plumber",
        "Electrician",
        "Mechanic",
        "Carpenter",
        "Painter",
        "Locksmith",
        "Cleaner",
        "Gardener",
        "PestControl",
        "HvacTechnician",
        "InteriorDesigner",
        "Architect",
        "Roofer",
        "Tiler",
        "Plasterer",
        "WindowCleaner",
        "PoolMaintenance",
        "SecurityInstaller",
        "SolarInstaller",
        "Handyman",
        "Mover",
        "WasteRemoval",
        "CarRental",
        "PetTransport",
        "PetGroomer",
        "PetSitter",
        "DogWalker",
        "PetPhysiotherapist",
        "CanineHydrotherapist",
        "PetPhotographer",
        "HairSalon",
        "Barber",
        "NailTechnician",
        "MassageTherapist",
        "PersonalTrainer",
        "YogaInstructor",
        "TattooArtist",
        "MakeupArtist",
        "Aesthetician",
        "Eyebrow",
        "Eyelash",
        "WaxingSpecialist",
        "PermanentMakeup",
        "NailArtist",
        "BodyPiercer",
        "Trichologist",
        "SpaTherapist",
        "SunbedStudio",
        "MedSpa",
        "FitnessStudio",
        "HairStylist",
        "WellnessRecoveryClinic",
        "Tutor",
        "MusicTeacher",
        "LanguageTeacher",
        "DrivingInstructor",
        "LifeCoach",
        "MathTutor",
        "ScienceTutor",
        "ArtTeacher",
        "DanceInstructor",
        "SwimmingInstructor",
        "MartialArtsInstructor",
        "ChessCoach",
        "CodingInstructor",
        "ExamCoach",
        "CareerCoach",
        "SportsCoach",
        "ItSupport",
        "WebDeveloper",
        "Photographer",
        "Videographer",
        "GraphicDesigner",
        "SoftwareDeveloper",
        "MobileAppDeveloper",
        "DataAnalyst",
        "CyberSecurityConsultant",
        "SeoSpecialist",
        "SocialMediaManager",
        "ContentCreator",
        "UxDesigner",
        "DroneOperator",
        "VideoEditor",
        "SoundEngineer",
        "ThreeDDesigner",
        "AnimationArtist",
        "Consultant",
        "MarketingConsultant",
        "Translator",
        "BusinessCoach",
        "HrConsultant",
        "PrSpecialist",
        "CopyWriter",
        "VirtualAssistant",
        "ProjectManager",
        "SupplyChainConsultant",
        "BrandingConsultant",
        "SeniorLivingPlacementAgency",
        "EventPlanner",
        "WeddingPlanner",
        "Caterer",
        "Dj",
        "Chef",
        "PrivateChef",
        "BartenderMixologist",
        "Florist",
        "Entertainer",
        "PhotoboothRental",
        "TourOperator",
        "OnlineRetailer",
        "Artist",
        "FineArtPainter",
        "Illustrator",
        "PortraitArtist",
        "Muralist",
        "Printmaker",
        "Caricaturist",
        "Calligrapher"
      ]
    },
    "locationText": {
      "description": "Place name as the user said it, in their language. Examples: 'Athens', 'Greece', 'Πεκίνο', 'New York City'. Pass null when the user did not name a location.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "countryCode": {
      "description": "ISO-3166 alpha-2 country code (e.g. 'GR', 'US', 'GB'). Set when deducible from locationText or context, even if locationText is just a city — the server uses it to short-circuit geocoding for country-scope queries.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "latitude": {
      "description": "Latitude of the search location. Pass when the client has a map viewport or GPS position that should override coordinates geocoded from locationText.",
      "type": [
        "number",
        "null"
      ],
      "default": null
    },
    "longitude": {
      "description": "Longitude of the search location. Pass alongside latitude.",
      "type": [
        "number",
        "null"
      ],
      "default": null
    },
    "radiusKm": {
      "description": "Search radius in kilometers, default 10.",
      "type": "number",
      "default": 10
    },
    "serviceMode": {
      "description": "Hard filter on how the business delivers service. One of: 'in_person', 'remote', 'service_area', 'nationwide'. Only profiles matching the mode are returned. Leave null when the user has no preference.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "attributeFilters": {
      "description": "Hard filter on vertical-specific attributes as a JSON object. Keys and option values come from get_refinement_options. Example: '{\"specializations\":[\"trauma_ptsd\"],\"approaches\":[\"emdr\"]}'. Multiple values within a key are ALL required (AND). Multiple keys are ALL required (AND). Leave null when the user has no preference.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "resultLimit": {
      "description": "Maximum number of businesses to return. Defaults to 5 and is clamped between 1 and 20.",
      "type": "integer",
      "default": 5
    }
  },
  "required": [
    "subCategory"
  ]
}

check_availability

Check available appointment slots for a specific service at a local business on a given date. Returns time windows when the business is free and the service bookingStartPolicy permits the start. For services with maxParticipants > 1, provider-returned starts remain available until capacity is full. ONLY call this if the business has 'booking' in its enabledFeatures array. If the business doesn't support booking, share their contact info from get_business_info instead.

Parameters3

slug	string	required	The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.
date	string	required	The date to check availability for (YYYY-MM-DD format, e.g. '2026-04-07')
serviceName	string	required	The name of the service to check availability for

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The exact URL slug returned by search_businesses or get_business_info. Copy it verbatim.",
      "type": "string"
    },
    "date": {
      "description": "The date to check availability for (YYYY-MM-DD format, e.g. '2026-04-07')",
      "type": "string"
    },
    "serviceName": {
      "description": "The name of the service to check availability for",
      "type": "string"
    }
  },
  "required": [
    "slug",
    "date",
    "serviceName"
  ]
}

get_business_info

Get business information including name, type, service area, contact details, working hours, supported languages, enabled features, and a profile image (logo or personal photo) when the owner has uploaded one. Use 'attributeDetails' (natural-language sentences about the business's offerings, approach, and specialties) to reason about fit for the user. The 'cardChips' and 'cardChipGroups' fields are UI-only display data — ignore them. The response echoes the exact slug; reuse it verbatim in later tool calls. Always available for any business.

Parameters1

slug

string

required

The exact URL slug returned by search_businesses (e.g. 'nikos-plumbing-a3f2'). Copy it verbatim.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The exact URL slug returned by search_businesses (e.g. 'nikos-plumbing-a3f2'). Copy it verbatim.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Install

Tools (10)

get_refinement_optionsfind_next_available_appointmentsbook_appointmentask_business_agentget_servicessend_inquiryget_pricingsearch_businesses

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "qasper": {
      "command": "npx",
      "args": [
        "-y",
        "@qasperai/mcp-server@1.0.6"
      ]
    }
  }
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_refinement_options

find_next_available_appointments

book_appointment

ask_business_agent

get_services

send_inquiry

get_pricing

search_businesses

check_availability

get_business_info

Install

Related servers