# MCP: catalog

Source: <https://telegafirst.com/docs/mcp-catalog>
Locale: ru
releaseGitSha: 0bb11ef116e17ec64c802d5476eaff442e53d252
sourceContentDigest: f77cfc7432b93d309a46b48981caffa8d779dfcce18c7cf1cc81b5185ff831bd
Version: 9

# 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-create-catalog-group)

## delete\_catalog\_group

Delete a catalog group by tenant seq\_num; assigned products remain.

Scopes (ALL): \["catalog:write"]. Risk: "destructive".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-delete-catalog-group)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-get-catalog)

## get\_catalog\_group

Read one catalog group by its \`seq\_num\`.

Scopes (ALL): \["catalog:read"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-get-catalog-group)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-get-catalog-item)

## list\_catalog\_groups

List catalog groups with their \`seq\_num\`, reach state, sort order and item count.

Scopes (ALL): \["catalog:read"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-list-catalog-groups)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-onboarding-execute-first-payment)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-onboarding-prepare-first-payment)

## update\_catalog\_group

Update a catalog group by tenant seq\_num, using its updated\_at as if\_match.

Scopes (ALL): \["catalog:write"]. Risk: "write".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-update-catalog-group)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-update-catalog-item)