List all beacon organizations (tenants) available via the configured beacon API. Call this first if you don't know which org to query.

Check whether the beacon API is reachable and the (optional) org is healthy.

Read the public beacon configuration for an org (min session event count, model pricing).

Fetch the beacon dashboard payload (or a single sub-section) for the given date range. Returns metrics, activity, traffic, prompt/distribution breakdowns, and the top projects/sessions.

Daily rollup per project: event/request counts and token usage. Use for 'which project uses the most tokens this week' questions.

Daily rollup per programming language (from session language detection). Use to identify which languages AI assistants are most often working in.

Daily rollup per prompt style (rule-classified). Useful for understanding how users phrase their requests.

Per-user, per-hour usage broken down by tool and model. Use to find power users, peak hours, and per-model consumption.

Per-session rollup: which sessions used the most tokens, their models, timestamps, etc. Use to find the heaviest sessions before drilling in with get_session_events.

Raw event query with date range, project/model/status/user filters and pagination. Use for inspecting individual events (errors, specific users, model behaviour, prompt previews). By default returns up to 100 rows; pass all: true to disable the limit (use sparingly).

Fetch the full event chain for a single session (compact prompt previews, token usage, errors, model). Use after query_session_summary to drill into the heaviest sessions.