AddyLife API

AddyLife answers a question about live events with a short ranked list, then links tickets for the ones worth the trip. These endpoints are public and return JSON. The machine-readable description is openapi.json. The catalog is /.well-known/api-catalog.

Search events

GET /api/search-global-events or POST /api/search-global-events with a JSON body. Only current and upcoming events are indexed. A 503 means the index is unavailable. Retry it. An empty list is a real miss.

GET /api/search-global-events?query=jazz&city=New%20Orleans&domain=music

Query fields: query, city, country, domain (all, sports, music, festivals, geo), lat, lng, radius_km, date_start, date_end (YYYY-MM-DD), limit, and offset. Each hit includes name, place, startDate, coordinates, and ticketsUrl when one exists.

Index stats

GET /api/stats counts the same index the search uses: events, countries, cities, and venues.

MCP

GET /mcp reports protocol status. POST /mcp speaks MCP JSON-RPC 2.0. The tool is search_global_events. The same handler is at /api/mcp.

Health

GET /health.json returns {"status":"ok"} while this origin is serving.