Skip to main content
Glama
hypixel-skyblock-mcp

hypixel-skyblock-mcp

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-mcp from 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 tools
cache_clearClear MCP CacheA
Idempotent

Clear this MCP server's in-memory Hypixel, Mojang, and wiki response caches.

Inputs: no named parameters.

decode_skyblock_nbtDecode SkyBlock NBTB
Read-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 StatusB
Read-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 PlayerB
Read-onlyIdempotent

Resolve a Minecraft username or UUID into normalized UUID forms for Hypixel tools.

Inputs: uuid, username.

server_statusInspect MCP StatusA
Read-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 AuctionsB
Read-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 ProfileB
Read-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 BazaarB
Read-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 ProgressA
Read-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 CostA
Read-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 GardenC
Read-onlyIdempotent

Fetch garden plot, commission, and composter data for a SkyBlock profile.

Inputs: uuid, username, profileId, memberUuid, +3 more.

skyblock_guide_contextBuild SkyBlock Guide ContextB
Read-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 SectionsB
Read-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 ItemA
Read-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 MuseumC
Read-onlyIdempotent

Fetch museum donations and value summary for a SkyBlock profile member.

Inputs: uuid, username, profileId, memberUuid, +3 more.

skyblock_networthEstimate SkyBlock Net WorthA
Read-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 ContextB
Read-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 ProfilesA
Read-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 ResourceC
Read-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 StorageB
Read-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 UpgradesA
Read-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 PageA
Read-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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 23 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides 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.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Auction house analytics, market intelligence, crafting optimization, inventory valuation, farming routes, guild analytics, and token tracking — all through the Model Context Protocol.
      10
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Answers 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.
      26
      13 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      2
      MIT