# Houston Events

Houston Events is a free directory of Greater Houston, Galveston and College Station events (AI/tech, dance, music, arts, fitness, community) at https://houston.whatsupin.ai

- Data file (all upcoming events, CC BY 4.0): https://houston.whatsupin.ai/data/events.json
- MCP endpoint (read-only, POST JSON-RPC): https://houston.whatsupin.ai/mcp
- Location search (search_events, list_upcoming): neighborhood = events in a neighborhood or town by name; near = events within radius_km of a neighborhood, town, venue name or "lat,lon" (results carry distance_km). Events at unmapped venues can't be placed; the response's place.unplaced_events counts them
- Agent setup guide: https://houston.whatsupin.ai/agents/
- Each event has an original-listing link (link), a stable id, and first_seen / last_seen / last_fetched dates (fs / ls / ft in the data file)
- API spec (OpenAPI): https://houston.whatsupin.ai/openapi.json ; event schema: https://houston.whatsupin.ai/data/event.schema.json ; changelog: https://houston.whatsupin.ai/changelog/
- Coverage, freshness and accuracy numbers: https://houston.whatsupin.ai/coverage/ (data: https://houston.whatsupin.ai/data/coverage.json)
- Service status: https://houston.whatsupin.ai/status/ (JSON: https://houston.whatsupin.ai/api/status)
- Terms (AI agents may use the data with attribution): https://houston.whatsupin.ai/terms/
- Contact / takedowns: admin@whatsupin.ai