Lists the org's synced catalogs (external product feeds, Google Shopping XML or CSV over https, that AI sellers can quote from), newest first, paginated by cursor (limit 50 by default): name, feed URL, sync frequency, whether AI sellers may use it, sync status (idle, syncing, ok, error), product count, last sync, next scheduled sync and who added it (created_by_name). The manually curated products used in deal quotes are a different list: see crm.products.list. Adding a catalog and syncing it now are done in the MB Suite app (CRM → Settings → Products: «New catalog», and «Sync now» in the catalog's tab), because each sync computes AI embeddings that consume AI credits.
Escopo
crm:read
Permissão
Ver o módulo
Tool do MCP
crm_catalogs_listNa superfície completa; na compacta, mb_execute_operation com id: "crm.catalogs.list".
Custo declarado: até 202 leituras e 0 escritas por chamada (contam na cota diária).
Parâmetros
limitintegerqueryopcional
How many items this page brings at most (see the maximum and the default in the schema).
Padrão: 50
cursorstringqueryopcional
The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.
Returns one synced catalog with its sync status (idle, syncing, ok, error), last error, product count, last and next sync. Use it to follow a sync (the one the app starts, or the scheduled one): the status moves from syncing to ok or error. Adding a catalog and syncing it now are done in the MB Suite app (CRM → Settings → Products: «New catalog», and «Sync now» in the catalog's tab), because each sync computes AI embeddings that consume AI credits.
Escopo
crm:read
Permissão
Ver o módulo
Tool do MCP
crm_catalogs_getNa superfície completa; na compacta, mb_execute_operation com id: "crm.catalogs.get".
Custo declarado: até 1 leituras e 0 escritas por chamada (contam na cota diária).
Parâmetros
catalog_idstringrotaobrigatório
Id of the catalog, from crm.catalogs.list.
Resposta
idstring
namestring
feed_urlstring
frequencyenum
Valores: manual, daily, every_6h
enabled_for_sellersboolean
statusenum
idle (never synced), syncing, ok or error (see last_error).
Valores: idle, syncing, ok, error
product_countnumber
capnumber
Most products a sync keeps; beyond it the feed is cut and last_error says cap_reached.
created_atnumber
updated_atnumber
org_idstring
formatenum | null
Detected on the first sync; null until then.
Valores: google_shopping_xml, csv
last_sync_atnumber | null
last_sync_duration_msnumber | null
last_errorstring | null
Why the last sync failed or stopped (cap_reached, unrecognized_feed_format, no AI credits…).
next_sync_atnumber | null
Next scheduled sync; null for a manual catalog.
created_by_idstring
created_by_namestring | null
Name of who added it, from their profile or the members (never the email).
Updates a catalog's name, sync frequency or whether AI sellers may use it. A new frequency reschedules the next sync: manual stops the scheduled ones; daily or every_6h counts from the last sync (if that time already passed, the hourly scheduler syncs it in its next run, which consumes AI credits for the changed products). The feed URL is changed only from the MB Suite app (403 catalog_feed_url_app_only with an API key or an OAuth app; sending the current URL is ignored): a new feed re-syncs the whole catalog with AI embeddings, and the app checks the AI credits first (402 ai_credits_exhausted if they are used up). Fails with no_changes if nothing is sent. Requires manage_products.
Escopo
crm:write
Permissão
Editar no módulo · Ação do CRM: manage_products
Tool do MCP
crm_catalogs_updateNa superfície completa; na compacta, mb_execute_operation com id: "crm.catalogs.update".
Custo declarado: até 8 leituras e 1 escritas por chamada (contam na cota diária).
Parâmetros
catalog_idstringrotaobrigatório
Id of the catalog, from crm.catalogs.list.
namestringcorpoopcional
Name shown in the app's tabs (CRM → Settings → Products) and to AI sellers, up to 120 characters.
feed_urlstring (uri)corpoopcional
Only from the MB Suite app: an API key or an OAuth app gets 403 catalog_feed_url_app_only (a new feed re-syncs the whole catalog with AI embeddings). Sending the current URL is ignored.
frequencyenumcorpoopcional
How often it syncs on its own: manual (only with «Sync now» in the app), daily or every_6h.
Valores: manual, daily, every_6h
enabled_for_sellersbooleancorpoopcional
Whether the AI sellers of the CRM may quote from this catalog.
Deletes a catalog: it disappears from the screen, from the scheduler and from what AI sellers can quote, and its synced products are removed right after responding. The catalog itself goes to the 30-day trash; if it is restored, its products come back with its next sync (they are a mirror of the feed), so restoring it needs AI credits left (402 ai_credits_exhausted otherwise). Requires manage_products.
Com uma API key, este DELETE roda direto: o registro fica 30 dias na lixeira e a resposta traz o seu trash_item_id. Com um token OAuth, e pelo MCP, pede dry_run → confirm_token.
Escopo
crm:writee «Permitir exclusões» (crm:delete no OAuth)
Permissão
Editar no módulo · Ação do CRM: manage_products
Tool do MCP
crm_catalogs_deleteNa superfície completa; na compacta, mb_execute_operation com id: "crm.catalogs.delete".
Custo declarado: até 10001 leituras e 10002 escritas por chamada (contam na cota diária).
Parâmetros
catalog_idstringrotaobrigatório
Id of the catalog, from crm.catalogs.list.
Resposta
oktrue
trash_item_idstring
The trash item this deletion left: the item_id of platform.trash.restore (POST /trash/{item_id}/restore). Missing if nothing went to the trash.
trash_item_idsarray<string>
Only when the deletion left more than one copy: all of them, the first being trash_item_id.
trash_expires_atnumber
When the copy leaves the trash for good (epoch ms): 30 days after the deletion.
