get_insight
Read officer-authorized Insights. Requirements: legacy period_id returns full detail; detail=summary enables bounded score pages. Example: family=requirements, detail=summary, period_selector=last_completed, period_count=4, aggregate=player, sort=total_points, page_size=10. Or use period_id / period_ids (up to 12), membership_scope=period_participants or current_roster, member_search, exact player_ids or player_names (same-name identities stay separate), sort, direction, page. Completed means ends_at has passed in UTC. Preserved scores use the explicitly pinned historical publication. Ready scores match current inputs; finalized scores use the last published historical snapshot with stat_version_id and snapshot_completed_at. Missing/stale stats remain unavailable, not zero. Raw total_points comes from that snapshot and differs from fine-adjusted rank_points; live rules, fines and identity presentation may still change. Other family filters: chests (period_id, search, selection, sort=chest_count|total_points, direction, page, page_size; selected total_points covers selected chest types and default order remains chest_count); resources and dragon_coins (period_id, from, to, resource where applicable, search, summary_page, activity_page, page_size, ledger_search, ledger_page, ledger_page_size); forest_essence (period_id, from, to, search, summary_page, activity_page, page_size); titles (period_id, search, title_id, member_search, member_page, member_page_size); gold_pass (status, event_number, search, sort=nickname|first_observed_with_gold_pass_at|first_observed|state, direction, page, page_size; timestamp nulls last in both directions; state order with, without, unknown ascending); roster (default events: search, sort, direction, page, page_size; view=periods adds ISO-8601 at and sort=joined_at|playerName); vaults (period_id, day, interval, player, evidence_page, evidence_page_size, search, sort, page, page_size); journal (period_id, page, page_size); ancients (period_id, event_id); guardsmen and fines (period_id). Generic keys outside a family's list are rejected. Gold Pass first_observed_with_gold_pass_at is first observation with a pass, not purchase time. Roster periods are observed snapshots, not exact in-game action times. Required scopes: insights:read. Tool failures return isError=true with code, message, named field constraints, recovery, operation_outcome and request_id in both JSON text and structuredContent. Follow recovery; an unknown write outcome requires original-key/receipt recovery, never a new key.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | ||
| to | No | ||
| day | No | ||
| from | No | ||
| page | No | ||
| sort | No | ||
| view | No | ||
| detail | No | ||
| family | Yes | ||
| player | No | ||
| search | No | ||
| status | No | ||
| clan_id | Yes | ||
| rule_id | No | ||
| batch_id | No | ||
| event_id | No | ||
| interval | No | ||
| resource | No | ||
| title_id | No | ||
| aggregate | No | ||
| breakdown | No | Chests only: flat period-snapshot member/type contributions, stable participant_key/type order by default; page_size up to 100, page up to 1000. Includes total, UTC period boundaries, snapshot availability/version/time. Reward observation availability does not restrict contributions. | |
| direction | No | ||
| page_size | No | ||
| period_id | No | ||
| selection | No | ||
| period_ids | No | ||
| player_ids | No | ||
| ledger_page | No | ||
| member_page | No | ||
| event_number | No | ||
| period_count | No | ||
| player_names | No | ||
| summary_page | No | ||
| activity_page | No | ||
| evidence_page | No | ||
| ledger_search | No | ||
| member_search | No | ||
| period_selector | No | ||
| ledger_page_size | No | ||
| member_page_size | No | ||
| membership_scope | No | ||
| only_outstanding | No | ||
| evidence_page_size | No | ||
| min_failed_periods | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||