Для AI-агентов: markdown этой страницы — /docs/mcp-catalog.mdиндекс документации — /llms.txt
MCP: catalog
Обновлено
Определения инструментов. Обновляйте tools/list после изменения прав. required_scopes: ALL.
create_catalog_group
Create a catalog group for the active business. Returns its tenant seq_num.
Scopes (ALL): ["catalog:write"]. Risk: "write".
delete_catalog_group
Delete a catalog group by tenant seq_num; assigned products remain.
Scopes (ALL): ["catalog:write"]. Risk: "destructive".
get_catalog
List all live catalog items (cursor-paginated; deleted excluded) with reach pair `is_active`/`is_public`: `is_active:false` = off, sold by nothing; both true = in the showcase, offer freely; `is_public:false` = link-only, never volunteer it. `zone` (ru/com) selects price presentation, default ru.
Scopes (ALL): ["catalog:read"]. Risk: "read".
get_catalog_group
Read one catalog group by its `seq_num`.
Scopes (ALL): ["catalog:read"]. Risk: "read".
get_catalog_item
Read one catalog item by seq_id; the response carries the `etag` you pass to update it. `zone` (ru/com) selects price presentation, default ru.
Scopes (ALL): ["catalog:read"]. Risk: "read".
list_catalog_groups
List catalog groups with their `seq_num`, reach state, sort order and item count.
Scopes (ALL): ["catalog:read"]. Risk: "read".
onboarding_execute_first_payment
Execute the owner-approved preparation receipt, save its exact catalog price and send a real purchase card. Card delivery does not confirm payment. Optional: payment setup is not part of the mandatory onboarding path and never blocks onboarding_complete.
Scopes (ALL): ["catalog:write","payments:config"]. Risk: "money".
onboarding_prepare_first_payment
Prepare a paid version of the delivered test product and show its exact price and provider for owner approval. This does not charge money. Optional: payment setup is not part of the mandatory onboarding path and never blocks onboarding_complete.
Scopes (ALL): ["catalog:write","payments:config"]. Risk: "money".
update_catalog_group
Update a catalog group by tenant seq_num, using its updated_at as if_match.
Scopes (ALL): ["catalog:write"]. Risk: "write".
update_catalog_item
Patch a catalog item (sparse — omitted fields are untouched). Requires `etag` for optimistic concurrency and `idempotency_key` for durable receipt replay. A nonempty patch returns its canonical committed receipt identically on first success and exact replay. Use `get_catalog_item` for the current RU or COM price presentation and payment-provider availability. Optional `zone` selects that current presentation for an empty no-op patch; omitted defaults to RU. To configure selectable POS modifiers, patch the canonical nested `variants` object; retained keys are stable addresses, so an illegal key rewrite is rejected by the canonical writer. Reach is two INDEPENDENT booleans you may patch separately: `is_active:false` switches the item off entirely (purchasable by nothing); `is_public:false` takes it out of the showcase and storefront while it stays fully payable through its direct link. To configure a booking service, patch nested `booking`: `enabled`, `mode` (`hourly`/`daily`), `duration_value`, `buffer_minutes`, and `resource_seq_nums`.
Scopes (ALL): ["catalog:write"]. Risk: "write".