bookreport_commit_catalog_edit_session
ChatGPTThis is the destructive Catalog Editing operation. After showing the latest preview and receiving confirmation, atomically persist the changes only when preview_token still matches the draft revision and Catalog state. If the Catalog changed or the preview is stale, refresh the targeted Catalog and rebuild or re-preview before asking again. After any ambiguous timeout or server failure, inspect the session with bookreport_get_catalog_edit_session before retrying: if committed, stop; if draft, re-preview as needed and obtain fresh confirmation. Returns: Catalog Owner identity, atomically committed change summaries, and safe Catalog Edit Attribution.
bookreport_create_catalog_edit_session
ChatGPTCreates an empty draft Catalog Edit Session for the explicitly selected Catalog Owner. First list Editable Catalogs and copy the intended Catalog Owner Public Account ID, including when editing the Actor’s own Catalog. Creation does not change saved catalog state. Returns: The newly created empty draft Catalog Edit Session.
bookreport_create_catalog_edit_undo_session
ChatGPTCreates a new draft with explicit scope: use {scope:"all"} to reverse every applied change, or {scope:"selected",change_ids:[...]} for a distinct nonempty selection. Undo creation is non-destructive. Preview the new draft, show it, and commit its latest confirmed token like any other session. Returns: Catalog Owner identity and a non-destructive draft of ordered reversal changes with stable links.
bookreport_get_account_context
ChatGPTUse this when you need safe context about the authenticated Book Report account before analysis: report settings, connected sources, and external-access capabilities. This tool is read-only and does not return email, account IDs, API keys, OAuth IDs, cookies, tokens, or raw third-party account identifiers.
bookreport_get_catalog
ChatGPTUse this when you need authenticated Book Report catalog metadata: logical books, titles, authors, series, publication dates, KENPC/book length, formats, distributors, languages, contributors, and optional edition metadata. This tool is read-only and returns standard metadata only. Archived books are hidden by default like the Books tab, and catalog_visibility explains how to include matching archived entries. Use bookreport_run_report for numeric sales and earnings.
bookreport_get_catalog_edit_session
ChatGPTReturns full detail for a draft or committed Catalog Edit Session when the Actor can still manage its Catalog Owner. Use it to inspect current status, revision, ordered canonical changes, preview state, reversal links, and safe committed attribution. This read-only management call changes nothing. Returns: Catalog Owner identity and full appropriate detail for the requested Catalog Edit Session.
bookreport_get_user_guide_page
ChatGPTRead the complete normalized Markdown for a page_id returned by bookreport_search_user_guide. Use this when the matching section is not enough context or the user asks for a fuller explanation. The guide describes Book Report generally; use the live MCP tool schemas for exact inputs and outputs. Returns: The complete published guide page with its stable ID, title, description, and canonical public URL.
bookreport_list_catalog_edit_sessions
ChatGPTLists lightweight committed Catalog Edit Session summaries for one authorized Catalog Owner, newest first. Omit the target for the Actor’s own Catalog. Pages default to 25 summaries and accept at most 100. Fetch a session by ID for its full ordered changes, or use its ID to begin an undo workflow. Returns: Catalog Owner identity and a paginated page of lightweight committed-session summaries.
bookreport_list_editable_catalogs
ChatGPTLists the Actor’s own Catalog and each shared Editable Catalog the Actor can currently manage. Use a returned Public Account ID to read that exact Catalog, create its Catalog Edit Session, or inspect its edit history. Returns: At least one Catalog Owner identity, Public Account ID, and owner-or-granted access classification.
bookreport_list_filter_values
ChatGPTUse this when you need valid values for Book Report report filters before calling bookreport_run_report. Without a filter, it returns available report-compatible filters. With a filter, it returns paged, searchable values for that filter. Pass returned values[].value to report filters; labels are display text.
bookreport_list_report_fields
ChatGPTUse this when you need the valid Book Report report attributes, filters, metrics, field definitions, currencies, and date ranges before building a report request. This tool is read-only and returns public report vocabulary, not account data.
bookreport_preview_catalog_edit_session
ChatGPTResolves every staged action against current Catalog state and returns the Catalog Owner, complete ordered human-readable canonical diff, revision, and preview token. Show the entire preview to the user. Preview again after staging because a new revision invalidates the earlier token. Preview changes nothing. Returns: Catalog Owner identity, complete ordered canonical diff, revision, count, and preview token.
bookreport_run_report
ChatGPTUse this when the user asks for numeric Book Report sales, earnings, units, borrows, pages read, refunds, or royalties split by public report attributes such as total, book, product, series, format, distributor, marketplace, date, month, year, country, or transaction type. Use attributes "total" for aggregate totals such as all-time earnings. This tool is read-only, applies account report settings by default, allows an explicit currency override, sorts rows descending by the first requested metric, and may return a capped top-row window. Use bookreport_get_catalog for book metadata instead of numeric report data.
bookreport_search_user_guide
ChatGPTSearch the published Book Report user guide by plain-language question or keywords. Use this for Book Report concepts, feature behavior, UI instructions, and troubleshooting. Results contain useful section content and a page_id for reading the complete source page. The guide describes Book Report generally; the current MCP tool schemas and connection grants remain authoritative for what this connection can do. Returns: Ranked guide sections with normalized Markdown content, stable page IDs, and canonical public URLs.
bookreport_stage_catalog_add_custom_column
ChatGPTAdd a text column that describes either whole Books or individual Editions. Stage this change in the draft, then preview and commit the session separately. Returns: Catalog Owner identity, draft revision, and concise ordered staged-change summaries.
bookreport_stage_catalog_classify_products
ChatGPTClassify BookFunnel products as books or non-books. Books require a supported format. Stage this change in the draft, then preview and commit the session separately. Returns: Catalog Owner identity, draft revision, and concise ordered staged-change summaries.
bookreport_stage_catalog_edit_book_info
ChatGPTEdit built-in Book-wide information and Book-scoped custom columns for one or more books without changing their identities. Stage this change in the draft, then preview and commit the session separately. Returns: Catalog Owner identity, draft revision, and concise ordered staged-change summaries.
bookreport_stage_catalog_edit_edition_info
ChatGPTEdit built-in information and Edition-scoped custom columns for one or more individual editions. Custom column values are direct and never inferred. Unset values for built-in fields may be inferred from other editions in the same Book. Stage this change in the draft, then preview and commit the session separately. Returns: Catalog Owner identity, draft revision, and concise ordered staged-change summaries.
bookreport_stage_catalog_group_books
ChatGPTGroup duplicate Books and choose which Book supplies the grouped Book information. Stage this change in the draft, then preview and commit the session separately. Returns: Catalog Owner identity, draft revision, and concise ordered staged-change summaries.
bookreport_stage_catalog_move_editions
ChatGPTMove one or more editions into another Book. Stage this change in the draft, then preview and commit the session separately. Returns: Catalog Owner identity, draft revision, and concise ordered staged-change summaries.
bookreport_stage_catalog_remove_custom_column
ChatGPTRemove a custom column and all of its saved values. Stage this change in the draft, then preview and commit the session separately. Returns: Catalog Owner identity, draft revision, and concise ordered staged-change summaries.
bookreport_stage_catalog_separate_editions
ChatGPTMake one or more Editions into separate Books. Stage this change in the draft, then preview and commit the session separately. Returns: Catalog Owner identity, draft revision, and concise ordered staged-change summaries.
bookreport_stage_catalog_set_book_archived
ChatGPTSet whether one or more books are archived. Stage this change in the draft, then preview and commit the session separately. Returns: Catalog Owner identity, draft revision, and concise ordered staged-change summaries.
