Skip to content

DevelopersGuides

MCP for AI assistants

Live Lobbydex data inside Claude, ChatGPT and editors.

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.

Server URL
https://lobbydex.com/mcp

Connect it

In apps with connectors (Claude, ChatGPT), add a custom connector with that URL. In Claude Code:

Shell
claude mcp add --transport http lobbydex https://lobbydex.com/mcp

In editors and other clients that take a JSON config:

JSON
{
  "mcpServers": {
    "lobbydex": {
      "type": "http",
      "url": "https://lobbydex.com/mcp"
    }
  }
}

Tools

ToolWhat it doesNeeds
searchSearch Lobbydex for Minecraft and Discord servers by name, address, game mode or topic. Returns ids to pass to fetch, with titles and links.nothing
fetchEverything 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_serversFind 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_serverDetails 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_serversFind 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_serverDetails for one Discord server on Lobbydex by its Lobbydex slug: members, online now, invite link, tags, description and any linked game servers.nothing
lobbydex_statsHow many Minecraft servers are online and how many players are on them right now across Lobbydex, plus Discord totals.nothing
get_player_historyPlayers 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_checksThe 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_outagesOutages 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_changesWhat changed on one Minecraft server and when, as Lobbydex noticed it: versions accepted, MOTD, player slots, name, and similar. Newest first.nothing
get_modpackThe 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_serversTwo 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_accountThe 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_serverFollow 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_serverStop following a Minecraft server for the signed-in user.account
vote_for_serverCast 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_serverEdit 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_serverStart 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_statusWhether 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.