addCollection
ChatGPTPREMIUM. Collections / コレクション: create an INDIVIDUAL (listed gameIds), TAG (games in a tag), or PLATFORM (games on a platform) collection.
addConsole
ChatGPTLIGHT+. Owned hardware / 所有ゲーム機: add a console the user owns (not a platform master; see listPlatforms). platformPriorities lists which platforms it plays.
addConsoleMaintenanceLog
ChatGPTLIGHT+. Maintenance / メンテ: add a log to an owned console. status SCHEDULED uses scheduledDate; DONE uses completedDate.
addCustomCompany
ChatGPTPREMIUM. Custom company / カスタム会社: create your own company entry. Only when the user asks for a company that listCompanies does not have.
addCustomGame
ChatGPTPREMIUM. Custom game / カスタムゲーム: create your own game entry. Only when the user asks to register a game RGG does not cover: run searchGames first (also try a hiragana reading) so you do not duplicate the public master. platformId and publisherId may be public or your custom entries.
addCustomPlatform
ChatGPTPREMIUM. Custom platform / カスタム機種: create your own platform entry. Only when the user asks for a platform that listPlatforms does not have. Not an owned console (use addConsole).
addPhysicalCopy
ChatGPTPREMIUM. Physical copies / 所有ソフト追加: library entry required (use addToLibrary if missing). Choose mode by intent: materialize = record details of the copy the user already owns (only when no copies exist; inherits library fields). additional = the user got another copy; when no copies exist it creates TWO rows atomically (the inherited original + the new one). quantity defaults to 1. makeActive:true makes the new copy the representative and overwrites the library's purchase data, rating, memo and attributes; tell the user. Pass revision from getPhysicalCopies or from the previous successful add/update/remove. Do not send that revision to removePhysicalCopy; start a remove preview instead. Re-read after uncertain results; do not blindly retry.
addPlayLog
ChatGPTPlay logs / プレイログ: record that the user played a game (one session). Pass gameId to log on that game's current record (the one shown in getPlayRecords), or playId to target a specific record (e.g. a PREMIUM past cycle from getGamePlayHistory). playTime (minutes played, e.g. 2 hours = 120) and memo (what you played) are required. Omit playDate to use today (JST).
addPlayRecord
ChatGPTPlay records / プレイ記録: create the first record for a game in the library (owned games only; addToLibrary first), or set replay=true to start again. Replay on FREE/LIGHT deletes the latest record and its logs (play:delete + confirm). PREMIUM keeps history and is not idempotent — after a successful replay, identify the new playId and consult getGamePlayHistory before retrying. status defaults to PLANNED; replay always starts PLAYING.
addTag
ChatGPTLIGHT+. Tags / タグ: create a user tag. Omit color to let the server pick an unused preset; do not ask the user only to choose a color.
addToLibrary
ChatGPTLibrary / 所有ソフト: add a game the user bought or owns. If it is on the wishlist, that wishlist row is removed and its date, price, place, memo, reference sites and images are inherited unless you override them. Attributes are not inherited (wishlist and library use different attribute sets).
addToLibraryBatch
ChatGPTLibrary / 所有ソフト一括追加: add up to 100 owned games in one call, e.g. after resolving a spreadsheet with searchGamesBatch. Show the list to the user and get their OK first; dryRun: true previews each row without saving. Rows already in the library are skipped; unknown gameIds are reported as not_found. Games on the wishlist are moved and inherit its values, same as addToLibrary. If the plan limit would be exceeded, nothing is added. Retrying the same items is safe: saved rows are skipped, and wishlist entries left behind by a failed move are removed.
addToWishlist
ChatGPTWishlist / 欲しいもの: add a game the user wants. A game already in the library cannot be added (already_exists).
browseGames
ChatGPTPREMIUM. Games / 探索: browse public and PREMIUM custom games by platform, genre, publisher or release date, with page/limit. Conditions only (no identifying term; use searchGames for a title). Pass genreId from listGenres for both root and support genres. Default 20, max 100; editions/specs/supportGenre (default fields) cap at 50, externalLinks at 25. Pass fields: [] for core rows.
browseTagGames
ChatGPTLIGHT+. Tag games / タグのゲーム: explore games in one user tag by tagId from getTags (not by tag name), with page/limit.
getAccount
ChatGPTAccount / アカウント: current plan and registration usage. Call once per session, and again only right before a bulk add; no need before each write (limit errors are explicit). limits lists only what this plan and token can use; max is omitted when unlimited. used counts games: library/wishlist = one per game (physical copies are not counted), activePlays = PLAYING/PAUSED and finishedPlays = COMPLETED/DROPPED counted on the latest record per game (PLANNED is not counted; PREMIUM past cycles are not added, and those limits are unlimited anyway), custom* = your master entries. Tag, collection and console counts are not included; read totalCount from getTags / getCollections / getConsoles. usage = today's MCP/API usage (usedPercent, resetAt in JST); if it is high, tell the user before a bulk add. The tool list can be stale after a plan change: a plan_required error means this plan cannot use it; tell the user instead of retrying.
getCalendarEvents
ChatGPTCalendar / 月次イベント: derived events for one YYYY-MM month from library, wishlist, play, and consoles. Game events include title and platform. Release anniversaries are omitted. PLAY_START is omitted when the play starts and ends on the same day. Omitted types are listed with reasons.
getCollectionGames
ChatGPTPREMIUM. Collection games / コレクションの達成状況: games in one collection, with achievement calculated on this call. summary is the unfiltered collection (totalGames, achievedGames, achievementRate, isCompleted). Default sort is releaseDate asc (same as the app). game is always included (page capped at 100). Tag and platform collections honor excludeGameIds. achievedAt is a date (play end date) or a datetime (library registration / play update). IDs that cannot be name-resolved are returned as game: { gameId } only.
getCollections
ChatGPTPREMIUM. Collections / コレクション: list collections with page/limit. Default sort is priority desc (same as the app). Achievement is not included — use getCollectionGames. revision is always returned for member replace.
getConsoleMaintenanceLogs
ChatGPTLIGHT+. Maintenance / メンテ: list logs for one owned console with page/limit.
getConsoles
ChatGPTLIGHT+. Owned hardware / 所有ゲーム機: list consoles with page/limit. Default sort is rating desc (same as the app). Maintenance history is omitted.
getGameDetail
ChatGPTGame detail / ゲーム詳細: look up one game by numeric gameId. All field groups are returned by default (fields narrows them), with completed external URLs. Coverage: 日本発売のレトロゲームのみ / Japan-only retro games.
getGamePlayHistory
ChatGPTPREMIUM. Play history / ゲーム別履歴: all play records for one game, newest first. Use getPlayLogs(playId) for logs.
getGamesBatch
ChatGPTGames / ゲーム一括: fetch up to 20 games by numeric gameId. Detailed fields are the default. Ids not in coverage (or not visible on your plan) are listed in notFoundGameIds. Extra ids beyond the limit are not fetched; they are returned in omittedGameIds with limitReduced: true.
getLibrary
ChatGPTLibrary / 所有ソフト: list games the user owns, with filters and page/limit. Request memo or latestPlay in fields when needed; latestPlay requires play:read.
getLibraryAnalytics
ChatGPTLibrary analytics / 所有ソフトの分析: stats for owned games, including money spent. Matches the in-app analysis dialog. Default section is summary only. summary.pricedCount = games with a price (the base of totalAmount); purchase.yearly/monthly omit games without buyDate. All plans use library rows (not physical copies): a game with several copies counts once, at its representative copy's price, so the in-app LIGHT/PREMIUM total may be higher. Say so when answering how much the user spent; sum getPhysicalCopies for the per-copy total. Filters match getLibrary; buyDateFrom/buyDateTo still apply only to purchase amounts.
getPhysicalCopies
ChatGPTPREMIUM. Physical copies / 物理明細: list saved copies and the whole-game revision. libraryEntryExists distinguishes an unmaterialized owned game from a missing library entry. Analytics still count library entries, not copies.
getPlayAnalytics
ChatGPTPlay analytics / プレイ記録の分析: stats for play records and play time. Default section is summary only. monthlyTrend.endedCount is status-agnostic; monthlyResults splits clears vs dropped. Attribute counts can exceed record counts. playTimeTrend reads PlayLog minutes for at most 90 JST days. Default uses the latest record per game. Filters match getPlayRecords.
getPlayLogs
ChatGPTPlay logs / プレイログ: list logs for a play record you own with page/limit. Pass the playId from getPlayRecords or getGamePlayHistory. Request memo in fields when needed.
getPlayRecords
ChatGPTPlay records / プレイ記録: what the user is playing, cleared, dropped or has in the backlog; latest record per game with filters and page/limit. Request memo in fields when needed. Use getGamePlayHistory for PREMIUM past cycles; getPlayLogs(playId) for logs. PLANNED = the backlog the user means to play, so statuses:["PLANNED"] answers "what is piled up" and "what to play next"; it is not a never-played flag.
getTags
ChatGPTLIGHT+. User tags / タグ: list your tags with page/limit. Returns gameCount; use browseTagGames for the games. Request description in fields for long notes.
getWishlist
ChatGPTWishlist / 欲しいもの: list games the user wants, with filters and page/limit. Request memo in fields when needed.
listAttributes
ChatGPTAttributes / 属性: list built-in and custom attributes for library, wishlist, or play. Custom attributes are returned regardless of plan. Use id or exact label in attributes filters.
listCompanies
ChatGPTCompanies / 会社・メーカー: list publishers/companies in the public master plus PREMIUM custom companies (page/limit, ordered by companyId). Use hasMore to fetch the next page.
listGenres
ChatGPTGenres / ジャンル: list genres used by the RGG public game master (page/limit after filters, ordered by genreId). Filter with query (name/kana/en, or exact genreId when numeric), category (primary/genre/series/licensed), root, or parentGenreId. Every returned genreId can be passed to search, browse, personal lists, and analytics as genreId.
listPlatforms
ChatGPTPlatforms / 機種: list platforms in RGG coverage (page/limit, ordered by platformId). LIGHT/PREMIUM include platformId 500–599. Coverage: 日本発売レトロ機種のみ。
removeCollection
ChatGPTPREMIUM. Collections / コレクション: delete a collection (the games themselves stay). Requires library:delete.
removeConsole
ChatGPTLIGHT+. Owned hardware / 所有ゲーム機: delete one console. Requires play:delete. Also deletes its maintenance logs. Fails while any play record (including earlier records of replayed games) is linked to it: unlink with updatePlayRecord consoleId null first.
removeConsoleMaintenanceLog
ChatGPTLIGHT+. Maintenance / メンテ: delete one log. Requires play:delete.
removeCustomCompany
ChatGPTPREMIUM. Custom company / カスタム会社: delete your company entry. Requires games:delete.
removeCustomGame
ChatGPTPREMIUM. Custom game / カスタムゲーム: delete your game entry. Requires games:delete.
removeCustomPlatform
ChatGPTPREMIUM. Custom platform / カスタム機種: delete your platform entry. Requires games:delete.
removeFromLibrary
ChatGPTLibrary / 所有ソフト削除: remove a game from the library. Requires library:delete. Not a bulk wipe. Also deletes all related play records (with their play logs) and owned copies (所有ソフト); tell the user before confirming.
removeFromWishlist
ChatGPTWishlist / 欲しいもの削除: remove a wishlist entry. Requires library:delete.
removePhysicalCopy
ChatGPTPREMIUM. Physical copies / 所有ソフト削除: confirm deletion of one whole row, including all its quantity. Do not send revision; the first call is a preview that binds the current server revision into confirmToken. Reuse a previous write's revision on the next add or revision-taking update, not on remove. Deleting the representative promotes another copy. Deleting the last row retains the library entry and its values/images; use removeFromLibrary to stop owning the game.
removePlayLog
ChatGPTPlay logs / プレイログ削除: delete a play log. Requires play:delete.
removePlayRecord
ChatGPTPlay records / プレイ記録削除: delete a play record. Requires play:delete. Also deletes its play logs.
removeTag
ChatGPTLIGHT+. Tags / タグ: delete a tag. Requires library:delete.
searchGames
ChatGPTGames / ゲーム検索: find games by title, nickname, JAN, model number, or external id. RGG holds no game content, walkthroughs or edition differences: read and cite externalLinks pages for those, not memory. Requires one identifying term. Use browseGames (PREMIUM) to explore by conditions only. Limit default 10. Ordered by match strength (identifier, exact title, alias, prefix, partial), then release date. No paging: when hasMore, narrow with platformIds or releaseDateFrom/To; platformCounts shows where the matches are. If a title returns nothing, retry with a short hiragana reading or abbreviation before concluding it is outside coverage. Each item has matchedBy: janCode / modelNumber / externalId / gameId = identifier; title / titleEn = official title; alias = hiragana reading or nickname, not the official title; confirm with the user. exact: true when the whole query equals the matched value. edition: true when an edition's JAN or model number matched, so specs may differ from the query.
searchGamesBatch
ChatGPTGames / ゲーム一括同定: identify up to 20 games in one call, e.g. rows from a spreadsheet or list the user gave you. Each row needs one identifying term (query, janCode, modelNumber, or externalId) and may narrow with platformIds or release dates. Each row returns up to perRowLimit candidates (default 3, max 5) ordered like searchGames, with matchedBy / exact / edition. No paging: if a row is ambiguous or not found, ask the user or call searchGames for that row with more conditions. Show the resolved list to the user before adding games (addToLibraryBatch).
searchNews
ChatGPTNews / ニュース: search retained RGG news (max 500, short TTL cache). Not a live web search. Space-separated terms must all match (title, or summary for non-YouTube). summary is cut at 200 characters. games:read.
updateCollection
ChatGPTPREMIUM. Collections / コレクション: patch basic info, INDIVIDUAL gameIds, or TAG/PLATFORM excludeGameIds. Omit a key to keep it; send null to clear a nullable field. Replacing gameIds or excludeGameIds requires revision from getCollections.
updateConsole
ChatGPTLIGHT+. Owned hardware / 所有ゲーム機: patch one console. Omit a key to keep it; send null to clear a nullable field.
updateConsoleMaintenanceLog
ChatGPTLIGHT+. Maintenance / メンテ: patch one log. Omit a key to keep it; send null to clear a nullable field.
updateCustomCompany
ChatGPTPREMIUM. Custom company / カスタム会社: patch your company entry. Omit a key to keep it; send null to clear a nullable field.
updateCustomGame
ChatGPTPREMIUM. Custom game / カスタムゲーム: patch your game entry. Omit a key to keep it; send null to clear a nullable field.
updateCustomPlatform
ChatGPTPREMIUM. Custom platform / カスタム機種: patch your platform entry. Omit a key to keep it; send null to clear a nullable field.
updateLibraryEntry
ChatGPTLibrary / 所有ソフト: patch one owned game. Omit a key to keep it, send null to clear, [] to clear arrays.
updatePhysicalCopy
ChatGPTPREMIUM. Physical copies / 物理明細更新・代表切り替え: Patch an existing copy. makeActive:true alone switches representative and requires revision. Active copy changes mirror to the library, including clearing fields absent from the selected copy. Pass revision from getPhysicalCopies or from the previous successful add/update/remove. removePhysicalCopy does not take revision.
updatePlayLog
ChatGPTPlay logs / プレイログ: patch a log. Only supplied keys are updated. memo cannot be cleared.
updatePlayRecord
ChatGPTPlay records / プレイ記録: patch one record including status. Omit a key to keep it, send null to clear, [] to clear arrays. Status changes apply play limits and default dates; an explicit playEndDate overrides the default.
updateTag
ChatGPTLIGHT+. Tags / タグ: patch tag name, kana, color, or description. Use updateTagGames for membership.
updateTagGames
ChatGPTLIGHT+. Tags / タグ割当: add, remove, or replace gameIds for one tag. replace requires the full set plus the tag revision.
updateWishlistEntry
ChatGPTWishlist / 欲しいもの: patch one wishlist game. Omit a key to keep it, send null to clear, [] to clear arrays.
addCollection
ClaudeaddConsole
ClaudeaddConsoleMaintenanceLog
ClaudeaddCustomCompany
ClaudeaddCustomGame
ClaudeaddCustomPlatform
ClaudeaddPhysicalCopy
ClaudeaddPlayLog
ClaudeaddPlayRecord
ClaudeaddTag
ClaudeaddToLibrary
ClaudeaddToLibraryBatch
ClaudeaddToWishlist
ClaudebrowseGames
ClaudebrowseTagGames
ClaudegetAccount
ClaudegetCalendarEvents
ClaudegetCollectionGames
ClaudegetCollections
ClaudegetConsoleMaintenanceLogs
ClaudegetConsoles
ClaudegetGameDetail
ClaudegetGamePlayHistory
ClaudegetGamesBatch
ClaudegetLibrary
ClaudegetLibraryAnalytics
ClaudegetPhysicalCopies
ClaudegetPlayAnalytics
ClaudegetPlayLogs
ClaudegetPlayRecords
ClaudegetTags
ClaudegetWishlist
ClaudelistAttributes
ClaudelistCompanies
ClaudelistGenres
ClaudelistPlatforms
ClauderemoveCollection
ClauderemoveConsole
ClauderemoveConsoleMaintenanceLog
ClauderemoveCustomCompany
ClauderemoveCustomGame
ClauderemoveCustomPlatform
ClauderemoveFromLibrary
ClauderemoveFromWishlist
ClauderemovePhysicalCopy
ClauderemovePlayLog
ClauderemovePlayRecord
ClauderemoveTag
ClaudesearchGames
ClaudesearchGamesBatch
ClaudesearchNews
ClaudeupdateCollection
ClaudeupdateConsole
ClaudeupdateConsoleMaintenanceLog
ClaudeupdateCustomCompany
ClaudeupdateCustomGame
ClaudeupdateCustomPlatform
ClaudeupdateLibraryEntry
ClaudeupdatePhysicalCopy
ClaudeupdatePlayLog
ClaudeupdatePlayRecord
ClaudeupdateTag
ClaudeupdateTagGames
ClaudeupdateWishlistEntry
Claude