Reference · InfiPlex MCP Server

InfiPlex MCP tools reference: all tools, what they do, and what they need

This is the complete list of tools the InfiPlex MCP server publishes to a connected AI assistant, taken directly from the server's tools/list response. For each tool: the exact name, whether it reads or writes, every input with its meaning, and the behaviors the tool description instructs the assistant to follow. Tool names, inputs, and gates on this page match the live server; when the server changes, this page changes with it.

  • 18 Read ToolsListed on any key with the matching read scope. No confirmation step.
  • 10 Previewed Write ToolsAnything that changes stock, prices, shipments, products, warehouses, or settings returns a preview and an argument-bound token first; the second call executes.
  • 5 Direct Write ToolsInternal notes, the processed flag, order status, additional info fields, and bin locations execute on the first call. None of them touch a channel listing, quantity, or price.

Index

Every tool, by area

Seven areas mirror the InfiPlex REST API scopes (shown on each tool as the exact scope name a key needs). A key with only read scopes in an area sees only that area's read tools; uncheck an area entirely and its tools do not appear in the assistant's tool list at all.

Tool Scope Access Purpose
order_search shop_order_read Read Search orders by date, status, channel, total, tag, or SKU. Returns summaries; use order_get for one order.
order_get shop_order_read Read One complete order by InfiPlex order id: line items (with itemid), addresses, totals, shipment state.
order_warehouse_routing_explanation_get shop_order_read Read The step-by-step record of how each line of an order was routed to a warehouse.
order_note_create shop_order_write Write, no preview Add an internal note to an order.
order_additional_info_create shop_order_write Write, no preview Set one additional info field on an existing order.
order_tracking_create shop_order_write Write, preview + token Record a shipment against an order and submit tracking to the sales channel.
order_processed shop_order_write Write, no preview Flag an order as handled internally, or clear the flag.
order_update_status shop_order_write Write, no preview Set an order to a workflow status.
order_cancel shop_order_write Write, preview + token Cancel an order, and send the cancellation to the marketplace where supported.
order_create shop_order_write Write, preview + token Create an order manually: offline, phone, wholesale, or test.
inventory_get shop_inventory_read Read Current inventory for one SKU, total or per warehouse.
inventory_search shop_inventory_read Read Search inventory across SKUs with warehouse, active-state, and modified-date filters.
inventory_change_history_get shop_inventory_read Read Change history for one SKU, newest first.
inventory_restock_list shop_inventory_read Read Every parent product and child SKU at or below its reorder point, summed across warehouses.
inventory_set shop_inventory_write Write, preview + token Change inventory for one SKU by absolute value or delta.
inventory_set_bulk shop_inventory_write Write, preview + token Change inventory for many SKUs in one call, mixing sets and deltas per row.
bin_location_set shop_inventory_write Write, no preview Assign or update bin locations for SKUs within warehouses.
price_get shop_price_read Read Current price for one SKU.
price_search shop_price_read Read List prices, optionally by modified date.
price_set shop_price_write Write, preview + token Set the price for one SKU.
products_create shop_products_write Write, preview + token Create one or more new products in a batch.
pim_sku_get shop_pim_read Read The full product information record for one SKU, including attributes.
pim_nightly_file shop_pim_read Read Download a nightly PIM data file built automatically by InfiPlex.
warehouse_search shop_warehouse_read Read List and filter warehouses; resolves a name to the warehouse_id other tools need.
warehouse_get shop_warehouse_read Read Configuration for one warehouse: address and routing settings.
warehouse_create shop_warehouse_write Write, preview + token Create a new warehouse.
warehouse_set shop_warehouse_write Write, preview + token Update an existing warehouse.
shop_setting_search shop_setting_read Read Find settings by name and return each with its current value and a description of what it controls.
shop_setting_get shop_setting_read Read Read one setting by exact name.
shop_setting_set shop_setting_write Write, preview + token + opt-ins Change one setting.
marketplace_connect_link_get shop_setting_read Read Generate a one time authorization link that lets the marketplace account owner connect their account to this instance.
log_types_get shop_log_read Read List every shop log type on this instance as log_type id to label, for example 1026 Amazon Get Orders: Failed.
log_search shop_log_read Read Search the shop log by log type, text, and date range: why orders did not import, why tracking or inventory did not reach a channel, or everything logged for one order.

Orders

Orders: 10 tools

Find, read, annotate, ship, and close orders from every connected channel.

order_get shop_order_read Read

One complete order by InfiPlex order id: line items (with itemid), addresses, totals, shipment state.

  • orderidrequired InfiPlex internal order id, not the marketplace order number.
  • If only a marketplace number is known, the assistant finds the order with order_search first.
  • Returns the itemid values that order_tracking_create needs.

order_warehouse_routing_explanation_get shop_order_read Read

The step-by-step record of how each line of an order was routed to a warehouse.

  • orderidrequired InfiPlex internal order id.
  • One entry per order line, in processing order; process_events lists each step, and every Valid Warehouse Found event carries the zip rule check, default warehouse, and inventory adjustment as child_events.
  • quantity_to_process_at_warehouse is negative for units taken, 0 when none were.
  • An Overflow Inventory Quantity Adjustment event means no warehouse could fill the full quantity and the shortfall went to the default warehouse.
  • Written once when routing runs and never changed, so inventory figures are as of that moment. For current stock the assistant uses inventory_get.

order_note_create shop_order_write Write, no preview

Add an internal note to an order.

  • orderidrequired InfiPlex internal order id.
  • order_noterequired Note text.
  • Notes are internal; nothing is sent to the customer or the marketplace.
  • Readable back through order_get or order_search with include_order_notes.

order_additional_info_create shop_order_write Write, no preview

Set one additional info field on an existing order.

  • orderidrequired InfiPlex internal order id.
  • additional_info_namerequired Field name, for example warehouse_being_picked_from or netsuite_class_id.
  • additional_info_valuerequired Field value.
  • These fields are consumed by Order Automation and ERP push logic, including every netsuite_custom_field_* name.
  • The name must exactly match one the account uses; an unknown name is stored but maps to nothing, so the assistant confirms the exact name rather than guessing.

order_tracking_create shop_order_write Write, preview + token

Record a shipment against an order and submit tracking to the sales channel.

  • orderidrequired InfiPlex internal order id.
  • tracking_numberrequired Carrier tracking number.
  • carrier_namerequired Carrier as the customer wants it recorded, for example UPS, FedEx, USPS. Any value accepted.
  • package_itemsrequired Every line in this package with quantity, keyed by itemid from order_get (not SKU). Required even when the package holds the whole order. Optional lot_number and serial_number per line.
  • carrier_methodoptional Service level, for example Ground, 3rd Day.
  • weight_oz, length_inches, width_inches, height_inchesoptional Package dimensions.
  • save_items_as_qty_oneoptional Record each unit as its own line; needed for lot or serial tracked items.
  • set_ship_from_info + ship_from_*optional Override the ship-from address, or ship_from_warehouse_id to name the warehouse.
  • confirmation_tokenoptional Omit on the first call to receive the preview and token. Pass the token on the second call to execute. Changing any other argument invalidates it.
  • Externally visible to the customer and the marketplace, so it sits behind the confirmation preview.
  • One call is one package with one tracking number.

order_processed shop_order_write Write, no preview

Flag an order as handled internally, or clear the flag.

  • orderidrequired InfiPlex internal order id.
  • is_processedoptional 1 to mark processed (default), 0 to clear.
  • Does not create a shipment, send tracking, or notify anyone. Shipping is order_tracking_create.

order_update_status shop_order_write Write, no preview

Set an order to a workflow status.

  • orderidrequired InfiPlex internal order id.
  • statusrequired One of new, needs_review, in_process, pick_up_ready, pick_up_confirmed, closed.
  • General status tool. The assistant is directed to order_processed and order_cancel for those two transitions.

order_cancel shop_order_write Write, preview + token

Cancel an order, and send the cancellation to the marketplace where supported.

  • orderidrequired InfiPlex internal order id.
  • confirmation_tokenoptional Omit on the first call to receive the preview and token. Pass the token on the second call to execute. Changing any other argument invalidates it.
  • Externally visible and generally irreversible, so it sits behind the confirmation preview and the assistant confirms the specific order first.
  • Not for fixing a data mistake; that is order_update_status.

order_create shop_order_write Write, preview + token

Create an order manually: offline, phone, wholesale, or test.

  • order_sourcerequired Channel to attribute the order to, for example Manual.
  • order_itemsrequired Lines with sku, quantity, price, and optional product_name, item_total, tax_total, discount_total.
  • ship_* / bill_*optional Full ship-to and bill-to address fields; ship_country is a two letter code.
  • email, phone, po_number, external_order_num, order_date, order_tagoptional Customer and reference fields.
  • ship_label, ship_price, ship_total, tax_total, discount_total, item_total, order_totaloptional Totals as decimal strings; order_total must reconcile.
  • additional_infooptional Key-value pairs consumed by automation and ERP push, for example netsuite_class_id.
  • confirmation_tokenoptional Omit on the first call to receive the preview and token. Pass the token on the second call to execute. Changing any other argument invalidates it.
  • Never used to re-enter an order that already exists on a channel; channel orders are ingested automatically.
  • Payment card details are never collected or sent through this tool.

Inventory

Inventory: 7 tools

Quantities per warehouse, change history, restock, bulk adjustments, bin locations.

inventory_get shop_inventory_read Read

Current inventory for one SKU, total or per warehouse.

  • skurequired Product SKU.
  • warehouse_idoptional Omit for the total across all warehouses.

inventory_change_history_get shop_inventory_read Read

Change history for one SKU, newest first.

  • skurequired Product SKU.
  • Each entry shows when, the resulting total, whether it was a delta (quantity_added, negative for a decrease) or an absolute set (quantity_set), and a note on the cause such as an order number or product creation.
  • This is how the assistant explains why a SKU has the quantity it has.

inventory_restock_list shop_inventory_read Read

Every parent product and child SKU at or below its reorder point, summed across warehouses.

  • just_countoptional 1 to return only restock_skus_count.
  • limit / limit_startoptional Paging, maximum 100; sorted by item_type then item_id so paging is stable.
  • Rows carry item_type, sku, item_id, reorder_point, total_inventory (negative when oversold), restock_delivery_lead_time, restock_safety_stock_level.
  • Uses the same weighted reorder point as the Restock Alerts email. Items with no warehouse inventory records are not returned.

inventory_set shop_inventory_write Write, preview + token

Change inventory for one SKU by absolute value or delta.

  • skurequired Product SKU.
  • quantity_to_setoptional Absolute quantity. Exactly one of this or quantity_to_add.
  • quantity_to_addoptional Delta; negative subtracts.
  • warehouse_idoptional Warehouse the quantity applies to. Omit to apply account wide.
  • confirmation_tokenoptional Omit on the first call to receive the preview and token. Pass the token on the second call to execute. Changing any other argument invalidates it.
  • Propagates to every connected channel, so it sits behind the confirmation preview.
  • For more than a few SKUs the assistant is directed to inventory_set_bulk.

inventory_set_bulk shop_inventory_write Write, preview + token

Change inventory for many SKUs in one call, mixing sets and deltas per row.

  • itemsrequired Rows of sku, warehouse_id, and exactly one of quantity_to_set or quantity_to_add. No fixed batch limit.
  • confirmation_tokenoptional Omit on the first call to receive the preview and token. Pass the token on the second call to execute. Changing any other argument invalidates it.
  • One preview covers every row.
  • A row for a SKU the API cannot resolve returns null for that row rather than failing the call, so the assistant checks each row.

bin_location_set shop_inventory_write Write, no preview

Assign or update bin locations for SKUs within warehouses.

  • bin_locationsrequired Rows of sku, warehouse_id, bin_location, for example bin09. The same SKU may appear for different warehouses.
  • Affects pick paths and is required before fulfillment in bin enabled warehouses. Does not change quantity.

Pricing, products, and PIM

Pricing, products, and PIM: 6 tools

Read and change what customers see, and read the product record.

price_get shop_price_read Read

Current price for one SKU.

  • skurequired Product SKU.
  • Price is stored per SKU, not per channel.

price_set shop_price_write Write, preview + token

Set the price for one SKU.

  • skurequired Product SKU.
  • pricerequired New price, 0 or greater.
  • confirmation_tokenoptional Omit on the first call to receive the preview and token. Pass the token on the second call to execute. Changing any other argument invalidates it.
  • Propagates to connected channels and becomes visible to customers, so it sits behind the confirmation preview.
  • The assistant reads the current value with price_get first.

products_create shop_products_write Write, preview + token

Create one or more new products in a batch.

  • productsrequired Rows with sku and title required; optional price, upc, gtin, asin, isbn, barcode, image_url, ship_weight_oz, ship_length_inches, ship_width_inches, ship_height_inches. No fixed batch limit.
  • confirmation_tokenoptional Omit on the first call to receive the preview and token. Pass the token on the second call to execute. Changing any other argument invalidates it.
  • Only for SKUs that do not exist; the assistant checks pim_sku_get first because a duplicate SKU fragments inventory and pricing across channels.

pim_sku_get shop_pim_read Read

The full product information record for one SKU, including attributes.

  • skurequired Product SKU.

pim_nightly_file shop_pim_read Read

Download a nightly PIM data file built automatically by InfiPlex.

  • file_idrequired Nightly file identifier. Currently true_value.
  • Returns bulk file content; used only when the whole export is wanted.

Warehouses

Warehouses: 4 tools

The structure multi-warehouse routing runs on.

warehouse_get shop_warehouse_read Read

Configuration for one warehouse: address and routing settings.

  • warehouse_idrequired Warehouse id.

warehouse_create shop_warehouse_write Write, preview + token

Create a new warehouse.

  • warehouse_namerequired Display name.
  • warehouse_identifieroptional Short code, for example main.
  • street1, street2, city, state, region, zip, countryoptional Address.
  • use_zip_rulesoptional "0" or "1": whether zip based routing rules apply.
  • fulfill_ordoptional ASC or DESC, sort direction used when ordering this warehouse for fulfillment.
  • confirmation_tokenoptional Omit on the first call to receive the preview and token. Pass the token on the second call to execute. Changing any other argument invalidates it.
  • A structural change that affects routing on every channel, so it sits behind the confirmation preview and the assistant checks warehouse_search first to avoid duplicates.

warehouse_set shop_warehouse_write Write, preview + token

Update an existing warehouse.

  • warehouse_idrequired Warehouse id.
  • warehouse_name, warehouse_identifieroptional Naming.
  • street1, street2, city, state, region, zip, countryoptional Address.
  • use_zip_rulesoptional "0" or "1".
  • confirmation_tokenoptional Omit on the first call to receive the preview and token. Pass the token on the second call to execute. Changing any other argument invalidates it.
  • Address and routing changes affect allocation on every channel, so it sits behind the confirmation preview; the assistant reads warehouse_get first.

Settings

Settings: 3 tools

Discover, read, and, if the key allows, change account behavior.

shop_setting_get shop_setting_read Read

Read one setting by exact name.

  • setting_namerequired Exact setting name.
  • Credential settings return only whether a value is set, never the value, so this confirms a channel is configured without exposing keys or tokens.

shop_setting_set shop_setting_write Write, preview + token + opt-ins

Change one setting.

  • setting_namerequired Setting name.
  • setting_valuerequired New value, sent as a string.
  • confirmation_tokenoptional Omit on the first call to receive the preview and token. Pass the token on the second call to execute. Changing any other argument invalidates it.
  • Settings govern routing, inventory propagation, and channel behavior account wide, so it sits behind the confirmation preview and the assistant reads the current value first.
  • Refused unless the key has MCP Allow Setting Writes in addition to the setting-write scope.
  • Settings that start or stop live marketplace traffic (pulling orders, sending inventory or tracking) are additionally refused unless the key has MCP Allow Arming.
  • Credential settings cannot be written here at all.

Connections

Connections: 1 tool

Onboarding marketplace accounts, built for 3PLs.

Logs

Logs: 2 tools

The shop log is the record InfiPlex writes for every channel call (order pulls, tracking sends, inventory sends) and for system processes such as routing each order line to a warehouse. These two tools let the assistant read it, which turns "why did this not import" from a support ticket into a question.

log_types_get shop_log_read Read

List every shop log type on this instance, as an object mapping each log_type id to its label, for example 1026 Amazon Get Orders: Failed and 1027 Amazon Get Orders: Successful.

  • No inputs.
  • This is how the assistant finds the log_type id to pass to log_search. Most labels name the channel, the action, and whether it failed or succeeded.
  • Each channel also has an Any Log type, for example 1999 Amazon: Any Log, that matches every log for that channel.

The write flow

What a write looks like on the wire

Every previewed write tool follows the same two-call shape. The assistant never sees a way around it, because the token is issued by the server, bound to the exact arguments, and required for execution.

→ tools/call price_set {"sku":"HB-2201","price":24.99} ← PENDING Price for SKU HB-2201 will change from 27.50 to 24.99. This propagates to every connected sales channel. confirmation_token: 8f3a…c1e0 (assistant shows the preview; you say yes) → tools/call price_set {"sku":"HB-2201","price":24.99,"confirmation_token":"8f3a…c1e0"} ← OK price updated 27.50 -> 24.99

If the arguments on the second call differ in any way, the server rejects the token and returns a fresh preview. For inventory_set_bulk and products_create one preview covers the whole batch. The write safety guide shows the exact refusal messages for a missing scope, a missing setting-write opt-in, and a missing arming opt-in.

Scopes

Which key permissions expose which tools

The MCP server publishes a tool only when the key carries the REST scope that tool's endpoint requires. Read scopes expose the read tools in an area, write scopes expose the write tools. Two per-key flags sit on top of scopes: MCP Allow Setting Writes is required for shop_setting_set to execute at all, and MCP Allow Arming is required for it to touch any setting that starts or stops live marketplace traffic. Both default to off. A key with MCP Enabled but every write scope unchecked is a safe read-only agent key, which is the right starting point for most teams and the right thing to hand a client.

Frequently asked

Questions, answered

How does the assistant know which tools exist?

On connect the client calls initialize and then tools/list. The server answers with the tools the key is permitted to use, each with a name, a description, and a JSON schema for its inputs. The assistant reads those at runtime, so there is nothing to configure per tool and new tools appear automatically after the next connect.

Can the assistant call a write tool without showing me the preview?

For the ten previewed write tools, it can make the first call, which produces a preview and a token but changes nothing. To execute it must send the token, and every write tool's description instructs it to show the preview and wait for your go-ahead first. The gate is enforced by the server, not by the assistant's good behavior. The five direct write tools (notes, processed flag, status, additional info, bin locations) execute on the first call because none of them changes a quantity, price, or shipment; they are still limited by the key's write scopes.

Which tools touch NetSuite or other ERP fields?

order_additional_info_create on an existing order and the additional_info array on order_create. Both write the key-value fields that the ERP push and Order Automation consume, such as netsuite_class_id, netsuite_location_id, or any netsuite_custom_field_* name. The field mapping guide lists them.

Will more tools be added?

Yes. The server is a layer over the REST API, so each new endpoint can be published as a tool. The two log tools were added in September 2026; connection job tools are a possible next addition. This page is updated when tools go live.

Resources

Related pages

See these tools run on your own data

Bring the question your operations team asks most. We will connect an assistant to a live InfiPlex instance and answer it, tool by tool.

Need a tool that is not here?

Tell us the operation and we will look at publishing the endpoint as a tool. Contact us, email info@infiplex.com, or call 888‑770‑0857.

Tool names, inputs, and behaviors are reproduced from the InfiPlex MCP server's tools/list response as of September 23, 2026. Claude is a trademark of Anthropic, PBC. ChatGPT and Codex are trademarks of OpenAI. Model Context Protocol is an open standard.