hypixel-skyblock-mcp
The server historically exposed 23 MCP tools for Hypixel SkyBlock data and analysis, but the project is retired and must not be connected to Hypixel's API; the source is historical reference only.
Resolve Minecraft usernames/UUIDs and inspect Hypixel player status.
List SkyBlock profiles and retrieve profile context: skills, slayers, dungeons, pets, collections, currencies, accessories, garden, museum, and bingo progress.
Decode and search inventories, storage, backpacks, ender chests, vault, sacks, and bags; decode SkyBlock NBT locally.
Audit profiles, estimate net worth, advise upgrades, and build progression-guide context using mayor/economy/Bazaar/auction/item data.
Fetch public SkyBlock resources, Bazaar and auction data, item metadata/prices, and configured wiki pages/search.
Calculate essence star upgrade costs.
Clear local caches and inspect server configuration/status without revealing credentials.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@hypixel-skyblock-mcp get skyblock profile for Technoblade"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Hypixel SkyBlock MCP — Retired
Project status: Retired (November 9, 2026). Do not use this MCP server to connect AI tools to Hypixel's API.
Hypixel Support informed the maintainer in ticket #1214029 (October 2026) that AI tools accessing the Hypixel API are not permitted under their current interpretation of the rules, that asking users to supply their own API keys does not make this distributed integration acceptable, and that this project's proposed API use would not receive approval. See Hypixel's current API policy.
The public source code is retained solely as a historical reference. The 23-tool, API-connected MCP integration has not been approved by Hypixel and is no longer maintained or offered as a recommended integration. Do not follow historical setup instructions to run it against Hypixel's API. This project is not affiliated with, endorsed by, or supported by Hypixel.
Existing users
Stop using the API-connected MCP server. Remove
hypixel-skyblock-mcpfrom your MCP client configuration.The previously published npm package may still be downloadable, and installed versions are not automatically disabled by a GitHub notice. A separate npm deprecation is necessary.
Do not put Hypixel API keys in third-party tools or services. If a key was exposed or shared, revoke/rotate it in the Hypixel Developer Dashboard as appropriate.
This repository no longer automatically publishes to npm on GitHub Releases.
Related MCP server: blizzard-wow-mcp
Historical reference
The original technical documentation, implementation, release tags, and Git history are preserved for reference only; they are not instructions to deploy a permitted integration. See retirement checklist for remaining package-owner and repository-owner actions.
A future standalone, offline SkyBlock analysis tool would require an independently reviewed design that does not access the Hypixel API through an AI tool. No such successor is announced or authorized by this repository.
License
The preserved source is distributed under the MIT License. The license is not permission to use Hypixel's API contrary to its rules.
Available Tools
23 toolscache_clearClear MCP CacheAIdempotent
Clear this MCP server's in-memory Hypixel, Mojang, and wiki response caches.
Inputs: no named parameters.
decode_skyblock_nbtDecode SkyBlock NBTBRead-onlyIdempotent
Decode a Hypixel SkyBlock base64 gzipped NBT inventory/item payload into plain JSON and a compact item list.
Inputs: data (required), maxItems, includeRaw.
hypixel_playerGet Hypixel Player StatusBRead-onlyIdempotent
Fetch Hypixel network player data: online status, rank, login times, karma, and selected network stats. Requires HYPIXEL_API_KEY.
Inputs: uuid, username.
resolve_playerResolve Minecraft PlayerBRead-onlyIdempotent
Resolve a Minecraft username or UUID into normalized UUID forms for Hypixel tools.
Inputs: uuid, username.
server_statusInspect MCP StatusARead-onlyIdempotent
Inspect server version, configured integrations and cache use locally. Makes no API requests and never reveals credentials.
Inputs: no named parameters.
skyblock_auctionsFetch SkyBlock AuctionsBRead-onlyIdempotent
Fetch active auction pages, recently ended auctions, or API-key auction lookups by auction, player, or profile. Filters output for AI use.
Inputs: mode, page, tier, limit, +8 more.
skyblock_auditAudit SkyBlock ProfileBRead-onlyIdempotent
Return a compact profile audit with computed levels, HOTM/HOTF trees, progression gaps, gear/loadout summaries, accessory analysis, and prioritized next actions.
Inputs: uuid, focus, username, profileId, +6 more.
skyblock_bazaarFetch SkyBlock BazaarBRead-onlyIdempotent
Fetch current Bazaar product prices, volumes, and spread signals. Useful for money-making tips and crafting cost checks.
Inputs: limit, search, sortBy, includeRaw, +2 more.
skyblock_bingoGet SkyBlock Bingo ProgressARead-onlyIdempotent
Fetch a player's Bingo event history and optionally match the current event goals. Missing participation stays unknown. Requires HYPIXEL_API_KEY.
Inputs: uuid, limit, eventId, username, +1 more.
skyblock_essence_costsCalculate Essence Upgrade CostARead-onlyIdempotent
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.
Inputs: itemId (required), toStar, fromStar, quantity, +2 more.
skyblock_gardenGet SkyBlock GardenCRead-onlyIdempotent
Fetch garden plot, commission, and composter data for a SkyBlock profile.
Inputs: uuid, username, profileId, memberUuid, +3 more.
skyblock_guide_contextBuild SkyBlock Guide ContextBRead-onlyIdempotent
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.
Inputs: uuid, goals, username, profileId, +17 more.
skyblock_inventoryGet SkyBlock Inventory SectionsBRead-onlyIdempotent
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.
Inputs: uuid, username, profileId, memberUuid, +12 more.
skyblock_itemLook Up SkyBlock ItemARead-onlyIdempotent
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.
Inputs: itemId, search, priceBasis, includeWiki, +3 more.
skyblock_museumGet SkyBlock MuseumCRead-onlyIdempotent
Fetch museum donations and value summary for a SkyBlock profile member.
Inputs: uuid, username, profileId, memberUuid, +3 more.
skyblock_networthEstimate SkyBlock Net WorthARead-onlyIdempotent
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.
Inputs: uuid, topItems, username, profileId, +9 more.
skyblock_profileGet SkyBlock Profile ContextBRead-onlyIdempotent
Fetch one SkyBlock profile and return compact AI-readable member context: skills, slayers, dungeons, pets, collections, currencies, accessories, and optional decoded inventories.
Inputs: uuid, username, profileId, memberUuid, +16 more.
skyblock_profilesList SkyBlock ProfilesARead-onlyIdempotent
List a player's SkyBlock profiles with compact member metadata. Requires HYPIXEL_API_KEY and respects the player's API privacy settings.
Inputs: uuid, username, includeRaw.
skyblock_resourceFetch SkyBlock ResourceCRead-onlyIdempotent
Fetch public SkyBlock resources: items, skills, collections, election/mayor, bingo, or news. Supports filtering for item and resource searches.
Inputs: kind (required), ids, tier, limit, +3 more.
skyblock_storageSearch SkyBlock StorageBRead-onlyIdempotent
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.
Inputs: uuid, search, username, itemLimit, +13 more.
skyblock_upgrade_advisorAdvise SkyBlock UpgradesARead-onlyIdempotent
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.
Inputs: uuid, limit, sources, username, +7 more.
skyblock_wiki_pageFetch Configured SkyBlock Wiki PageARead-onlyIdempotent
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.
Inputs: title, search, includeRaw, maxSectionChars.
skyblock_wiki_searchSearch Configured SkyBlock WikiARead-onlyIdempotent
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.
Inputs: search (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Social creator profile statistics, follower graph & recent posts API for AI agents.
Public web data for AI agents: scrape any page, plus Google, TikTok, Instagram and Amazon as JSON.
Blockchain analytics API for AI agents. Smart Money signals, wallet profiling, token analytics.
Blockchain analytics API for AI agents. Smart Money signals, wallet profiling, token analytics.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceProvides comprehensive World of Warcraft guild analytics, player character analysis, and auction house market data through the Blizzard Battle.net API. Supports both Retail and Classic WoW with real-time market insights, guild roster management, and demographic analytics.-
- AlicenseAqualityCmaintenanceAuction house analytics, market intelligence, crafting optimization, inventory valuation, farming routes, guild analytics, and token tracking — all through the Model Context Protocol.10MIT
- AlicenseAqualityBmaintenanceAnswers whole player questions for Old School RuneScape in a single call — quest requirements and step-by-step guides, trip inventories fitted to 28 slots, item sources and live prices, monster drop tables, skill and money-making plans — by combining wiki data, real-time Grand Exchange prices, quest definitions and the player's own account. Supports saved-account personalization for main, ironman and other modes, returning compact sourced JSON with cached, freshness-stamped data.2613 npm2MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to query live Wynncraft v3 game data — player profiles, guilds and territories, items and ingredients, recipes, ability trees, aspects, leaderboards, search and news — over stateless Streamable HTTP, locally or hosted. An optional Wynnventory integration adds third-party observed market listings, price history and rankings when configured.2MIT