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. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"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_gardenA | Fetch garden plot, commission, and composter data for a SkyBlock profile. |
| skyblock_auditA | Return a compact profile audit with computed levels, HOTM/HOTF trees, progression gaps, gear/loadout summaries, accessory analysis, and prioritized next actions. |
| 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 official Hypixel SkyBlock Wiki obtaining/usage/upgrading/history context. Ambiguous searches return candidate IDs instead of guessing. |
| skyblock_wiki_searchA | Search the official Hypixel SkyBlock Wiki through its MediaWiki API. Use this for item, mechanic, update, NPC, location, and guide-page discovery from first-party wiki data. |
| skyblock_wiki_pageA | Fetch one official Hypixel SkyBlock Wiki page via MediaWiki query/revisions and return cleaned AI-readable section summaries. For item pages, this extracts summary, obtaining, upgrading, usage, history, and trivia when present. |
| skyblock_essence_costsA | Compute the exact essence, coin, and material cost to star up (or master-star) 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. Returns found=false with suggestions when the item ID is not star-upgradeable or not recognized. |
| decode_skyblock_nbtC | 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 and Mojang response cache. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/crithitstudio/hypixel-skyblock-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server