canonical: https://jentic.com/apis/hypixel.net/hypixel-hypixel

# Hypixel Public API

The Hypixel Public API exposes 34 endpoints for the Hypixel Minecraft server network, covering player profiles, recent games, guild records, server status, and a deep set of resource lookups for game types, achievements, challenges, quests, vanity items, and SkyBlock content (collections, skills, items, election, bingo, news, and bazaar). API keys are issued via developer.hypixel.net and rate limits depend on application tier. Endpoints that require an API key respond with RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers.

## For AI agents

Read Hypixel player stats, guilds, recent games, and SkyBlock data, and resolve game-type and achievement reference data for Minecraft tooling.

## Scope

Does not handle Minecraft account authentication, server hosting, or chat moderation - use for Hypixel network player, guild, status, and resource reads only.

## Capabilities

- Look up a Hypixel player profile by UUID and read stats across game modes
- Retrieve a player's recent games list with mode, map, and timestamps
- Fetch a guild record by id, name, or member UUID with members and ranks
- Read SkyBlock collections, skills, items, election, bingo, and news resources
- Resolve reference data for game types, achievements, challenges, and quests
- Read vanity pets and companion catalogue data for cosmetic display

## Use cases

### Player Stats Dashboard

Build a Minecraft stats site or Discord bot that surfaces Hypixel performance - kills, wins, level - across game modes by calling `/v2/player` and joining with `/v2/recentgames.` Reference data from `/v2/resources/games` keeps mode names readable. Suited to community sites or guild dashboards.

Example prompt: GET `/v2/player` with the player's uuid query parameter and render the SkyWars and BedWars stats blocks.

### Guild Management Tools

Power guild-management dashboards that list members, ranks, and recent activity by calling `/v2/guild` with a guild id, name, or member UUID. Combined with `/v2/recentgames` per member, the tool can highlight active versus inactive members and recommend kicks or promotions inside Discord moderation flows.

Example prompt: GET `/v2/guild` with name='Mythic' and rank members by recent game activity.

### SkyBlock Companion App

Build a SkyBlock companion app that pulls collections, skills, items, election, and bingo from `/v2/resources/skyblock`/* and combines them with player profile data for personalised progression tracking. Those five reference resources are public and unauthenticated, while player calls require an API key.

Example prompt: GET `/v2/resources/skyblock/collections` and merge with `/v2/player` to compute completion percentages.

### AI Agent Game Assistant

Give an AI assistant Minecraft-aware tools by exposing Hypixel via Jentic. The agent can answer 'how many BedWars wins does Player X have' by searching for the operation, loading the schema, and executing `/v2/player.` The API key never enters the agent context, which matters for community Discord bots that take untrusted user input.

Example prompt: Search Jentic for 'look up a Hypixel player by uuid', load the schema, and execute with the player UUID.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v2/player` | Look up a player profile by UUID |
| GET | `/v2/recentgames` | List recent games for a player |
| GET | `/v2/guild` | Look up a guild by id, name, or member UUID |
| GET | `/v2/status` | Check whether a player is currently online |
| GET | `/v2/resources/games` | List supported game types |
| GET | `/v2/resources/skyblock/collections` | List SkyBlock collections |
| GET | `/v2/resources/skyblock/items` | List SkyBlock items |

## Key resources

- **Player** — Player profile and game-mode stats by UUID
- **Recent Games** — List of a player's recent matches
- **Guild** — Guild lookup by id, name, or member UUID
- **Status** — Player online status and current session
- **Resources** — Reference data for games, achievements, challenges, quests, and vanity items
- **SkyBlock Resources** — Reference data for SkyBlock collections, skills, items, election, bingo, and news

## Why Jentic

- **Setup:** Wiring the Hypixel Public API by hand means registering for an API-Key, passing it in the API-Key header, and coding around its per-key rate limits yourself. Through Jentic you install once, import the Hypixel Public API from the API Directory, store the API key once, and your agent calls it.
- **Permission scoping:** Most Hypixel reads take the player or guild identifier as a query parameter rather than a URL path, so scope your agent by the operations it needs, such as reading player stats, recent games, or SkyBlock resources. Because you pick the allowed operations, the agent only touches the network reads you name.
- **Credential handling:** Your Hypixel API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'look up a Hypixel player' or 'get a guild's members', and Jentic returns the matching Hypixel operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Mojang API** — Mojang resolves Minecraft usernames to UUIDs that Hypixel endpoints require
- **Riot Games API** — Riot Games offers a similar player-and-match-history API surface for League of Legends and Valorant
- **Twitch API** — Twitch streams from Hypixel players can be combined with Hypixel stats for a community dashboard

## FAQ

### Is there a Hypixel MCP server?

You don't need an MCP server to give your agent the Hypixel Public API. Jentic connects it directly from the API Directory: import it, store your Hypixel API key once, and your agent calls it.

### What authentication does the Hypixel Public API use?

Hypixel uses an API key passed in the API-Key header, required by 18 of the 34 operations in this spec; the remaining 16 resource and SkyBlock reference reads need no credential. Keys are issued via developer.hypixel.net. Your own Jentic One instance stores the key and injects it at execution time, so the raw key never enters the agent's context - useful for public Discord bots that take untrusted input.

### Can I look up a player's recent games?

Yes. GET `/v2/recentgames` with the player UUID returns a list of recent matches with game type, map, and timestamps. Combine it with `/v2/player` for full stats and `/v2/status` to see if the player is currently online.

### What are the rate limits for the Hypixel Public API?

Hypixel limits API keys to a maximum number of requests per 5-minute interval, with the exact limit depending on the application tier. Endpoints that require an API key also respond with RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers - read them and back off when remaining hits zero. Keyless reads such as GET `/v2/resources/games` do not return them.

### How do I look up a guild through Jentic?

Search Jentic for 'look up a Hypixel guild', load the schema for GET `/v2/guild`, and execute with id, name, or player UUID. GET `/v2/guild` is one of the operations that needs the API-Key header, and your self-hosted Jentic One instance supplies it when the call runs.

### Does the Hypixel API expose SkyBlock data?

Yes. `/v2/resources/skyblock/collections`, /skills, /items, /election, and related endpoints return SkyBlock reference data that companion apps can merge with player profile data to compute progression and completion percentages.

### Can I limit what my agent is allowed to do with the Hypixel Public API?

Yes. Because you run Jentic One yourself, your own rules decide which Hypixel operations and credentials the agent may use, so you can grant only the reads it needs, such as GET `/v2/player` for player stats, GET `/v2/recentgames`, GET `/v2/guild`, or the `/v2/resources/skyblock`/* reference calls. Most of these take the player or guild identifier as a query parameter rather than a URL path, so scoping by operation keeps the agent to the exact network reads you name. Any endpoint you do not allow stays off limits, and your API key is injected at execution time without entering the agent's context.