Reports whether RetroAchievements credentials are configured and where they came from (env vars or saved file). Call this first if you're unsure whether the server is ready to use.

Validate a RetroAchievements username + Web API key against the live API, then persist them to a local config file so future tool calls work without env vars. USE ONLY with values the user typed in chat themselves — never guess or fabricate an API key. If the user does not have a key, point them at https://retroachievements.org/controlpanel.php first.

Retrieve summary profile data for a RetroAchievements user (points, rank, motto, member-since, avatar).

Fuller summary for a user: recent games, recent achievements, last activity, rank, awards count.

Achievements a user has unlocked in the last N minutes (default 60). Useful for 'what did they just play?' queries.

List of games the user has touched most recently, with last-played timestamps and per-game progress.

All games the user has earned at least one achievement in, with completion %, hardcore status, and award level.

Site awards the user has earned (mastery, beaten, event awards) with dates.

All achievements a user unlocked between two ISO dates. Powerful for weekly/monthly recaps.

Basic metadata for a game by ID: title, console, developer, publisher, genre, release date, box art.

Full game info including the achievement list (id, title, description, points, badge, unlock counts).

The currently featured achievement-of-the-week, plus the leaderboard of users who have already unlocked it.

The site's current top-ten ranked users by hardcore points.