catchaset

Find upcoming live-music events in a supported city (Austin or Chicago), filtered by free-text query, date range, and/or genre. Returns taste-neutral event records with source attribution, ticket links, and a freshness timestamp — the same public data catchaset.live shows signed-out visitors. Does NOT rank by personal taste. Results are capped per call; page with the returned next_cursor.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "Austin",
        "Chicago"
      ],
      "default": "Austin",
      "description": "City to search. Only Austin and Chicago are supported; any other value returns an unsupported_city note and defaults to Austin."
    },
    "query": {
      "type": "string",
      "description": "Optional free-text filter matched (case-insensitive substring) against headliner, artists, venue, and genre."
    },
    "date_from": {
      "type": "string",
      "description": "Optional inclusive lower bound, ISO date YYYY-MM-DD."
    },
    "date_to": {
      "type": "string",
      "description": "Optional inclusive upper bound, ISO date YYYY-MM-DD."
    },
    "genre": {
      "type": "string",
      "description": "Optional genre substring filter."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 100,
      "description": "Max events to return (1-100)."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque pagination cursor from a previous response's next_cursor."
    }
  },
  "additionalProperties": false
}

Given a list of artists the user likes, find upcoming shows in a supported city (Austin or Chicago) where one of those artists is on the bill, ranked (most matches first, then soonest). Taste is a PARAMETER — no account or login needed. Each result includes why_matched (which of the user's artists plays). This is direct-artist matching; genre-based discovery of *similar* artists is available in the CatchaSet web app, not here.

{
  "type": "object",
  "properties": {
    "artists": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Names of acts the user likes. Required — this is the taste to match."
    },
    "city": {
      "type": "string",
      "enum": [
        "Austin",
        "Chicago"
      ],
      "default": "Austin",
      "description": "City to search. Only Austin and Chicago are supported; other values default to Austin with an unsupported_city note."
    },
    "date_from": {
      "type": "string",
      "description": "Optional inclusive lower bound, ISO date YYYY-MM-DD."
    },
    "date_to": {
      "type": "string",
      "description": "Optional inclusive upper bound, ISO date YYYY-MM-DD."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 100,
      "description": "Max shows to return (1-100)."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque pagination cursor from a previous response's next_cursor."
    }
  },
  "required": [
    "artists"
  ],
  "additionalProperties": false
}

Operational state of the CatchaSet event feed: per-city event counts, data sources, last-refresh time, staleness, and coverage. No input. Call this to check health/coverage before relying on find_events.

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