MCP Stock, Models & Config Tools
Config List
config_list — Read-only. Beta: this tool is being rolled out and may not be available on your account yet.
Read one of this client’s configuration lookup lists – the allowed values behind product, gemstone and order fields. Essential before writing: gemstone_import and gemstone_update take shape, colour, clarity, cut, treatment and so on as free text, and this is where the values they accept come from. Returns found=false plus available_lists for an unknown list name.
list (string, required) — One of: gemstone_clarities, gemstone_colors, gemstone_creation_methods, gemstone_cuts, gemstone_intensities, gemstone_overtones, gemstone_polishes, gemstone_shapes, gemstone_symmetry, gemstone_treatments, gemstone_types, metal_purities ….
parent_id (integer) — Default: 0.
Magento Save Soap Creds
magento_save_soap_creds — Writes data. Beta: this tool is being rolled out and may not be available on your account yet.
Connect the Magento integration by saving and validating SOAP/XML API credentials.
soap_username (string, required)
soap_apikey (string, required)
soap_url (string, required)
Models Get
models_get — Read-only. Beta: this tool is being rolled out and may not be available on your account yet.
One model with its type, collection and the number of products generated from it. Returns found=false for an unknown model.
model_id (integer, required)
Models List
models_list — Read-only. Beta: this tool is being rolled out and may not be available on your account yet.
Search this client’s models (product templates): model id, code and title. Use `search` to match on code and/or title. Models are the templates products are generated from – use models_get for one model’s type, collection and how many products came from it.
search (string)
search_by_code (boolean) — Default: true.
search_by_title (boolean) — Default: true.
limit (integer) — Default: 20.
offset (integer) — Default: 0.
Statistics Inventory Report
statistics_inventory_report — Read-only. Beta: this tool is being rolled out and may not be available on your account yet.
Inventory valuation: what is in stock and what it is worth, broken down by stock location, by metal/purity and by gem type, with totals. Values are raw numbers, not formatted strings, so they can be compared and summed. Use mode=components to count only component products, or mode=memo_out for products currently out on memo.
mode (string) — Default: “all”. One of: all, components, memo_out.
Stock Models List
stock_models_list — Read-only. Beta: this tool is being rolled out and may not be available on your account yet.
Stock levels per model across every stock location: model code, title, computed stock status and a per-location quantity plus its alert threshold. Use it to answer “what is running low” or “how much of model X do we have, and where”.
limit (integer) — Default: 20.
offset (integer) — Default: 0.
Stock Products Update Qtys
stock_products_update_qtys — Writes data. Beta: this tool is being rolled out and may not be available on your account yet.
Change stock quantity (or the quantity alert threshold) for a set of products, by a relative amount. `what` is per-client and looks like ‘qty-<stock_id>’ or ‘alert-<stock_id>’ – call it with a wrong value once and the error lists the valid options for this client. `by_value` is the delta and must not be zero (negative decreases). This starts an asynchronous BATCH and returns started_batch_ids – nothing has changed yet when the call returns; poll batch_info, and read batches_errors if it reports failures. NOT IDEMPOTENT: by_value is a delta, so calling twice applies it twice. If a call times out or you are unsure whether it ran, do NOT retry – check batches_list for a batch you already started, and read the current quantities, before deciding. Wrong quantities propagate to the sales channels and cause overselling. Pass dry_run=true first: it shows current -> new for each product and warns when any would fall below zero.
product_ids (array, required)
what (string, required)
by_value (integer, required)
dry_run (boolean) — Return what this call WOULD do, without doing it. Use it first whenever you are not certain of the scope, and show the projection to the user before calling for real. Default: false.
