Browse the docs ▾

MCP tools

Products and stock tools

Read your catalogue and stock, add products, and keep collections in the order you want.

Read

TOOL

WHAT IT DOES

list_products

Products with price, stock ready to sell and whether they're on sale.
Permission: catalogue:read

get_product

One product with its variants, prices, stock and photos.
Permission: catalogue:read

list_stock

Stock by variant: low, out, or everything.
Permission: catalogue:read

list_collections

Collections and how many products each shows.
Permission: catalogue:read

get_collection_order

A collection's products in the order you arranged them.
Permission: catalogue:read

list_categories

Product categories with their product and field counts.
Permission: catalogue:read

get_category_fields

A category's extra fields and where the design shows each.
Permission: catalogue:read

Add and archive

TOOL

WHAT IT DOES

import_products

Add products with prices, opening stock and photos. They stay off sale until you publish them.
Permission: catalogue:write

preview_product_archive

Which products would come off the shop.
Permission: catalogue:write

archive_products

Archive or restore them with the token. Past orders keep them.
Permission: catalogue:write

Arrange and describe

TOOL

WHAT IT DOES

preview_collection_order

A new order for a collection of picked products.
Permission: catalogue:write

save_collection_order

Save it with the token.
Permission: catalogue:write

add_category_fields

Add fields to a category, like fabric or care.
Permission: catalogue:write

preview_product_fields

A product's category field values, before and after.
Permission: catalogue:write

save_product_fields

Save them with the token.
Permission: catalogue:write
Changing an existing product's price, stock, name or variants isn't available to apps yet. Do that in the dashboard.

‹ Previous

Content

Next ›

Orders

Low stock

{
  "name": "list_stock",
  "arguments": {
    "org_id": 121,
    "view": "low"
  }
}

→ Kanchipuram Silk · Maroon   1 left
  Cotton Kurta · L           2 left

‹ Previous

Content

Next ›

Orders