hypixel-skyblock-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HYPIXEL_API_KEY | Yes | Your Hypixel API key, obtained from the Hypixel Developer Dashboard. | |
| SKYBLOCK_LOWEST_BIN_URL | No | Optional URL to a JSON map of lowest BIN prices for auction-only items. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| resolve_playerB | Resolve a Minecraft username or UUID into normalized UUID forms for Hypixel tools. |
| skyblock_profilesA | List a player's SkyBlock profiles with compact member metadata. Requires HYPIXEL_API_KEY and respects the player's API privacy settings. |
| skyblock_profileB | Fetch one SkyBlock profile and return compact AI-readable member context: skills, slayers, dungeons, pets, collections, currencies, accessories, and optional decoded inventories. |
| skyblock_inventoryB | Fetch and decode inventory-like NBT sections for one SkyBlock profile, including wardrobe, armor, equipment, ender chest, backpacks, vault, and bags. Use filters to keep output focused. |
| skyblock_storageB | Decode and merge items across backpacks, ender chest, personal vault, sacks, bags, and inventory. Returns grouped item counts, sack totals, and optional per-section detail. |
| hypixel_playerB | Fetch Hypixel network player data: online status, rank, login times, karma, and selected network stats. Requires HYPIXEL_API_KEY. |
| skyblock_museumC | Fetch museum donations and value summary for a SkyBlock profile member. |
| skyblock_gardenC | Fetch garden plot, commission, and composter data for a SkyBlock profile. |
| skyblock_auditB | Return a compact profile audit with computed levels, HOTM/HOTF trees, progression gaps, gear/loadout summaries, accessory analysis, and prioritized next actions. |
| skyblock_upgrade_advisorA | Rank the gear and accessory upgrades available to a profile that can be honestly costed today: remaining essence-star costs on equipped gear, and next-tier accessory upgrades (priced when a lowest-BIN source is configured). Returns a budget-aware, ranked action list with per-upgrade confidence and caveats, plus a coverage block that names which requested sources are not yet supported (reforge/enchant/HOTM/pet) instead of inventing stat or cost numbers. |
| skyblock_networthA | Estimate a profile's net worth from liquid coins, decoded inventory/storage holdings, sacks, and supported item modifiers, priced with live Bazaar data (and an optional external lowest-BIN source for auction items). Returns a total, per-section breakdown, top items by value, modifier breakdown, and pricing coverage. |
| skyblock_guide_contextB | Fetch a profile plus current mayor and economy signals so an AI can write tailored SkyBlock progression advice. Requires HYPIXEL_API_KEY for player/profile data. |
| skyblock_resourceC | Fetch public SkyBlock resources: items, skills, collections, election/mayor, bingo, or news. Supports filtering for item and resource searches. |
| skyblock_bazaarB | Fetch current Bazaar product prices, volumes, and spread signals. Useful for money-making tips and crafting cost checks. |
| skyblock_auctionsB | Fetch active auction pages, recently ended auctions, or API-key auction lookups by auction, player, or profile. Filters output for AI use. |
| skyblock_itemA | Look up a single SkyBlock item by ID or name and return its official metadata (tier, category, stats, NPC price, museum/soulbound flags) plus a live value: full Bazaar buy/sell/spread/volume for Bazaar items, or a lowest-BIN price when an external source is configured, otherwise a clear auction-only note. Set includeWiki for configured MediaWiki obtaining/usage/upgrading/history context. Ambiguous searches return candidate IDs instead of guessing. |
| skyblock_wiki_searchA | Search a configured MediaWiki source for SkyBlock knowledge. The official wiki retired in July 2026; without SKYBLOCK_WIKI_BASE this returns retirement information. Results identify their source and are not assumed official. |
| skyblock_wiki_pageA | Fetch a page from the configured MediaWiki source with revision time and cleaned sections. The retired official wiki returns explicit availability information by default. Configured replacement content is labeled non-official. |
| skyblock_essence_costsA | Compute the exact essence, coin, and material cost to add essence-funded stars to a dungeon/crimson item by its SkyBlock ID, using authoritative per-star cost data. Optionally prices essence and materials with live Bazaar data for a coin estimate. Master Star items are not priced. Returns found=false with suggestions for unknown or non-upgradeable IDs. |
| decode_skyblock_nbtB | Decode a Hypixel SkyBlock base64 gzipped NBT inventory/item payload into plain JSON and a compact item list. |
| cache_clearA | Clear this MCP server's in-memory Hypixel, Mojang, and wiki response caches. |
| skyblock_bingoA | Fetch a player's Bingo event history and optionally match the current event goals. Missing participation stays unknown. Requires HYPIXEL_API_KEY. |
| server_statusA | Inspect server version, configured integrations and cache use locally. Makes no API requests and never reveals credentials. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| review_profile | A grounded profile review workflow with prioritized actions and explicit uncertainty. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| usage-guide | Tool selection, workflows, source availability and data limitations. |
TDQS
Scored across 23 tools
Many tools are clearly distinct (bazaar, auctions, wiki, garden, museum, server status), but the profile-analysis cluster—skyblock_profile, skyblock_audit, skyblock_guide_context, skyblock_upgrade_advisor, and skyblock_networth—overlaps in purpose and could cause misselection. Inventory vs. storage also blur, though detailed descriptions reduce the risk somewhat.
All tools use lowercase snake_case, mostly with domain prefixes (skyblock_, hypixel_). A few helpers lack a prefix and some names are verb-first rather than noun-first, but the overall style is predictable and consistent.
23 tools is on the heavy side; the 16-25 range is borderline per the calibration. The broad SkyBlock domain justifies many tools, but the set feels bulky and could likely be consolidated.
The surface covers player resolution, profiles, inventories/storage, bazaar/auctions, wiki, bingo, resources, NBT decoding, and analysis tools—broad read-only coverage. Minor gaps exist (e.g., no dedicated guild/friends or crafting recipe retrieval), but agents can work around them.