SofiaStage Agent API

# SofiaStage Agent API > Read-only index for SofiaStage cultural-event data exposed by the Cloudflare Worker API. Use this file as a compact navigation layer for agents. Use OpenAPI for full schema and field-level details. ## Policies - All public GET /v1/* endpoints are read-only and do not require user authentication; POST /v1/admin/sync is disabled and returns 410. - The public MCP server at https://api.sofiastage.com/mcp exposes five read-only tools, two resources and three user-selected prompts with no authentication or user-specific data. - /v1/events uses cursor pagination; cursors are valid only for the same filter set. - Supported include values are stars and extras. - Event, venue and title queries default to scope=sofia; use scope=all for every city or city=<name> for one city. - Date format is YYYY-MM-DD and date_from must be <= date_to. - Start-time filters: starts_after and starts_before are inclusive and support HH:mm, local YYYY-MM-DDTHH:mm with tz (default Europe/Sofia), or RFC3339 with offset/Z. - limit values above 100 are clamped to 100; the /v1/cities lookup accepts up to 1000 so callers can build complete city indexes. - Rate guidance: keep automated traffic polite (about 1-3 requests/second per client) and use expon […gekürzt]