# Cartelera
> Live event discovery and ticketing for comedy, music, and theater venues.
> Find shows, buy tickets, discover venues -- powered by open data.

## API
Base URL: https://lacartelera.app
Docs: https://lacartelera.app/docs
Version: 0.1.0

## Endpoints
- GET /v1/venues — List venues (filter by city, zone, category)
- GET /v1/venues/geojson — GeoJSON FeatureCollection for maps
- GET /v1/venues/{slug} — Venue detail + upcoming events
- POST /v1/venues — Create venue
- GET /v1/events — List events (filter by date, category, venue)
- GET /v1/events/upcoming — Next 30 days
- GET /v1/events/{slug} — Event detail
- POST /v1/events — Create event
- POST /v1/tickets — Buy ticket (returns ticket_code)
- GET /v1/tickets/{code} — Verify ticket
- POST /v1/tickets/{code}/checkin — Check in
- POST /v1/rsvp — RSVP to free event
- GET /v1/rsvp/{event_id} — List RSVPs
- GET /v1/cartelera — Billboard (upcoming events)
- GET /v1/cartelera/{city} — Billboard by city

## MCP
This service exposes an MCP server for AI agent integration.
Tools: cartelera_search_events, cartelera_search_venues, cartelera_buy_ticket