iqms-mcp
This server lets you read IQMS/DELMIAworks ERP data via Oracle and, when licensed WebAPI credentials are configured, perform selected write operations through domain-navigated MCP tools.
Discover tools and check connection/credential status with
iqms_navigateandiqms_status.Work orders: list/filter open, in-progress, complete, cancelled, or on-hold WOs; get WO detail including routings.
Inventory: view on-hand quantities by item/location/lot; trace lot genealogy forward or backward.
BOMs: explode parent BOMs and find where-used components.
Sales orders: list/filter by status, customer, or ship-date window.
Purchase orders: list/filter by status, supplier, or expected receipt date.
Schedule: view work-center scheduled slots and capacity load over a date range.
Quality: list non-conformances, CARs, and CAPAs by status/item/date.
Gated writes via WebAPI: create work orders, post production made/scrapped quantities, adjust inventory, and create NCRs; without WebAPI credentials these tools return
DriverNotConfiguredError.Read tools use Direct Oracle and are always available; write tools require the optional licensed DELMIAworks WebAPI module.
Provides tools to interact with IQMS/DELMIAworks (EnterpriseIQ) manufacturing ERP from Dassault Systèmes, enabling queries and operations on work orders, inventory, BOMs, sales orders, purchase orders, schedule, and quality.
iqms-mcp
MCP server for IQMS / DELMIAworks (EnterpriseIQ), the manufacturing ERP from Dassault Systèmes.
Status: Read tools issue queries through
@wyre-technology/node-iqmsagainst the Direct Oracle path (always available). Write tools route through the licensed DELMIAworks WebAPI module — an optional add-on — and throwDriverNotConfiguredErroruntilX-IQMS-WebAPI-Base-URLcredentials are supplied.
Why this exists
EnterpriseIQ doesn't have a public REST API. The realistic integration paths are:
Direct Oracle (universal at every install) — read-only queries
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 domainiqms_status— credential / connection check
Domains: workorders, inventory, boms, sales_orders, purchase_orders,
schedule, quality.
Read tools (Oracle, available always):
Tool | Purpose |
| Open / in-progress work orders |
| Full work order detail incl. routings |
| On-hand by item / location / lot |
| Lot genealogy walk |
| BOM explosion |
| Where-used reverse lookup |
| Open SOs / ship status |
| Open POs / expected receipts |
| Machine schedule + capacity load |
| Non-conformances / CARs / CAPAs |
Write tools (WebAPI, gated):
Tool | Purpose |
| Create a new work order |
| Post qty made / scrapped |
| Inventory transaction |
| 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-mcpGateway (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.jsLocal HTTP without a secret is development-only and always binds 127.0.0.1:
MCP_ALLOW_INSECURE_DEV=1 npm run start:httpX-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 |
| yes, when |
|
| yes | Oracle DB user |
| yes | Oracle DB password |
| yes | Easy Connect or TNS |
| no | Enables write tools when all three WebAPI headers are present |
| no | |
| 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-mcpCompose 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 upLicense
Apache-2.0
Available Tools
16 toolsiqms_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_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
Scored across 16 tools
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 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.
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.
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
Related MCP Connectors
MCP server for Arcoro and ExakTime — workforce data, jobs, cost codes and locations.
MCP server for MarketTime — wholesale orders, customers, catalog and shipment tracking.
The best QuickBooks Desktop MCP server on the planet: every operation on every record type
MCP server for Flex on the Job: inventory, jobs, customers, invoices, purchasing, sales orders.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceThis 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=betaMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for integrating manufacturing systems (MES/ERP/quality/maintenance) with LLM agents, enabling event ingestion, incident triage, approval workflows, and RAG-based knowledge retrieval.MIT
- AlicenseNot gradedqualityCmaintenanceUniversal MCP server for readonly-first access to Oracle, SQL Server, PostgreSQL, MySQL/MariaDB, SQLite, MongoDB, and Qdrant vector search.68 npm1MIT
- FlicenseNot gradedqualityCmaintenanceMCP 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.-