shop_tool
Internet shop on the selected site (call select_site first). Categories, goods, images, variations, stock, basket, checkout, orders, currencies, balance, product comments. Not content_tool, modules_tool, or templates_tool. Proxies to /uapi/shop/* with a server-minted Bearer key. Image slots accept inline bytes (_base64 with _filename), a file already on the site (_site_path), or a local MCP server path (_path); remote agents must use *_base64, *_upload_id, or *_site_path because they cannot write to the MCP server host.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Goods, category, comment, or basket line id. | |
| art | No | SKU / article. | |
| cnt | No | Basket quantity. | |
| del | No | 1 = delete category image. | |
| ids | No | Comma-separated ids (invoice_*, stock_remove). | |
| img | No | Image slot number. | |
| now | No | 1 = buy now. | |
| opt | No | Selected options OPTION_ID-VALUE_ID:… for basket/order. | |
| pid | No | Parent category id. | |
| pos | No | Category position. | |
| url | No | Custom URL slug. | |
| cons | No | ||
| date | No | invoices_list created period date1|date2. | |
| dscr | No | Full description; pass html_dscr=1 when HTML. | |
| hide | No | Hide flag or invoices_list group. | |
| mode | No | Sub-action mode (category, basket, checkout, variation_dict). | |
| name | No | Goods or category name. | |
| note | No | ||
| page | No | List page (orders / goods). | |
| pnum | No | Goods list page. | |
| pros | No | ||
| sort | No | Goods list sort field. | |
| tags | No | ||
| type | No | Goods type: 0 material, 1 file, 2 e-code, 3 service. | |
| unit | No | ||
| warr | No | ||
| brand | No | Brand. | |
| brief | No | Short description. | |
| cdate | No | invoices_list delivery period date1|date2. | |
| clear | No | 1 = clear wishlist (get). | |
| f_art | No | ||
| order | No | List asc/desc or order hash. | |
| price | No | Price (goods or variation_update). | |
| solds | No | ||
| stock | No | Stock count. | |
| views | No | ||
| action | Yes | Shop action. Destructive actions need confirm: true after user approval. | |
| amount | No | Balance amount. | |
| cat_id | No | Goods category id (add/update). | |
| f_name | No | Goods name filter (plain; MCP encodes Base64). | |
| f_warr | No | ||
| fields | No | Extra form keys (checkout field_N, stock_*, var_*, cnt_REC_ID, …). | |
| images | No | Files for img_add (remote upload). Each item is { filename, content_base64 }, { upload_id }, or { site_path }. Appended as file_add_N after the image_*/file_* slots. | |
| method | No | Usually submit for add/update goods. | |
| status | No | Order status code. | |
| undisc | No | ||
| values | No | variation_dict values comma-separated (S,M,L). | |
| weight | No | ||
| confirm | No | Required for destructive actions after user approval. | |
| del_all | No | 1 = delete all images (img_del). | |
| f_brand | No | ||
| f_price | No | Price filter MIN|MAX|CUR. | |
| f_stock | No | ||
| inv_sum | No | invoices_list sum1|sum2. | |
| message | No | Comment text. | |
| opt_sel | No | Option set for stock_add (e.g. 2-3:4). | |
| ordered | No | ||
| stock_q | No | ||
| user_id | No | User id filter or balance target. | |
| cats_add | No | Extra category ids [ID1, ID2, …]. | |
| entry_id | No | Goods id for comments_add. | |
| f_status | No | ||
| f_weight | No | ||
| goods_id | No | Wishlist goods id (get). | |
| price_in | No | Purchase price. | |
| rate_num | No | ||
| rate_sum | No | ||
| ch_addcat | No | 1 when cats_add is passed. | |
| curr_code | No | ||
| curr_rate | No | ||
| file_path | No | Synonym for image_path (local MCP server path). | |
| html_dscr | No | 1 = dscr is HTML. | |
| meta_dscr | No | ||
| parent_id | No | Synonym for pid / category_list parent. | |
| price_old | No | Old price. | |
| add_groups | No | ||
| global_cat | No | ||
| image_path | No | Local MCP server path for image upload. Missing files are an error; remote agents must use image_base64, image_upload_id, or image_site_path. | |
| meta_title | No | ||
| payment_id | No | ||
| promo_code | No | ||
| delivery_id | No | ||
| file_base64 | No | Synonym for image_base64. | |
| get_globals | No | 1 = global categories in category_list. | |
| image_paths | No | Comma-separated local MCP server paths (img_add). Missing files are an error. | |
| view_groups | No | ||
| file_add_cnt | No | ||
| image_base64 | No | Base64 image body with image_filename (remote upload). Wins over image_upload_id, image_site_path, and image_path. | |
| file_filename | No | Synonym for image_filename. | |
| group_courier | No | ||
| variation_crc | No | Variation hash from variations_list. | |
| file_site_path | No | Synonym for image_site_path. | |
| file_upload_id | No | Synonym for image_upload_id. | |
| files_sequence | No | Image order after single img_del. | |
| image_filename | No | File name for image_base64, with extension. | |
| image_site_path | No | File already on the site (img/x.jpg or its full site URL). Wins over image_path. | |
| image_upload_id | No | upload_id from upload_direct. Wins over image_site_path and image_path. | |
| image_site_paths | No | Comma-separated site files for img_add (img/x.jpg or full site URLs). | |
| image_upload_ids | No | Comma-separated upload_id values from upload_direct for img_add. | |
| custom_delivery_tax | No | ||
| subscribe_to_replies | No | ||
| exclude_from_discount | No |