Manchester Tonight

List regular nights out and one-off events in Manchester, UK on a given date: pub quizzes, comedy, open mics, live music, club nights, drag and happy hours. Use for questions like "what's on tonight in Manchester", "comedy in the Northern Quarter on Saturday" or "quiz in Didsbury tomorrow". Each result has a time, venue, area, notes and a link to cite.

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "today (default), tonight, tomorrow, a weekday name like saturday, YYYY-MM-DD or DD/MM/YYYY. Uses UK time, and before 4am \"tonight\" still means the night before."
    },
    "area": {
      "type": "string",
      "description": "Optional area: city-centre, northern-quarter, south-manchester, didsbury, west-didsbury, chorlton, stockport, salford, further-out, or a neighbourhood name such as Ancoats, Castlefield, Levenshulme or Heaton Moor."
    },
    "type": {
      "type": "string",
      "description": "Optional type: pub-quizzes, comedy-nights, open-mics, live-music, club-nights, drag or happy-hours. Plain words like \"quiz\" or \"comedy\" work too."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum results (default 30)."
    }
  }
}

Search all regular nights out in Manchester by keyword, area, type and day of the week. Use for questions like "free comedy in Manchester", "which pubs in Stockport have a quiz" or "open mics on Mondays". Results include the day rule (e.g. "Every Tuesday", "1st Thursday of the month").

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional keywords matched against venue, area, type and notes, e.g. \"free\", \"jazz\", \"SpeedQuizzing\"."
    },
    "area": {
      "type": "string",
      "description": "Optional area: city-centre, northern-quarter, south-manchester, didsbury, west-didsbury, chorlton, stockport, salford, further-out, or a neighbourhood name such as Ancoats, Castlefield, Levenshulme or Heaton Moor."
    },
    "type": {
      "type": "string",
      "description": "Optional type: pub-quizzes, comedy-nights, open-mics, live-music, club-nights, drag or happy-hours. Plain words like \"quiz\" or \"comedy\" work too."
    },
    "day": {
      "type": "string",
      "description": "Optional day of the week, e.g. monday."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum results (default 40)."
    }
  }
}

List upcoming dated seasonal events in Manchester, such as Halloween parties and club nights, or Christmas markets, light trails, panto and concerts. Use for questions like "Halloween in Manchester", "Christmas markets dates" or "festive things to do in Manchester". Each result has dates, times, prices and a ticket link.

{
  "type": "object",
  "properties": {
    "season": {
      "type": "string",
      "description": "Optional: halloween, bonfire, christmas or new-years-eve. Leave out to get every upcoming seasonal event."
    }
  }
}

Get every regular night at one Manchester venue, with times, address if known, sources and when it was last checked.

{
  "type": "object",
  "properties": {
    "venue": {
      "type": "string",
      "description": "Venue name, e.g. \"Frog & Bucket\" or \"The Chorlton Tap\"."
    }
  },
  "required": [
    "venue"
  ]
}

Turn a night out you have planned with someone (or a few days out) into a Manchester Tonight plan: a link that opens the plan on manchestertonight.co.uk, where they can change it and send it to friends on WhatsApp, plus the message text. Find the stops first with whats_on or search_listings. Listed venues get their area and page filled in, and a stop with no time gets the start time of the night on at that venue that day. The first stop each day is where everyone meets. Give the plan an intro and each stop a blurb, written to the person's friends: what you'll do there, why it's a good pick, and anything to book, bring or know (opening times, dietary notes, tickets). Returns a short link that previews as a card with the plan's name, a full message and a short one; offer whichever suits (the short one or just the link is best for a group chat). The plan is kept only to serve that link, until a month after its last day.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Optional name, e.g. \"Sam's birthday\". Default \"Night out\"."
    },
    "intro": {
      "type": "string",
      "maxLength": 600,
      "description": "Optional few sentences to everyone about the plan, e.g. \"Birthday week! Rough plan below, come to whatever you can.\""
    },
    "date": {
      "type": "string",
      "description": "The night, or the first day: tonight, tomorrow, a weekday name, YYYY-MM-DD or DD/MM/YYYY (UK time)."
    },
    "end_date": {
      "type": "string",
      "description": "Optional last day, for a plan over several days (up to 14), in the same formats."
    },
    "stops": {
      "type": "array",
      "minItems": 1,
      "maxItems": 30,
      "description": "The stops in order. On a plan over several days, give each stop its day.",
      "items": {
        "type": "object",
        "properties": {
          "place": {
            "type": "string",
            "description": "Venue or place name, e.g. \"Frog & Bucket\". Places that aren't listed are fine."
          },
          "day": {
            "type": "string",
            "description": "Which day, for a plan over several days: a date or weekday name within the dates."
          },
          "time": {
            "type": "string",
            "description": "Optional time, e.g. 19:30 or 7:30pm."
          },
          "what": {
            "type": "string",
            "description": "Optional: what they are doing there, e.g. \"Pub quiz\" or \"Dinner\"."
          },
          "cost": {
            "type": "string",
            "description": "Optional cost per person as text, e.g. \"£5\" or \"Free\"."
          },
          "blurb": {
            "type": "string",
            "maxLength": 400,
            "description": "A sentence or two for friends about this stop: what you'll do, why it's a good pick, anything to book, bring or know."
          },
          "note": {
            "type": "string",
            "description": "Older name for blurb; use blurb."
          }
        },
        "required": [
          "place"
        ]
      }
    }
  },
  "required": [
    "date",
    "stops"
  ]
}