Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
IB_COOKIESNoJSON array of cookies for a logged-in session. Do not ask a human to fill this by hand.
IB_HEADLESSNoDefault headless mode for tools that do not pass headless (true / false)
GOOGLE_API_KEYNoGoogle key (alternative for autonomous tool)
OPENAI_API_KEYNoOpenAI key for run_browser_use_task (one of the four keys for the autonomous tool)
IB_ALLOW_EVAL_JSNoEnable the evaluate_js debug tool (true / false, default false)false
ANTHROPIC_API_KEYNoAnthropic key (alternative for autonomous tool)
IB_VIEWPORT_WIDTHNoPlaywright viewport width (default 1280, clamped)1280
IB_VIEWPORT_HEIGHTNoPlaywright viewport height (default 800, clamped)800
BROWSER_USE_API_KEYNobrowser-use Cloud key (alternative for autonomous tool)
IB_CHROMIUM_NO_SANDBOXNoPass --no-sandbox to Chromium (default false; containers only)false

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Tools for Infinite Backlog (https://infinitebacklog.net/), built for site v2.1.0. They call the site's JSON API from inside a signed-in browser tab, the same calls the website makes. Before any browser opens, the user picks which one: the server asks through the client, or returns browser_choice_required; then relay the options to the user and call choose_browser with THEIR pick. Never choose a browser for the user. Launched browsers use this server's own private profile; no cookie file is read. Sign in once: login (uses IB_USERNAME/IB_PASSWORD from .env) or open_site and sign in in the window. The window stays visible because the site renders blank headless. Find games with search_games and pass the slug to the other tools (Hades 2020 is hades--1). A game can have several copies (one per platform); when it does, pass collection_id (list_collection_game_options shows them). Collection: add_game_to_collection, add_game_platform_copy, set_game_progress, set_game_details, set_game_acquisition, delete_game_copy (confirm=true). DLC/packs: list_related_content, list_collection_content_menus, add_game_content, remove_game_content. Ratings are per game: set_game_rating. Reviews: add_game_review (draft unless publish=true; publish needs 800+ chars and a score), delete_game_review. Play Records are per copy: list_play_records, set_play_record_category (keyValue/checkbox/progress/table/text), set_play_record, remove_play_record. Playthroughs and sessions: list_playthroughs, set_playthrough, remove_playthrough, add_play_session, remove_play_session, get_play_journal. Tags: list_custom_tags, set_game_tags, delete_custom_tag (custom tags need an IB supporter role; the API answers feature_locked otherwise). Stats and achievements: get_game, get_game_stats, list_achievements, get_user_stats, list_collection. Wishlist: list_wishlist, add_to_wishlist, remove_from_wishlist. Custom lists: list_my_lists, get_list, create_list, update_list, delete_list (drafts unless publish=true). Playtime contributions: list_playtime_contributions, submit_playtime (needs a Beaten/Completed copy and confirm=true). Play records sharing: copy_play_records, share_play_records. Deletes need confirm=true. Never change profile settings. API calls outside this server's allowlist are refused. Sign-in modes (the user picks one first): a browser tab used only to sign in and hold the token, or no browser at all (HTTP mode, using the .env account). Everything goes through the API; there are no page-scraping tools. Do not ask anyone to copy, export, or paste session cookies.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
choose_browserA

Pick the browser this server may use. Call it without arguments to list the options, then pass the id the USER picked; never choose for them.

Options: an already-open browser with a local debug port (uses its real profile, one new tab), a detected Chromium-based browser started with this server's private profile, Playwright's bundled Chromium, or "other" with the path of another Chromium-based browser. Changing the choice closes the current session first. Nothing opens until the next tool call.

open_siteB

Open a page on infinitebacklog.net in this server's browser window.

Asks which browser to use first if none was chosen. The window is visible by default (Infinite Backlog renders blank in headless mode). Sign in once there; later calls reuse it.

current_urlA

Return the current URL, the page title and which browser is in use.

close_browserA

Close this server's window. A browser it attached to keeps running; only its own tab closes.

loginB

Sign in with IB_USERNAME and IB_PASSWORD from the environment.

Types them into the Infinite Backlog login form. If either value is missing, nothing is typed. Use the Playwright window instead (open_site with headless=false).

search_gamesA

Search the Infinite Backlog catalog. Returns name, slug, year and category per hit.

Use the slug with the other tools. Duplicate titles get IGDB-style slugs (Hades 1995 is hades, Hades 2020 is hades--1).

get_gameC

Game details: summary, platforms, genres, developers, playtime averages, IB and critic scores, and your own collection/rating/wishlist state when signed in.

list_related_contentB

List DLC, expansions, packs/add-ons, editions, bundles, remakes and other related games.

Grouped the way the collection editor uses them: dlc (completion tracked), addons (packs, mods, updates), editions (bundles) and other. Public data; no login needed.

get_game_statsB

Community stats for a game: owners by status and completion, wishlist count, playtime averages, and rating distribution.

list_achievementsA

Achievements and trophies.

With slug: every achievement set for that game (Steam, PlayStation, Xbox, GOG, RetroAchievements) with your earned count when signed in. include_list=true also returns each achievement (name, description, unlocked state when synced). Without slug: your synced achievement games, newest first. Achievements come from linked store accounts. To track them by hand, use a checkbox Play Records category (set_play_record_category type=checkbox).

list_collectionC

List your collection. Filter by status (unplayed/playing/played/noStatus) or a title search.

list_collection_game_optionsB

Everything about your copies of one game: per-copy details, progress, acquisition, tags, DLC, play records id, playthroughs, your rating and your review. Read-only.

add_game_to_collectionA

Add a game to your collection (one copy on one platform). Refuses a second copy on the same platform unless allow_duplicate=true. For another platform use add_game_platform_copy.

add_game_platform_copyA

Add another copy of a game you already own, on another platform (its own progress, acquisition and play records).

set_game_progressB

Set progress on one copy: status (unplayed/playing/played/noStatus), completion (notStarted/unfinished/beaten/completed/continuous/dropped), progress bar 0-100, notes, playtime (hours + minutes, saved as manual unless playtime_type says otherwise), finished playthroughs count, and completion date (YYYY, YYYY-MM or YYYY-MM-DD). playtime_type: manual, playthrough or synced. clear_fields empties: notes, progress, playtime, times_completed, completion_date.

set_game_detailsC

Basic info on one copy: platform, ownership (owned, household, subscription, borrowed, rented, unlicensed, formerlyOwned, lentOut, other), digital true/false, region (pal/EU, ntsc-u/US, ntsc-j/JP, ntsc-c, australia, brazil, asia, korea, other), edition (slug of an edition from list_related_content), lent_to, borrowed_from. clear_fields: edition, region, lent_to, borrowed_from.

set_game_acquisitionB

Acquisition and condition on one copy. acquisition: purchase, subscription, gift, trade, keyBundle, promotionalCopy, reviewCopy, free, freeToPlay. source: store or shop name (matched to IB's purchase places). date YYYY-MM-DD. amount and additional_costs are normal prices in your IB currency (9.99); the tool stores them the way IB does. digital_service: steam, epicGameStore, gog, psn, xboxLive, nintendoEShop, ... state new/used. condition cib/incomplete/loose/sealed. condition_game/box/manual: mint/good/acceptable/poor/missing/na. clear_fields empties any of those names.

delete_game_copyB

Delete one copy from your collection, with its progress, acquisition and play records link. Needs collection_id and confirm=true.

list_collection_content_menusB

For one copy: DLC/expansions and packs/add-ons you already attached, and the ones you can still add. Read-only. (edit_path is accepted for v1 callers: /users/{u}/collection/{slug}/edit?id=N.)

add_game_contentA

Attach DLC, expansions, packs or add-ons to a copy you own. names: one title, a JSON array, or one title per line (game ids also work). Matches against the game's related content; already-attached items are skipped. completion (DLC only) sets their completion. platform/digital are ignored (they belong to the parent copy).

remove_game_contentA

Detach DLC/packs from a copy. Needs confirm=true. Does not touch the parent copy itself.

set_game_ratingA

Rate a game 1-10 overall, with optional 1-10 sub-ratings for Gameplay, Story, Visual, Audio and Playability. Ratings are per game, not per copy. clear=true removes your rating. Sub-ratings you leave blank keep their current value.

add_game_reviewA

Write or update your review. Saved as a draft unless publish=true. Publishing needs 800+ characters of text and an overall score (1-10). body is plain text (blank lines split paragraphs) or HTML. title 5-100 chars. pros/cons: JSON array or one per line. Re-running edits the same review.

delete_game_reviewA

Delete your review of a game. Drafts need confirm=true. A published review also needs published=true, so it is never removed by accident.

list_play_recordsB

Read the Play Records of one copy: every category (key/value, checklist, progress, table, text) and its rows, numbered from 1. Read-only.

set_play_record_categoryA

Add a Play Records category to one copy, or edit an existing one (matched by name or category_id). type (new categories, default keyValue): keyValue, checkbox, progress, table, text. layout: 1 or 2 columns. parent: put it under another category. rename: new name for an existing category. description_available / date_available: true/false to show those row fields. table_columns: column count for a new table. Categories belong to this copy only, not your profile.

set_play_recordA

Add or update one row in a Play Records category. action: add or update (update needs row_index, 1-based, or a matching name). keyValue: name + value. checkbox: name + unlocked=true/false (value=true also works). progress: name + progress_earned/progress_total (or value "3/10"), optional description. table: values as JSON array or "a | b | c". text: content (or value). earned_date YYYY-MM-DD where the category allows dates.

remove_play_recordA

Remove one row (row_index, 1-based) from a Play Records category, or the whole category when row_index is empty (needs confirm=true).

copy_play_recordsA

Copy the Play Records of one copy to another copy of the same game. The target must have no Play Records yet.

share_play_recordsC

Share the Play Records of one copy with another copy of the same game (share=true), or stop sharing with that copy (share=false).

list_playthroughsB

List playthroughs of one copy with their sessions (date, minutes, status, notes). A copy always shows a default "Playthrough" until you save one.

set_playthroughA

Create or edit a playthrough on one copy. create=true adds a new one; otherwise playthrough (id or name) picks the one to edit, and an unsaved default playthrough is saved first. type: firstPlaythrough, replay, speedrun, coop, competitive, continuous, streaming, achievements, challengeRun. playtime_type: session (sum of sessions) or playthrough (set hours/minutes directly). hours/minutes set the manual duration. extra_hours/extra_minutes set playtime_offset: minutes added on top of the session total.

remove_playthroughC

Delete a playthrough and all its sessions. Needs confirm=true.

add_play_sessionA

Log a play session (date YYYY-MM-DD, hours/minutes played, status, notes) on a playthrough of one copy. Pass session_id to edit an existing session instead. status: start, playing, campaignCompleted (beaten), completed, shelved, dropped. Sessions are capped at 24h each.

remove_play_sessionC

Delete one play session by id. Needs confirm=true.

get_play_journalB

Your recent play sessions across all games (the IB journal), newest first.

list_custom_tagsB

List your custom collection tags (name, color, description).

set_game_tagsB

Add or remove custom tags on one copy. add/remove: comma-separated names or a JSON array. Tags that do not exist yet are created only with create_missing=true (supporter feature; otherwise feature_locked).

delete_custom_tagA

Delete a custom tag from your tag library (it disappears from every game). Needs confirm=true.

list_wishlistB

List the games on your wishlist with notes, pre-order and favourite flags. Read-only.

add_to_wishlistA

Add a game to your wishlist. Optional notes and preorder ("true"/"false"; empty keeps the current value), applied also when the game is already on it.

remove_from_wishlistB

Remove a game from your wishlist. Needs confirm=true.

list_my_listsB

List your custom game lists (id, title, published, number of games, last update). Read-only.

get_listB

Read one custom list: title, description, published and ranked flags, and its games in order. Read-only.

create_listB

Create a custom game list. games: comma-separated game slugs or a JSON array. Saved as a draft unless publish=true (public).

update_listA

Edit your own custom list: title, description, add_games / remove_games (slugs or ids), ranked and publish ("true"/"false"). Only the fields you pass change.

delete_listB

Delete one of your custom lists. Needs confirm=true.

list_playtime_contributionsB

List the playtime figures you have submitted, newest first. Read-only.

submit_playtimeA

Submit your time to beat and time to complete a game to Infinite Backlog's public playtime data. Needs a copy marked Beaten or Completed and confirm=true. There is no delete: a submission can only be changed by submitting again.

get_user_statsA

Collection, activity, achievement and rating statistics for you (default) or another public profile. year (and optional month) adds that period's recap.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 50 tools

Disambiguation4/5

Most tools target clearly distinct resources and actions, and descriptions explain the boundaries between similar-looking tools such as add_game_to_collection vs add_game_platform_copy and the various set_game_* operations. There is still some potential confusion among the many collection/lists/play-record read tools and the browser-control tools mixed into the same surface.

Naming Consistency4/5

The set is overwhelmingly consistent snake_case verb_noun naming (list_collection, add_game_to_collection, set_game_progress, remove_play_session, delete_list). Minor deviations like current_url, login, and open_site are readable but not perfectly aligned with the dominant pattern.

Tool Count2/5

Fifty tools is very heavy for an MCP surface, even for a broad backlog-management domain. Many operations are legitimately distinct, but the count likely makes tool selection and schema overhead burdensome for an agent.

Completeness5/5

The surface covers the domain thoroughly: collection copies, progress, acquisition, tags, ratings, reviews, DLC, play records, playthroughs, sessions, custom lists, wishlist, achievements, stats, and browser/session handling. Obvious lifecycle operations have corresponding create/read/update/delete or equivalent tools.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues