get_connected_player
ChatGPTUse this when the user asks which Munzee account is connected or for their Munzee username and player ID. All player tools use this signed-in account.
Overview
Ask about your Munzee activity, Munzdex collection, badges, inventory, current ZeeOps mission and Gauntlet Games progress. Look up individual Munzees and find bouncers by family or nearby location. Access is read-only: CuppaZee cannot capture or deploy Munzees, spend credits, or change your account.
Tools
get_guild_progress
ChatGPTUse this for the signed-in player's Munzee Gauntlet Games progress. Includes task names, descriptions, player values, individual and guild targets for each level, and remaining individual progress. Guild targets are shared goals, not the player's personal target. Supply year and month (1-12) together, or omit both for the current MHQ month. Unknown progress is null.
get_guild_stats
ChatGPTUse this for a Munzee guild's Gauntlet Games requirements and member statistics. Includes labelled task targets and current guild/member values. Requires guildId; supply year and month (1-12) together, or omit both for the current MHQ month.
get_munzdex_group
ChatGPTUse this when the user wants to browse the Munzee types in a family or Munzdex group. Returns child groups and paginated released types, including all nested families by default. Use this to enumerate every type in a family such as AlternaMyths. Use search_munzdex to find group IDs.
get_munzdex_types
ChatGPTUse this when the user asks about a Munzee type's points, capture hints, description or family. Look up up to 20 released Munzdex type IDs; find IDs with search_munzdex first. Unknown/unreleased IDs are reported individually.
get_munzee
ChatGPTRead an individual Munzee's details by munzeeId, including its name, type, coordinates, owner, notes, capture count and current bouncers. Shows whether the connected player has captured it. Does not capture, deploy or edit the Munzee.
get_player_activity
ChatGPTUse this to list the signed-in player's individual Munzee captures, deploys or other events for one day. Returns only paginated entries, optionally filtered by activityType; no overview. Use get_player_activity_summary for daily totals. Historical days require premium.
get_player_activity_breakdown
ChatGPTUse this for the signed-in player's daily Munzee counts/points by type for a chosen activity category. Returns one page of type totals, referral users, or reward items, with no individual events. Historical days require premium.
get_player_activity_range_breakdown
ChatGPTGet paginated type totals (or referral users/reward items) for one activity category over an inclusive MHQ date range, maximum 31 days. Requires premium. Loading means history is still being prepared, not zero activity. No event list or repeated summary.
get_player_activity_range_summary
ChatGPTGet the connected player's aggregate counts and points for an inclusive MHQ date range (maximum 31 days). Requires premium. Returns loading with preparedDays/totalDays while history is prepared; retry later, never treat loading as zero activity. No event list or daily series.
get_player_activity_summary
ChatGPTUse this for a compact summary of the signed-in player's Munzee day: total points and counts/points by activity category. No event list or per-type breakdown. Use get_player_activity for individual events and get_player_activity_breakdown for counts by type. Historical days require premium.
get_player_badges
ChatGPTList or search the signed-in player's Munzee badges by name, description or category. Includes earned status and requirement descriptions, not numeric completion progress. Filter awarded=false for unearned badges. Cannot reliably rank badges by closeness to completion.
get_player_inventory
ChatGPTRead the signed-in player's Munzee inventory: credits, boosters and undeployed items. Search item names or groups, with paginated quantities. This cannot buy, redeem, deploy or spend items.
get_player_leaderboard
ChatGPTGet the connected player's all-time points rank and neighbouring players. Requires premium. This is a small neighbourhood, not the full leaderboard; daily, weekly and monthly rankings are not available here.
get_player_munzdex
ChatGPTUse this when the user asks how many Munzees of particular types they have captured or deployed, or about those types in their Munzdex collection. Returns the signed-in player's counts for up to 20 released type IDs; find IDs with search_munzdex. Hidden counts are null. Does not enumerate individual custom designs.
get_player_zeeops
ChatGPTRead the signed-in player's current ZeeOps mission, requirement description, progress and rewards. Does not start missions, reroll or collect rewards.
search_bouncers
ChatGPTUse this when the user asks where Munzee bouncers are, which bouncers a player owns, or which are on a host or within an area. Search the current unexpired snapshot by released type IDs, groupIds (including nested families), exact owner username, host ID, bounds or near coordinates with radiusKm. Type IDs and groups are combined as a union; other filters narrow results. Supply bounds or near, not both. At least one filter is required. Results use stable ID order, not nearest-first. Use nextCursor with the same filters for more results. Locations may change; this is not location history.
search_munzdex
ChatGPTUse this when the user asks about a Munzee type or family, or needs to find a type by name. Search the Munzdex (Munzee type catalog) using fuzzy names, groups, IDs and hints. Returns stable IDs for type details, collection counts and bouncer searches.
show_bouncer_map
ChatGPTDisplay up to 100 bouncers on an interactive map. First call search_bouncers, then pass its bouncers (including each imageUrl, owner, url and host.url), observedAt and nextCursor here. You may select a subset relevant to the question; never invent locations. This renders supplied snapshot results and does not refresh locations. Clients without UI receive the locations as text.
Capabilities
Interactive
Example Prompts
Click any prompt to copy it.
