Skip to content
get a key

MCP for AI assistants

LobbyVerse has a Model Context Protocol server, so AI assistants can look things up for you. Ask in plain words:

  • “Find me a busy CS2 surf server near Berlin with a free slot.”
  • “Which Warcraft 3 servers have players right now?”
  • “Is this server’s player count real? 203.0.113.10:27015”
  • “How are my favorite servers doing?”

The server is at:

https://api.lobbyverse.com/mcp

It speaks Streamable HTTP. Every tool only reads; nothing an assistant does can change your favorites, alerts or servers.

Connect

Section titled “Connect”

The assistant signs in as you with OAuth: it opens LobbyVerse, you sign in and choose Allow. No key to paste. Your account needs a linked sign-in or a confirmed email, as for API keys.

  1. Claude (claude.ai and the desktop app): Settings, then Connectors, then Add custom connector. Paste the address and connect.

  2. ChatGPT: Settings, then Apps & Connectors. With developer mode on, add a connector with the address.

  3. Claude Code:

    Terminal window
    claude mcp add --transport http lobbyverse https://api.lobbyverse.com/mcp

    Then run /mcp and choose LobbyVerse to sign in.

  4. Cursor, VS Code and others: add an MCP server of type HTTP with the address. They open LobbyVerse to sign in.

You’ll find every assistant you connected on AI assistants in your account, with when it was last used, and can disconnect one there at any time.

Limits

Section titled “Limits”

An assistant’s calls count like API requests: 60 a minute and 10,000 a day, for all the assistants you connected together (or on the key, if it uses one). Past that it gets a 429 with Retry-After.

For client developers

Section titled “For client developers”

The server follows the MCP authorization spec:

  • An unauthenticated call gets a 401 whose WWW-Authenticate header names the protected resource metadata (RFC 9728).
  • That points to the authorization server at https://lobbyverse.com, described at /.well-known/oauth-authorization-server (RFC 8414).
  • Clients register themselves at /oauth/register (RFC 7591). Public clients use token_endpoint_auth_method: none.
  • The authorization code flow needs PKCE with S256, from every client. The one scope is read. Send resource=https://api.lobbyverse.com/mcp (RFC 8707).
  • Access tokens last an hour. Refresh tokens rotate: the old one stops working once the new access token is used.
  • Redirect URIs must be https, http to localhost or 127.0.0.1 on any port, or the app’s own scheme.

Tools

Section titled “Tools”

These come from the server itself, so they’re always the current set. Tools marked your account answer for the person who connected.

list_games

Games with servers online on LobbyVerse, busiest first, with their real player counts (bots and fake servers left out).

get_game

One game's servers online and real players, broken down by mode (surf, jailbreak…) and by country.

gamestring · required
A game's slug from list_games (counter-strike-2, counter-strike, team-fortress-2, garrys-mod…) or its Steam app id

search_servers

Find game servers with real players: LobbyVerse checks each server's player list, so fakes and bot farms are left out. Busiest first, or nearest first when given the player's location.

gamestring
A game's slug from list_games (counter-strike-2, counter-strike, team-fortress-2, garrys-mod…) or its Steam app id
modestring
A mode's slug: bomb-defusal, hostage-rescue, arena, surf, climb, zombies, jailbreak, deathrun, terror-town, roleplay, scp-breach, sandbox, capture-the-flag, control-points, payload, king-of-the-hill, mge-duels, territory, idle, trade, slender, campaign, objective, warcraft-3
countrystring
ISO 3166-1 alpha-2 country code of the server, e.g. DE
querystring
Words in the server's name or map
mapstring
Part of the map name, e.g. de_dust2
min_playersinteger
At least this many real players
not_fullboolean
Only servers with a free slot
tagsstring[]
What it should offer (from its name): free_vip, mix, 5v5, skins…
languagestring
The language its name says it's in: ru, pl, pt, tr, es…
latitudenumber
The player's latitude, to sort nearest first
longitudenumber
The player's longitude, to sort nearest first
limitinteger
How many, up to 25 (default 10)

get_server

Everything about one server by its address (ip:port): players now, map, mode, country, whether it's flagged as fake and why, its community and the link to join.

addressstring · required
The server's address, ip:port

find_server_to_join

The one server to join right now: a free slot, no password, real players before empty servers, nearest the player first. Answers with its connect_url (steam://connect/…).

gamestring · required
A game's slug from list_games (counter-strike-2, counter-strike, team-fortress-2, garrys-mod…) or its Steam app id
modestring
A mode's slug: bomb-defusal, hostage-rescue, arena, surf, climb, zombies, jailbreak, deathrun, terror-town, roleplay, scp-breach, sandbox, capture-the-flag, control-points, payload, king-of-the-hill, mge-duels, territory, idle, trade, slender, campaign, objective, warcraft-3
countrystring
ISO 3166-1 alpha-2 country code of the server, e.g. DE
latitudenumber
The player's latitude, to sort nearest first
longitudenumber
The player's longitude, to sort nearest first

list_communities

Gaming communities (the groups running several servers), ranked by real players over 7 days.

gamestring
A game's slug from list_games (counter-strike-2, counter-strike, team-fortress-2, garrys-mod…) or its Steam app id
querystring
Part of the community's name or website
limitinteger
How many, up to 25 (default 10)

get_community

One community by its slug (often its website, e.g. cybershoke.net): rank, real players, description, links and its servers.

slugstring · required
The community's slug from list_communities

top_servers

A game's top servers by average real players over the last 7 days, fakes left out.

gamestring · required
A game's slug from list_games (counter-strike-2, counter-strike, team-fortress-2, garrys-mod…) or its Steam app id
limitinteger
How many, up to 25 (default 10)

my_favoritesyour account

The servers the person starred on LobbyVerse, online first then busiest, with players now and the link to join.

my_serversyour account

The servers the person runs (claimed on LobbyVerse): whether each is online, its players now, and whether it's flagged.