Infinite Backlog MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IB_COOKIES | No | JSON array of cookies for a logged-in session. Do not ask a human to fill this by hand. | |
| IB_HEADLESS | No | Default headless mode for tools that do not pass headless (true / false) | |
| GOOGLE_API_KEY | No | Google key (alternative for autonomous tool) | |
| OPENAI_API_KEY | No | OpenAI key for run_browser_use_task (one of the four keys for the autonomous tool) | |
| IB_ALLOW_EVAL_JS | No | Enable the evaluate_js debug tool (true / false, default false) | false |
| ANTHROPIC_API_KEY | No | Anthropic key (alternative for autonomous tool) | |
| IB_VIEWPORT_WIDTH | No | Playwright viewport width (default 1280, clamped) | 1280 |
| IB_VIEWPORT_HEIGHT | No | Playwright viewport height (default 800, clamped) | 800 |
| BROWSER_USE_API_KEY | No | browser-use Cloud key (alternative for autonomous tool) | |
| IB_CHROMIUM_NO_SANDBOX | No | Pass --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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 50 tools
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.
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.
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.
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.