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_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
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_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_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_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_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_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.
