Revised:
1. get_account_info (обхват account.read)
Връща компанията на влезлия потребител, неговата роля, абонаментния план и активираните модули. Асистентите го извикват първо, за да знаят чии данни разглеждат.
2. list_warehouses (обхват inventory.read)
Извежда списък със складовете и локациите на компанията и показва кои от тях са свързани с локация в Shopify.
3. search_products (обхват catalog.read)
Търси продукти по име, SKU, баркод, марка или модел и връща кратък ред за всеки продукт с цена, категория и наличност. Резултатите са с пагинация; използвайте get_product за пълния запис.
4. get_product (обхват catalog.read)
Връща данните за един продукт, неговата наличност по локации и статуса на публикуването му в маркетплейсите.
5. get_inventory_summary (обхват inventory.read)
Връща общото количество наличности по локации, така че асистентът да може да отговори колко стока притежава компанията във всеки склад.
6. find_missing_product_data (обхват catalog.read)
Намира продукти, на които липсват данни, задължителни за продажба (изображение, цена, категория, описание, баркод и др.), и посочва липсващите елементи. Резултатите са с пагинация.
7. find_listing_problems (обхват catalog.read)
Намира продукти, които не са публикувани в даден marketplace или канал, и обяснява грешката с решение на достъпен език – например липсващ EAN код, изискван от категорията в Allegro.
8. find_unfulfilled_orders (обхват orders.read)
Показва отворените поръчки от онлайн магазини, marketplace платформи и B2B канали, които все още не са изпратени, заедно с техния източник, партньор и статус.
9. search_categories (обхват catalog.read)
Търси в дървото на продуктовите категории по име и връща идентификатори и пътища на категории; update_product използва идентификатора, за да зададе категория.
10. Как работят инструментите за запис
Инструментите за запис изискват обхват catalog.write или inventory.write и роля на собственик или администратор. Всеки работи на две стъпки: с confirm=false само връща преглед на старите и новите стойности; с confirm=true и expected_version (версията на продукта от прегледа или от get_product) записва. Ако продуктът междувременно е променен, записът се отказва. Едно извикване променя един продукт, всяка промяна се записва в историята с произход mcp и нищо не може да се изтрие.
11. update_product (обхват catalog.write)
Променя името, описанието, марката, типа, категорията, баркода, SKU, продажната цена или статуса (активен или чернова) на един продукт. Цената, зададена тук, е ръчна цена, която фоновият AI никога не презаписва. SKU се променя в отделно извикване.
12. adjust_stock (обхват inventory.write)
Задава, добавя или намалява наличността на един продукт в една локация чрез обичайното складово движение, така че дневникът на движенията и синхронизацията на наличностите с Shopify също се обновяват.
13. set_channel_listing (обхват catalog.write)
Включва, изключва или връща към правилото на канала един продукт в един пазар или канал. Употребявани, ремонтирани или повредени продукти никога не могат да бъдат включени в канали, които приемат само нови продукти (eMAG, Árukereső, Árgép, Pepita).
14. create_product (обхват catalog.write)
Създава нов продукт по баркод или име, по избор с начална наличност в една локация. Фоновият AI го разпознава и попълва останалото в обичайния лимит от най-много 5 AI извиквания на продукт; съществуващ баркод никога не се дублира.
