Norce Supplier MCP — Tool Reference

This page documents the tools exposed by the Norce Supplier MCP Server. For setup and connection instructions, see Using the Norce Backend MCP Servers.

response_format parameter: Most tools accept a response_format parameter — either "markdown" (default, human-readable) or "json" (for programmatic use). This parameter is not listed individually under each tool.

force_confirm parameter: Write tools include a force_confirm parameter, backed by a server-side guard that classifies each operation by impact. Lower-impact operations go through, with a warning attached on stage and production. Higher-impact operations are blocked on stage and production until force_confirm is set. A few destructive operations are blocked on every environment, including test. Each tool below states which of these applies.

Names as codes

A key convention in the Supplier MCP: the name field on warehouses and locations is also used as the code in Connect API imports and Query API lookups.

• Warehouse name = WarehouseCode in Connect supplier imports
• Location name = LocationCode in Connect supplier imports
• Price list code = PriceListCode in Connect supplier imports

Choose these values carefully when creating supplier infrastructure. Changing them after products have been imported will break existing stock and price update flows.

Tools

List Suppliers

norce_supplier_list_suppliers

Lists all suppliers with a summary view: ID, code, name, country, currency, active status, and whether chosen supplier logic is enabled.

Use this tool to find supplier IDs or codes before calling other tools, or to get an overview of which suppliers are configured for the client.

Parameters

• applicationId — any valid application ID for the client.
• include_deleted — set to true to include soft-deleted suppliers. Useful when diagnosing a missing supplier.

Output

A list of suppliers with their IDs, codes, names, country, currency, and status.

Get Supplier

norce_supplier_get_supplier

Returns full configuration for a single supplier — including all warehouses with their locations, and all price lists with their warehouse connections.

Use this tool as the primary read tool for supplier data. It replaces what would otherwise require separate calls to list warehouses, list locations, list price lists, and get price list connections. Always call this before updating warehouse connections, location lists, or price list settings — the full-replace operations need the current state first.

Accepts either supplier ID or supplier code.

Parameters

• applicationId — any valid application ID for the client.
• supplier_id or supplier_code — provide one, not both.

Output

The full supplier record with all warehouses (each with their locations) and all price lists (each with their warehouse connections).

Check Supplier Setup

norce_supplier_check_supplier_setup

Validates the full configuration chain for a supplier and returns a structured diagnostic report.

Use this tool before running a supplier product import to confirm the infrastructure is in place. A failing check will block imports or break availability calculations.

Checks performed

• Supplier exists and is active.
• At least one active warehouse exists.
• Each warehouse has at least one location (required for Connect imports).
• Each warehouse has a standard location (IsStandard = true).
• At least one active price list exists.
• At least one price list is marked primary (IsPrimary = true).
• Each active price list is connected to at least one warehouse.

Parameters

• applicationId — any valid application ID for the client.
• supplier_id or supplier_code — provide one, not both.

Output

A diagnostic report with issues[], warnings[], passed[], and an allOk boolean.

List Supplier Products

norce_supplier_list_supplier_products

Lists supplier product SKUs for a supplier from the Query API, with optional expansion to include prices and on-hand quantities.

Use this tool to verify which products are registered for a supplier, check product mappings (supplier part number to manufacturer part number), or audit stock and price data per supplier product. Supports pagination for large catalogues.

Note: the part_no field in supplier products is the supplier's own part number — not the client SKU part number.

Parameters

• applicationId — any valid application ID for the client.
• supplier_id or supplier_code — provide one, not both.
• part_nos — optional filter by one or more supplier part numbers.
• manufacturer_part_nos — optional filter by manufacturer part numbers.
• include_prices — set to true to include cost price and currency per price list.
• include_onhands — set to true to include stock levels per warehouse and location.
• limit / offset — pagination controls. Default 100 records, max 500 per call.

Output

A list of supplier product SKUs with supplier part number, manufacturer info, category, EAN, active status, and (optionally) prices and on-hand quantities.

Import Supplier Products

norce_supplier_import_products

Imports supplier product data — product identity, stock, prices, and parametric attributes — as an asynchronous batch job. Returns a job ID — use norce_supplier_get_import_job_status to confirm completion.

Use this tool when receiving a product feed from a supplier: new products, updated stock levels, updated cost prices, or updated product information.

The import header specifies which supplier, warehouse, and price list the records apply to. If warehouse or price list codes are omitted, the tool auto-resolves to the supplier's standard warehouse and primary price list.

Each record can include any combination of product identity, on-hand stock, price, and parametric attributes — include only what you have. The tool infers which fields are being set from what is present in the batch.

Parameters

• applicationId — any valid application ID for the client.
• supplier_code — the supplier code (not the supplier name).
• price_list_code — optional, defaults to the supplier's primary price list.
• warehouse_code — optional, defaults to the supplier's standard warehouse.
• location_code — optional, defaults to the standard location in the resolved warehouse.
• products — batch of supplier product records, minimum 1 and maximum 5000. Each record requires the supplier's own part number. All other fields (product name, manufacturer info, on-hand, price, parametric attributes) are optional.
• force_confirm — required on stage and production.

Output

A job ID for async status polling.

Get Import Job Status

norce_supplier_get_import_job_status

Checks the status of an asynchronous supplier product import job.

Use this tool after norce_supplier_import_products to confirm the import completed and check for errors. Poll until IsFinished is true.

Parameters

• applicationId — any valid application ID for the client.
• job_id — the job ID returned by norce_supplier_import_products.

Output

Job status, finish flag, and record counts (total, inserted, updated, failed).

Create Supplier

norce_supplier_create_supplier

Creates a new supplier record in Norce Commerce.

Use this tool when onboarding a new supplier. After creating the supplier, add at least one warehouse (norce_supplier_create_warehouse) and one price list (norce_supplier_create_price_list) before running any imports.

Important: is_chosen_supplier_enabled adds business logic to pricing and availability calculations. Only enable this if the supplier is intended to participate in chosen supplier rules — it has broader implications than a simple toggle.

Parameters

• applicationId — any valid application ID for the client.
• name — display name.
• code — unique supplier code.
• country_id — country ID. Use norce_config_get_client_overview to find country IDs.
• currency_id and currency_code — currency for this supplier.
• is_chosen_supplier_enabled — enable chosen supplier business logic. Default false.
• force_confirm — not required. Creation proceeds with a warning on stage and production.

Output

The created supplier ID.

Update Supplier

norce_supplier_update_supplier

Updates settings on an existing supplier. Only the fields provided are changed. Accepts supplier ID or code.

Note: supplier code and currency cannot be changed after creation.

Parameters

• applicationId — any valid application ID for the client.
• supplier_id or supplier_code — provide one, not both.
• name, is_active, is_chosen_supplier_enabled, and chosen supplier charge settings — any combination.
• force_confirm — required on stage and production.

Output

The updated supplier object.

Create Warehouse

norce_supplier_create_warehouse

Adds a new warehouse to a supplier.

Use this tool when setting up a new supplier or adding a warehouse to an existing one. After creating the warehouse, add at least one location using norce_supplier_update_locations — imports will not work without a location.

Important: The warehouse name is used as WarehouseCode in Connect imports. Choose a stable, code-like name (for example "Standard" or "EU-WH"). Renaming after products have been imported will break stock update flows.

Parameters

• applicationId — any valid application ID for the client.
• supplier_id or supplier_code — provide one, not both.
• name — warehouse name, also used as WarehouseCode in imports.
• standard_lead_time_days — default lead time for all products in this warehouse.
• is_standard — mark as the primary warehouse for this supplier. Only one can be standard.
• ignore_stock — exclude from stock-based business logic. Use for display-only or transit warehouses.
• force_confirm — not required. Creation proceeds with a warning on stage and production.

Output

The new warehouse ID.

Update Warehouse

norce_supplier_update_warehouse

Updates settings on an existing supplier warehouse. Only the fields provided are changed.

Important: Renaming the warehouse changes the WarehouseCode used in Connect imports. Only do this if no products have been imported against this warehouse.

Parameters

• applicationId — any valid application ID for the client.
• supplier_id or supplier_code — provide one, not both.
• warehouse_id — warehouse ID from norce_supplier_get_supplier.
• name, standard_lead_time_days, is_standard, ignore_stock, is_active — any combination.
• force_confirm — not required. Updates proceed with a warning on stage and production.

Output

The updated warehouse object.

Update Locations

norce_supplier_update_locations

Replaces the full list of locations for a supplier warehouse.

Use this tool to add, update, or reconfigure locations. This is also how you add the first location to a newly created warehouse.

Important: This is a full-replace operation — the list you provide becomes the complete set of locations for the warehouse. Always call norce_supplier_get_supplier first to retrieve the current locations, then include all existing locations plus any changes or additions in your request.

Important: Location name is used as LocationCode in Connect imports. Renaming an existing location after products have been imported will break stock update flows.

Parameters

• applicationId — any valid application ID for the client.
• supplier_id or supplier_code — provide one, not both.
• warehouse_id — warehouse ID from norce_supplier_get_supplier.
• locations — the complete list of locations. Each entry requires a name and is_standard. For existing locations include their ID; omit it for new ones. standard_lead_time_days overrides the warehouse lead time when set.
• force_confirm — not required. The update proceeds with a warning on stage and production.

Output

Confirmation of the update. Fetch the supplier again with norce_supplier_get_supplier to verify.

Create Price List

norce_supplier_create_price_list

Adds a new price list to a supplier.

Use this tool when setting up a new supplier or adding a cost price list for a new currency or purpose. After creating the price list, connect it to a warehouse using norce_supplier_update_price_list_warehouses — without this connection it will not function correctly in availability calculations.

Important: The price list code is used as PriceListCode in Connect imports. Choose it carefully and do not change it after products have been imported against it.

Parameters

• applicationId — any valid application ID for the client.
• supplier_id or supplier_code — provide one, not both.
• name — display name.
• code — unique code, also used as PriceListCode in imports.
• currency_id — currency for this price list.
• is_primary — mark as the primary price list. Only one price list per supplier should be primary.
• force_confirm — not required. Creation proceeds with a warning on stage and production.

Output

The new price list ID.

Update Price List

norce_supplier_update_price_list

Updates settings on an existing supplier price list. Only the fields provided are changed.

Important: Changing the price list code breaks Connect imports that reference the old PriceListCode. Only rename if no products have been imported against this price list.

Parameters

• applicationId — any valid application ID for the client.
• supplier_id or supplier_code — provide one, not both.
• price_list_id — price list ID from norce_supplier_get_supplier.
• name, is_active, is_primary, is_manually_maintained, description — any combination.
• force_confirm — required on stage and production.

Output

The updated price list object.

Update Price List Warehouse Connections

norce_supplier_update_price_list_warehouses

Replaces the full list of warehouse connections for a supplier price list.

Use this tool after creating a price list to connect it to a warehouse, or to change which warehouses a price list is associated with. This connection determines which supplier stock is used for availability calculations when this price list is active.

Important: This is a full-replace operation. Always call norce_supplier_get_supplier first to retrieve the current connections for the price list, then include all existing connections plus any new ones in your request.

Parameters

• applicationId — any valid application ID for the client.
• supplier_id — supplier ID.
• price_list_id — price list ID from norce_supplier_get_supplier.
• connections — the complete list of warehouse connections. Each entry requires a warehouse ID. Location ID is optional but recommended for precise availability control.
• force_confirm — required on stage and production.

Output

Confirmation of the update.

Typical workflows

Setting up a new supplier from scratch

1. Call norce_supplier_create_supplier with the supplier's name, code, country, and currency.
2. Call norce_supplier_create_warehouse to add the first warehouse. Use a stable, code-like name.
3. Call norce_supplier_update_locations to add at least one location to the warehouse. Mark one location as standard.
4. Call norce_supplier_create_price_list to add the cost price list. Use a stable code.
5. Call norce_supplier_update_price_list_warehouses to connect the price list to the warehouse.
6. Call norce_supplier_check_supplier_setup to verify the full configuration is correct before importing.

Validating a supplier before importing

1. Call norce_supplier_check_supplier_setup to run the full validation chain.
2. If any checks fail, call norce_supplier_get_supplier to inspect the current configuration and identify what is missing.
3. Fix each issue using the appropriate create or update tool.
4. Run norce_supplier_check_supplier_setup again to confirm all checks pass.

Importing a supplier product feed

1. Call norce_supplier_check_supplier_setup to confirm the supplier infrastructure is in place.
2. Call norce_supplier_get_supplier to get the warehouse and price list codes if they are not already known.
3. Prepare the batch — each record needs at minimum the supplier's own part number.
4. Call norce_supplier_import_products with the full batch.
5. Poll norce_supplier_get_import_job_status until IsFinished is true.
6. Spot-check a sample of records with norce_supplier_list_supplier_products to verify the data landed correctly.

Auditing supplier product mappings

1. Call norce_supplier_list_supplier_products with include_prices = true and include_onhands = true.
2. Use manufacturer_part_nos filtering to check whether specific client SKUs are mapped.
3. If mappings are missing or incorrect, update them via a new norce_supplier_import_products call with the corrected manufacturer part numbers.