# Run Cebu Developer Portal

Run Cebu publishes machine-readable resources for agents and applications that need public running event data. Public read access does not require credentials. Scoped API keys are required only for event creation, updates, and deletion.

## REST API

- `GET /api/events` lists public events with `limit`, `offset`, `date_from`, `date_to`, `distance`, and `category` filters.
- `GET /api/events/{eventId}` fetches one event by UUID.
- `POST /api/events` requires `events:write`.
- `PATCH /api/events/{eventId}` requires `events:write`.
- `DELETE /api/events/{eventId}` requires `events:delete`.

## MCP

Use `https://runcebu.com/mcp` when an agent client supports Model Context Protocol Streamable HTTP. The endpoint exposes read-only `list_events` and `get_event` tools.

## Discovery

- OpenAPI: https://runcebu.com/openapi.json
- API catalog: https://runcebu.com/.well-known/api-catalog
- MCP server card: https://runcebu.com/.well-known/mcp/server-card.json
- Agent skill index: https://runcebu.com/.well-known/agent-skills/index.json
- Full agent guide: https://runcebu.com/llms-full.txt