server

Search for local businesses listed on HeySpark. Filter by keyword, category, city/state, or geographic coordinates. Returns a list of matching businesses with name, category, location, rating, and contact info. Premium-tier businesses appear first in results.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search keyword (e.g., 'pizza', 'emergency plumber', 'hair salon')"
    },
    "category": {
      "type": "string",
      "enum": [
        "restaurant",
        "salon",
        "barbershop",
        "dental",
        "medical",
        "veterinary",
        "plumber",
        "electrician",
        "hvac",
        "contractor",
        "landscaping",
        "auto_repair",
        "auto_body",
        "tire_shop",
        "law_firm",
        "accounting",
        "real_estate",
        "insurance",
        "retail",
        "fitness",
        "spa",
        "pet_grooming",
        "cleaning",
        "moving",
        "photography",
        "catering",
        "bakery",
        "coffee_shop",
        "bar",
        "brewery",
        "other"
      ],
      "description": "Business category filter"
    },
    "city": {
      "type": "string",
      "description": "City name (e.g., 'Asheville')"
    },
    "state": {
      "type": "string",
      "description": "State code (e.g., 'NC')"
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude for location-based search"
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude for location-based search"
    },
    "radius_miles": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 50,
      "description": "Search radius in miles (max 50). Requires latitude/longitude."
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (default 10, max 50)"
    },
    "offset": {
      "type": "number",
      "minimum": 0,
      "description": "Pagination offset (default 0)"
    }
  }
}

Get complete details for a specific HeySpark-listed business including address, hours, services, reviews summary, and contact information. Premium businesses include photos and special offers.

{
  "type": "object",
  "properties": {
    "business_id": {
      "type": "string",
      "description": "Business ID (UUID format)"
    },
    "slug": {
      "type": "string",
      "description": "Business URL slug (e.g., 'bellas-kitchen-asheville')"
    }
  }
}

Get a reviews summary for a HeySpark-listed business. Shows overall rating, review count, and review highlights (Premium tier only).

{
  "type": "object",
  "properties": {
    "business_id": {
      "type": "string",
      "description": "Business ID to get reviews for"
    }
  },
  "required": [
    "business_id"
  ]
}

List all available business categories on HeySpark with the number of active businesses in each.

{
  "type": "object",
  "properties": {}
}