Infinite Backlog MCP Server
You can manage an Infinite Backlog account through deterministic browser tools and add browser-automation helpers.
Search the game catalog and inspect related content, collection-content menus, and per-game collection options.
Manage collection copies: add platform copies, set progress/status/notes, set acquisition info, and delete copies with confirmation.
Manage ratings, reviews, and play records: set/clear ratings, add/update/delete reviews, and add/update/remove play-record categories and rows.
Automate the website: open pages, get current URL, read page text/HTML/links, click, fill, take screenshots, set restricted cookies, and run JavaScript when enabled.
Run an autonomous browser-use agent for multi-step Infinite Backlog tasks if browser-use and an LLM API key are configured.
Safety controls apply: destructive actions require confirm, password/credential fields are refused, cookies are limited to infinitebacklog.net, and eval JS is disabled by default.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Infinite Backlog MCP Server find Elden Ring and rate it 9/10 with a review saying it's a masterpiece"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Infinite Backlog MCP
An MCP server that lets an AI assistant manage your Infinite Backlog account.
Goals
Let your assistant read and update your Infinite Backlog collection without you clicking through the site.
Use the same calls the website makes, so the results match what you see in your account.
Stay safe by default: nothing deletes, publishes or posts unless you ask for it.
Built for Infinite Backlog v2.1.0. This is an unofficial project, not affiliated with Infinite Backlog. It uses the site's private API, which can change without notice. Check Infinite Backlog's terms before heavy use.
Related MCP server: CloakBrowser MCP
What it can do
Catalog: search games, game info, community stats, DLC and editions, achievements and trophies.
Collection: add games and platform copies, set status, progress, playtime, notes, details and acquisition.
Ratings and reviews: overall and sub-ratings, reviews saved as drafts or published.
Play records: your own notes and checklists per copy (key/values, checklists, progress bars, tables, text).
Playthroughs and sessions: log playthroughs and play sessions, read your play journal.
Tags: custom tags on your copies.
Wishlist and lists: manage your wishlist and your custom lists.
Playtime: submit time to beat and time to complete, and read what you submitted.
Stats: your collection, activity and yearly stats.
What it can't do
Read or click through web pages. Every tool uses the site's API.
Change your profile, settings, widgets, friends or feed.
Post to the community feed.
Publish a list or submit playtimes unless you ask for it.
Sign in past a captcha or second factor. You finish those by hand (browser mode) or switch modes.
Call any API endpoint that isn't on its allowlist, or open any site other than infinitebacklog.net.
Installation
Install Python 3.11 or newer.
Set up the server:
cd infinitebacklog-mcp python -m venv .venv .venv\Scripts\activate pip install -e . python -m playwright install chromium # only for the bundled browser optionCopy
.env.exampleto.envand fill inIB_USERNAME(username or email) andIB_PASSWORD. Thelogintool uses them. HTTP mode needs them. In a browser mode you can sign in by hand instead. Never commit.env.Add the server to your MCP client:
{ "mcpServers": { "infinitebacklog": { "command": "C:/path/to/infinitebacklog-mcp/.venv/Scripts/python.exe", "args": ["-m", "infinitebacklog_mcp.server"], "cwd": "C:/path/to/infinitebacklog-mcp" } } }After
pip install -e .you can use"command": "infinitebacklog-mcp"instead. Logs go to stderr.Start your MCP client. The first tool call asks which sign-in mode to use. You can also call
choose_browseryourself.Sign in once. In a browser mode, the server signs in with
.envwhen the browser first opens, or you can calllogin, or sign in by hand in the window. In HTTP mode, the server signs in with.envon the first call. Nothing opens.Try
search_gamesandlist_collection.
Sign-in modes
Nothing signs in or opens until you choose a mode. The choice lasts until the server stops and is never written to disk. To skip the question, set IB_BROWSER.
Browser modes. A window opens. Sign in there by hand, or let the server fill in IB_USERNAME and IB_PASSWORD. The session is saved in the server's profile folder and reused. The window stays visible, because Infinite Backlog renders blank in headless browsers. The options:
a Chromium-based browser that is your system default or currently open, started with the server's own private profile
Playwright's bundled Chromium, also with a private profile
an already-open browser with a local debug port (
--remote-debugging-port=9222, orIB_CDP_URL). This uses that browser's real profile and opens one new tab. You opt in to this one.any other Chromium-based browser you point to by path
Firefox and Safari can't be driven this way. Pick the bundled Chromium if one of them is your default. The server never reads cookies or profile data from your everyday browser.
HTTP mode. No browser. The server signs in through Infinite Backlog's own login form over HTTPS, with the standard authorization code and PKCE flow, then refreshes the token as needed. It identifies itself as infinitebacklog-mcp. It solves no captchas. If the login asks for a captcha or 2FA, it stops with browser_sign_in_required, and you switch to a browser mode. In HTTP mode, open_site and current_url don't apply.
Browser mode | HTTP mode | |
Needs a browser | Yes | No |
Sign in by hand | Yes | No |
Needs | Optional | Yes |
Captcha or 2FA | Yes, by hand in the window | No, the server stops and asks you to switch |
Neither mode writes tokens to disk. The password is never logged or returned.
Supported tools
Games are identified by their slug from search_games. You can own a game more than once, one copy per platform. Progress, acquisition, DLC, tags, play records and playthroughs belong to a copy. Ratings and reviews belong to the game. When a game has several copies, pass collection_id (shown by list_collection_game_options).
Anything that deletes needs confirm=true.
Catalog and game info
Tool | What it does |
| Search the catalog. Returns name, slug, year, type. |
| Summary, platforms, developers, scores, average playtimes, and your status for that game. |
| DLC, expansions, packs and add-ons, editions, bundles, remakes. |
| Community numbers: owners per status and completion, wishlists, rating distribution. |
| Achievement and trophy sets (Steam, PlayStation, Xbox, GOG, RetroAchievements) with your progress. |
Your collection
Tool | What it does |
| Your games, filterable by status or title. |
| Everything about your copies of one game. |
| Add a game on a platform, physical or digital, with a starting status. |
| Add another copy on a different platform. |
| Status, completion, progress bar (0-100), notes, playtime and playtime type, times finished, completion date. |
| Platform, ownership, digital or physical, region, edition, lent to or borrowed from. |
| How and where you got it, date, price, notes, digital store, and condition for physical copies. |
| Remove one copy. |
DLC and add-ons
Tool | What it does |
| DLC and packs attached to a copy, and the ones you can still add. |
| Attach DLC, expansions, packs or add-ons by name (or IGDB id). Already-owned items are skipped. |
| Detach them again. |
Ratings and reviews
Tool | What it does |
| Overall 1-10, plus Gameplay, Story, Visual, Audio and Playability. |
| Write or edit a review. A draft unless |
| Delete it. A published review also needs |
Play records
Play records are your own notes and checklists for a copy, grouped in categories. Five types:
keyValue: name and value ("Final boss" / "Beaten")checkbox: a checklist, with optional earned dates (good for tracking achievements by hand)progress: earned / total, with an optional descriptiontable: rows of columnstext: one free-text note
Tool | What it does |
| All categories and rows, numbered from 1. |
| Add, nest, rename or restyle a category. |
| Add a row, or update one by number or name. |
| Remove a row, or a whole category. |
| Copy one copy's play records to another copy of the same game. The target must have none yet. |
| Share with another copy of the same game ( |
Playthroughs and sessions
Tool | What it does |
| Playthroughs of a copy with their sessions. |
| Create or edit one: name, type, difficulty, notes, playtime. |
| Delete a playthrough and its sessions. |
| Log a session: date, time played, status, notes. Pass |
| Delete a session. |
| Your latest sessions across all games. |
Tags and stats
Tool | What it does |
| Your custom tags. |
| Add or remove tags on a copy. Creating new tags needs an Infinite Backlog supporter account (otherwise |
| Remove a tag from your library. |
| Collection, activity, achievement and rating stats, plus a yearly or monthly recap. |
Wishlist
Tool | What it does |
| Your wishlist, with notes, pre-order and favourite flags. |
| Add a game, or update one already on the list ( |
| Remove a game. Needs |
Custom lists
Lists are public once published, so they stay drafts unless you pass publish=true. Only your own lists can be changed or deleted.
Tool | What it does |
| Your lists: title, published flag, number of games, last update. |
| One list with its games in order. |
| New list from comma-separated game slugs. |
| Change |
| Delete one of your lists. Needs |
Playtime contributions
Submitted times go to Infinite Backlog's public playtime data. There is no delete. Submitting again replaces your figures.
Tool | What it does |
| The playtime figures you have submitted, newest first. |
| Submit time to beat and time to complete. Needs a copy marked Beaten or Completed, and |
Session
Tool | What it does |
| List the sign-in options, or record the one you picked (including HTTP mode). |
| Sign in with |
| Browser modes only. Open a page in the server's window, show where it is, close it. |
Settings
Variable | Default | Purpose |
| empty | Sign-in for |
| empty (ask) | Pre-approve a sign-in mode: |
| empty | Pre-approve a specific Chromium-based browser by path. |
|
| Local debug endpoint for the attach option. Only localhost is accepted. |
|
| Leave it off: the site renders blank headless. Browser modes only. |
| 1280 x 800 | Window size. Browser modes only. |
|
| Containers only. |
Supported Platforms
Windows only for now. Other systems are untested. The code is written for them, so reports are welcome.
More
docs/api-v2.md: the endpoints and payloads this server uses. If Infinite Backlog changes its API, start there.
AGENTS.md: notes for assistants calling the tools.
CHANGELOG.md: what changed in each release.
License
MIT. See LICENSE.
Available Tools
50 toolsadd_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).
Inputs: names (required), parent_slug (required), digital, wait_ms, +3 more. Returns: result
add_game_platform_copyA
Add another copy of a game you already own, on another platform (its own progress, acquisition and play records).
Inputs: slug (required), platform (required), submit, digital. Returns: result
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.
Inputs: body (required), slug (required), cons, pros, +10 more. Returns: result
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.
Inputs: slug (required), status, digital, platform, +1 more. Returns: result
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.
Inputs: date (required), slug (required), hours, notes, +5 more. Returns: result
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.
Inputs: slug (required), notes, preorder. Returns: result
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.
Inputs: path, choice. Returns: result
close_browserA
Close this server's window. A browser it attached to keeps running; only its own tab closes.
Inputs: no named parameters. Returns: result
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.
Inputs: slug (required), to_collection_id (required), from_collection_id (required). Returns: result
create_listB
Create a custom game list. games: comma-separated game slugs or a JSON array. Saved as a draft unless publish=true (public).
Inputs: title (required), games, ranked, publish, +3 more. Returns: result
current_urlA
Return the current URL, the page title and which browser is in use.
Inputs: no named parameters. Returns: result
delete_custom_tagA
Delete a custom tag from your tag library (it disappears from every game). Needs confirm=true.
Inputs: name (required), confirm. Returns: result
delete_game_copyB
Delete one copy from your collection, with its progress, acquisition and play records link. Needs collection_id and confirm=true.
Inputs: slug (required), confirm, collection_id. Returns: result
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.
Inputs: slug (required), confirm, published. Returns: result
delete_listB
Delete one of your custom lists. Needs confirm=true.
Inputs: list_id (required), confirm. Returns: result
get_gameC
Game details: summary, platforms, genres, developers, playtime averages, IB and critic scores, and your own collection/rating/wishlist state when signed in.
Inputs: slug (required), full. Returns: result
get_game_statsB
Community stats for a game: owners by status and completion, wishlist count, playtime averages, and rating distribution.
Inputs: slug (required). Returns: result
get_listB
Read one custom list: title, description, published and ranked flags, and its games in order. Read-only.
Inputs: list_id (required). Returns: result
get_play_journalB
Your recent play sessions across all games (the IB journal), newest first.
Inputs: limit, offset. Returns: result
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.
Inputs: year, month, username. Returns: result
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).
Inputs: slug, limit, max_per_set, include_list. Returns: result
list_collectionC
List your collection. Filter by status (unplayed/playing/played/noStatus) or a title search.
Inputs: sort, limit, order, offset, +2 more. Returns: result
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.
Inputs: slug (required), wait_ms, collection_id. Returns: result
list_custom_tagsB
List your custom collection tags (name, color, description).
Inputs: no named parameters. Returns: result
list_my_listsB
List your custom game lists (id, title, published, number of games, last update). Read-only.
Inputs: limit, offset. Returns: result
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.
Inputs: slug (required), wait_ms, collection_id. Returns: result
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.
Inputs: slug (required), collection_id. Returns: result
list_playtime_contributionsB
List the playtime figures you have submitted, newest first. Read-only.
Inputs: limit, offset. Returns: result
list_wishlistB
List the games on your wishlist with notes, pre-order and favourite flags. Read-only.
Inputs: limit, offset. Returns: result
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).
Inputs: headless. Returns: result
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.
Inputs: path, wait_ms, headless. Returns: result
remove_from_wishlistB
Remove a game from your wishlist. Needs confirm=true.
Inputs: slug (required), confirm. Returns: result
remove_game_contentA
Detach DLC/packs from a copy. Needs confirm=true. Does not touch the parent copy itself.
Inputs: names (required), parent_slug (required), confirm, collection_id. Returns: result
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).
Inputs: slug (required), category (required), confirm, wait_ms, +2 more. Returns: result
remove_play_sessionC
Delete one play session by id. Needs confirm=true.
Inputs: slug (required), session_id (required), confirm, collection_id. Returns: result
remove_playthroughC
Delete a playthrough and all its sessions. Needs confirm=true.
Inputs: slug (required), playthrough (required), confirm, collection_id. Returns: result
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).
Inputs: query (required), limit, offset. Returns: result
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.
Inputs: slug (required), date, notes, state, +11 more. Returns: result
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.
Inputs: slug (required), region, digital, lent_to, +6 more. Returns: result
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.
Inputs: slug (required), hours, notes, status, +8 more. Returns: result
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.
Inputs: slug (required), audio, clear, score, +6 more. Returns: result
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).
Inputs: slug (required), add, color, remove, +2 more. Returns: result
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.
Inputs: slug (required), category (required), name, value, +11 more. Returns: result
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.
Inputs: name (required), slug (required), type, layout, +10 more. Returns: result
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.
Inputs: slug (required), name, type, hours, +9 more. Returns: result
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.
Inputs: slug (required), confirm, beaten_hours, beaten_minutes, +2 more. Returns: result
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.
Inputs: list_id (required), title, ranked, publish, +3 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Let your AI agent operate any website through a real, logged-in browser session.
Playwright browser automation — navigate, click, fill forms, extract, screenshot — 17 agent tools.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to drive a Chromium-based browser for web research, testing, and automation with Playwright-compatible tools, persistent profiles, proxy matching, extension loading, and humanized input across local or containerized deployments.280 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to automate Chromium browsing with Playwright-compatible tools for web research, testing, and routine tasks, including persistent profiles, extensions, proxy-aware regional QA, and humanized input over npm or Docker.280 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to automate real Chromium browsing with Playwright-compatible tools, supporting web research, testing workflows, persistent profiles, proxies, extensions, and stdio or Streamable HTTP deployment.280 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables agents to control a visible Chromium browser via Playwright with tools for tabs, page reading, element finding, form input, mouse/keyboard actions, screenshots, console/network inspection, JavaScript execution, viewport emulation, and batched calls.17 npmMIT