Skip to main content
Glama
iqms-mcp

iqms-mcp

by WYRE-AI

iqms-mcp

MCP server for IQMS / DELMIAworks (EnterpriseIQ), the manufacturing ERP from Dassault Systèmes.

Status: Read tools issue queries through @wyre-technology/node-iqms against the Direct Oracle path (always available). Write tools route through the licensed DELMIAworks WebAPI module — an optional add-on — and throw DriverNotConfiguredError until X-IQMS-WebAPI-Base-URL credentials are supplied.

Why this exists

EnterpriseIQ doesn't have a public REST API. The realistic integration paths are:

  1. Direct Oracle (universal at every install) — read-only queries

  2. WebAPI module (paid licensed add-on) — transactional writes

This MCP server exposes both behind a single decision-tree-navigated tool surface.

Related MCP server: Industrial MCP Agent Platform

Tools

Initial discovery surface (always available):

  • iqms_navigate — list tools in a domain

  • iqms_status — credential / connection check

Domains: workorders, inventory, boms, sales_orders, purchase_orders, schedule, quality.

Read tools (Oracle, available always):

Tool

Purpose

iqms_workorders_list

Open / in-progress work orders

iqms_workorders_get

Full work order detail incl. routings

iqms_inventory_onhand

On-hand by item / location / lot

iqms_inventory_lot_trace

Lot genealogy walk

iqms_boms_explode

BOM explosion

iqms_boms_where_used

Where-used reverse lookup

iqms_sales_orders_list

Open SOs / ship status

iqms_purchase_orders_list

Open POs / expected receipts

iqms_schedule_capacity

Machine schedule + capacity load

iqms_quality_ncrs

Non-conformances / CARs / CAPAs

Write tools (WebAPI, gated):

Tool

Purpose

iqms_workorders_create

Create a new work order

iqms_workorders_post_production

Post qty made / scrapped

iqms_inventory_adjust

Inventory transaction

iqms_quality_create_ncr

Open a non-conformance record

Run modes

Local (stdio)

IQMS_ORACLE_USER=eiq_ro \
IQMS_ORACLE_PASSWORD=… \
IQMS_ORACLE_CONNECT_STRING=eiq-db.example.com:1521/EIQ \
npx -y github:WYRE-AI/iqms-mcp

Gateway (HTTP, stateless)

CONDUIT_S2S_SECRET is required. If it is empty or a known placeholder (changeme, placeholder, your-s2s-secret, and the other example values rejected at startup), the HTTP server logs an error and exits non-zero. It never prints the secret. Set MCP_ALLOW_INSECURE_DEV=1 only for local development to start without the secret; the process logs a warning, does not check X-Gateway-S2S, and binds 127.0.0.1 only. A non-loopback MCP_HTTP_HOST (including 0.0.0.0) is ignored in that mode and the override is logged. A placeholder secret still refuses to start.

MCP_HTTP_HOST is honored when CONDUIT_S2S_SECRET is set, and defaults to 0.0.0.0 when unset. With no secret, the listener is 127.0.0.1. The container image sets MCP_HTTP_HOST=0.0.0.0 and AUTH_MODE=gateway.

CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
MCP_TRANSPORT=http \
MCP_HTTP_PORT=8080 \
AUTH_MODE=gateway \
node dist/http.js

Local HTTP without a secret is development-only and always binds 127.0.0.1:

MCP_ALLOW_INSECURE_DEV=1 npm run start:http

X-Gateway-S2S

With MCP_TRANSPORT=http and a real CONDUIT_S2S_SECRET, every /mcp request must include X-Gateway-S2S:

t=<unix seconds>,v1=<hex hmac-sha256>

The signature is HMAC-SHA256 of the literal message t=<unix seconds> (the same t= prefix that appears in the header), keyed with CONDUIT_S2S_SECRET, and hex-encoded. A missing or invalid header returns 401. /health stays unauthenticated and does not read vendor credentials. The stdio transport does not use CONDUIT_S2S_SECRET.

In AUTH_MODE=gateway, /mcp also requires the Oracle headers below. Those headers are the only credential source for that request. A request missing any of them returns 401 and does not fall back to IQMS_* in the process environment.

Header

Required

Notes

X-Gateway-S2S

yes, when CONDUIT_S2S_SECRET is set

t=<unix seconds>,v1=<hmac-sha256 hex of t=...>

X-IQMS-Oracle-User

yes

Oracle DB user

X-IQMS-Oracle-Password

yes

Oracle DB password

X-IQMS-Oracle-Connect-String

yes

Easy Connect or TNS

X-IQMS-WebAPI-Base-URL

no

Enables write tools when all three WebAPI headers are present

X-IQMS-WebAPI-User

no

X-IQMS-WebAPI-Password

no

Single-tenant HTTP (AUTH_MODE=env)

/mcp still requires a valid X-Gateway-S2S header. Vendor credentials come from IQMS_ORACLE_USER, IQMS_ORACLE_PASSWORD, and IQMS_ORACLE_CONNECT_STRING. Optional IQMS_WEBAPI_* variables enable write tools. This mode is separate from the gateway Compose service, which does not inject those variables.

Docker

The image listens on 0.0.0.0 inside the container and defaults to AUTH_MODE=gateway. Publish the port on loopback and pass the S2S secret. In gateway mode, IQMS credentials arrive on each request as headers; they are not read from the environment.

docker build -t iqms-mcp .
docker run \
  -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
  -p 127.0.0.1:8080:8080 \
  iqms-mcp

Compose refuses to start when CONDUIT_S2S_SECRET is unset, sets AUTH_MODE=gateway, publishes 127.0.0.1:8080:8080, and does not inject static IQMS_* credentials:

CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" docker compose up

License

Apache-2.0

Available Tools

16 tools
iqms_boms_explodeB

Explode a BOM. Single-level by default; pass max_level to recurse deeper.

Inputs: parent_item (required), max_level.

iqms_boms_where_usedB

Find every parent item that consumes a given component. Single-level by default.

Inputs: component_item (required), max_level.

iqms_inventory_adjustB

Post an inventory adjustment (positive or negative quantity). Requires WebAPI credentials.

Inputs: item_number (required), location (required), quantity_delta (required), reason_code (required), +2 more.

iqms_inventory_lot_traceB

Walk lot genealogy. Direction "from_components" walks back through inputs that produced the lot; "where_produced" walks forward to lots derived from it.

Inputs: lot_number (required), direction.

iqms_inventory_onhandB

List on-hand inventory by item, location, or lot. By default hides zero-quantity rows.

Inputs: item_number, location, lot_number, hide_zero_on_hand, +1 more.

iqms_navigateA

Navigate to an IQMS domain to see its tools. Domains: workorders, inventory, boms, sales_orders, purchase_orders, schedule, quality.

  • workorders: list/get work orders, post production

  • inventory: on-hand quantities, lot trace, inventory adjustments

  • boms: BOM explosion + where-used

  • sales_orders: open SOs, ship status

  • purchase_orders: open POs, expected receipts

  • schedule: machine schedule + capacity load

  • quality: non-conformances / CARs / CAPAs

Inputs: domain (required).

iqms_purchase_orders_listB

List purchase orders. Filter by status, supplier, or expected receipt date.

Inputs: status, supplier_id, expected_before, expected_after, +1 more.

iqms_quality_create_ncrC

Open a non-conformance record. Requires WebAPI credentials.

Inputs: description (required), item_number, work_order_id, reported_by.

iqms_quality_ncrsC

List non-conformances / Corrective Action Requests (CARs / CAPAs). Filter by status, item, or reported date.

Inputs: status, item_number, reported_after, reported_before, +1 more.

iqms_sales_orders_listB

List sales orders. Filter by status, customer, or requested ship date.

Inputs: status, customer_id, ship_before, ship_after, +1 more.

iqms_schedule_capacityB

List scheduled work-center slots within a date range.

Inputs: start_date (required), end_date (required), work_center, limit.

iqms_statusA

Check IQMS connection status — reports whether Oracle credentials are configured and whether the optional WebAPI (write) driver is enabled.

Inputs: no named parameters.

iqms_workorders_createC

Create a new work order. Requires WebAPI credentials (licensed module). Returns DriverNotConfiguredError when WebAPI is not configured.

Inputs: item_number (required), quantity (required), due_date, customer_id, +1 more.

iqms_workorders_getA

Get a single work order by ID, including routings.

Inputs: id (required).

iqms_workorders_listA

List work orders. Filter by status, customer, item, or due date. Returns up to limit rows (default 50, max 500).

Inputs: status, customer_id, item_number, due_before, +2 more.

iqms_workorders_post_productionC

Post production quantities (made / scrapped) against a work order. Requires WebAPI credentials.

Inputs: work_order_id (required), quantity_made (required), quantity_scrapped, scrap_reason_code, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 16 tools

    Disambiguation2/5

    Several tools have overlapping purposes, such as the domain-named tools (workorders, inventory, boms) which duplicate functionality already provided by specific prefixed tools like iqms_workorders_list, iqms_inventory_onhand, etc. This creates ambiguity about which tool to use.

    Naming Consistency2/5

    Naming is inconsistent: tools have either a 'iqms_' prefix with snake_case (e.g., iqms_boms_explode) or no prefix and just a noun (e.g., workorders, inventory). Additionally, some tools use verbs (list, get, create) while others are simply domain names.

    Tool Count4/5

    With 16 tools, the count is slightly above the typical 3-15 range but still reasonable for an ERP system covering multiple domains. The overlap reduces efficiency but does not make the count inappropriate.

    Completeness2/5

    The tool set covers basic retrieval and creation for several domains but lacks update, delete, and other lifecycle operations. For example, sales orders and purchase orders only have list tools, and no tools exist to modify or close records.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      This project builds a read-only MCP server. For full read, write, update, delete, and action capabilities and a simplified setup, check out our free CData MCP Server for Oracle SCM (beta): https://www.cdata.com/download/download.aspx?sku=KSZK-V&type=beta
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Universal MCP server for readonly-first access to Oracle, SQL Server, PostgreSQL, MySQL/MariaDB, SQLite, MongoDB, and Qdrant vector search.
      68 npm
      1
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server that connects to Oracle databases, enabling execution of registered and ad-hoc SQL queries, retrieval of business object details, and discovery of capabilities over stdio, HTTP/SSE, and REST transports.
      -