Lobbydex runs a Model Context Protocol server, so assistants like Claude, ChatGPT, Cursor or VS Code can search the directory and read live server status, player history, outages and checks while they answer. Reading is free and needs no key. Signed-in tools (vote, follow, edit servers you own) ask the user to connect their Lobbydex account with OAuth; they choose what to allow and can disconnect it in their settings.
https://lobbydex.com/mcpConnect it
In apps with connectors (Claude, ChatGPT), add a custom connector with that URL. In Claude Code:
claude mcp add --transport http lobbydex https://lobbydex.com/mcpIn editors and other clients that take a JSON config:
{
"mcpServers": {
"lobbydex": {
"type": "http",
"url": "https://lobbydex.com/mcp"
}
}
}Tools
| Tool | What it does | Needs |
|---|---|---|
| search | Search Lobbydex for Minecraft and Discord servers by name, address, game mode or topic. Returns ids to pass to fetch, with titles and links. | nothing |
| fetch | Everything Lobbydex knows about one server, by an id from search ("minecraft:hypixel", "discord:hypixel"): status, players, versions, addresses, modes, history and links. | nothing |
| search_minecraft_servers | Find Minecraft servers listed on Lobbydex (Java and Bedrock) by name, game mode, version or language. Player counts are measured by Lobbydex every few minutes, not reported by owners. Returns up to 25 servers with address, players, version, rank and a link. | nothing |
| get_minecraft_server | Details for one Minecraft server on Lobbydex, by its Lobbydex slug or by the address players type (e.g. play.example.net). Includes live status, players, version, addresses per edition, rank, tags, description and a summary of its last 30 days (uptime, busiest hours, trend). | nothing |
| search_discord_servers | Find Discord communities listed on Lobbydex by name, tag or description. Member and online counts come from each server's invite. Returns up to 25 servers with an invite link and a Lobbydex link. | nothing |
| get_discord_server | Details for one Discord server on Lobbydex by its Lobbydex slug: members, online now, invite link, tags, description and any linked game servers. | nothing |
| lobbydex_stats | How many Minecraft servers are online and how many players are on them right now across Lobbydex, plus Discord totals. | nothing |
| get_player_history | Players over time for one Minecraft server, measured by Lobbydex: hourly for 24 hours or 7 days, daily for 30 or 90 days. Each point has the average and peak players and the share of checks the server answered (uptime). Optionally one edition only. | nothing |
| get_server_checks | The latest check of one Minecraft server from each of Lobbydex's check regions (New York, Frankfurt, Singapore...): whether it answered, the round-trip time in milliseconds, and when. Useful for 'is it down for everyone?' and 'which region has the best ping?'. | nothing |
| get_outages | Outages Lobbydex recorded for one Minecraft server: when each started and ended, how long, which edition, and which check regions saw it. Up to 90 days back. | nothing |
| get_server_changes | What changed on one Minecraft server and when, as Lobbydex noticed it: versions accepted, MOTD, player slots, name, and similar. Newest first. | nothing |
| get_modpack | The modpack a modded Minecraft server uses, when its owner linked one: the pack's name and page, loader, loader version and Minecraft version. | nothing |
| compare_minecraft_servers | Two to four Minecraft servers side by side: players now, rank, versions, editions, uptime and average players over the last 30 days, and their links. By Lobbydex slugs. | nothing |
| my_lobbydex_account | The signed-in user's Lobbydex account: their name, the servers they own (claimed) or added, claims in progress, and the servers they follow. | account |
| follow_server | Follow a Minecraft server for the signed-in user: it shows in their Following list and Monday digest, and (if they choose) they get an email when it comes back after being down. | account |
| unfollow_server | Stop following a Minecraft server for the signed-in user. | account |
| vote_for_server | Cast the signed-in user's daily vote for a Minecraft server (one vote per server per UTC day). Give their Minecraft name to receive the server's vote reward, when the server has rewards set up. Only vote when the user asks to. | vote |
| update_my_server | Edit a Minecraft listing the signed-in user owns (has claimed): display name, description, website, Discord invite and tags. Only the fields given change; an empty string clears a field. Tags replace the current ones (up to 8, by name). | servers:manage |
| claim_server | Start claiming a Minecraft listing as its owner: returns a short token to add anywhere in the server's MOTD. Lobbydex checks it on its next pings (usually within a few minutes); call claim_status to see when it's verified. The token can be removed after. | servers:manage |
| claim_status | Whether the signed-in user's claim on a Minecraft listing has been verified yet. | servers:manage |
Streamable HTTP, stateless, protocol versions 2025-06-18, 2025-03-26, 2024-11-05. 300 requests a minute per IP. Results include each server's Lobbydex link; the same attribution applies as for the API.
OAuth for signed-in tools
OAuth 2.1: authorization code with PKCE (S256), public clients, dynamic client registration and client ID metadata documents. Metadata at /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server; scopes account, vote and servers:manage. Access tokens last an hour; refresh tokens rotate. Votes through an app count once per server per day, like on the site.