Products tools

5 tools for managing the merchant's product catalog. Products are referenced by shipments, orders, returns, and inventory; keeping the catalog up to date keeps downstream data accurate.

Reads

Tool	What it returns
get_product	One product by product_id or product_ref.
list_products	Products in a merchant catalog, with filtering, sorting, paging, and free-text search.

Writes

Tool	What it does
create_product	Create a new product.
edit_product	Patch an existing product by product_id.
delete_product	Delete a product by product_id or product_ref.

Notes

• Every tool requires a merchant parameter — Carriyo products are scoped to a merchant within the tenant.
• product_id is Carriyo-issued; product_ref is your reference. Most lookups accept either via a value parameter that the tool resolves.
• For bulk catalog operations consider the bulk endpoints on the Products REST API — MCP currently does not expose bulk product tools.