OPC UA Modeler is an MCP server published by io.github.node-opcua, hosted at api.opcua-modeler.sterfive.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 12 tools, including resolve_dependencies, list_namespaces, list_types, get_type_details, search_types.
OPC UA companion spec types, namespace dependencies, and engineering units for AI agents
Nothing else in the archive shares these values.
Inferred from the host name and headers: what a server runs on, not who runs it.
Given one or more companion spec namespace aliases, returns the full resolved dependency list that MUST go in the YAML `namespaces:` section. Always call this before generating the namespaces block.
| Parameter | Type | Description |
|---|---|---|
| aliases * | array | Companion spec aliases to resolve (e.g. ["machineTool", "robotics"]) |
{
"name": "resolve_dependencies",
"title": "Resolve namespace dependencies",
"description": "Given one or more companion spec namespace aliases, returns the full resolved dependency list that MUST go in the YAML `namespaces:` section. Always call this before generating the namespaces block.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"aliases"
],
"properties": {
"aliases": {
"type": "array",
"items": {
"type": "string"
},
"description": "Companion spec aliases to resolve (e.g. [\"machineTool\", \"robotics\"])"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
List all well-known OPC UA companion spec namespace aliases with their full names, URIs, and dependencies. Use this to discover what namespaces are available.
No parameters.
{
"name": "list_namespaces",
"title": "List companion specifications",
"description": "List all well-known OPC UA companion spec namespace aliases with their full names, URIs, and dependencies. Use this to discover what namespaces are available.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}List ALL ObjectTypes, VariableTypes, and InterfaceTypes defined in a specific companion spec namespace. ALWAYS call this before using any type from a namespace — NEVER guess type names.
| Parameter | Type | Description |
|---|---|---|
| alias * | string | Companion spec alias (e.g. "machinery", "di", "robotics") |
{
"name": "list_types",
"title": "List types in a namespace",
"description": "List ALL ObjectTypes, VariableTypes, and InterfaceTypes defined in a specific companion spec namespace. ALWAYS call this before using any type from a namespace — NEVER guess type names.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"alias"
],
"properties": {
"alias": {
"type": "string",
"description": "Companion spec alias (e.g. \"machinery\", \"di\", \"robotics\")"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}Get detailed information about a specific type: its components, properties, methods, interfaces, and optional members. Use this to understand a type's structure before creating instances or subtypes. `specRef`, on the type and on a member, is the link to the section of the specification that defines it: cite it.
| Parameter | Type | Description |
|---|---|---|
| alias * | string | Companion spec alias where the type is defined (e.g. "machinery") |
| browseName * | string | The type browse name (e.g. "MachineryItemIdentificationType") |
{
"name": "get_type_details",
"title": "Get type details",
"description": "Get detailed information about a specific type: its components, properties, methods, interfaces, and optional members. Use this to understand a type's structure before creating instances or subtypes. `specRef`, on the type and on a member, is the link to the section of the specification that defines it: cite it.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"alias",
"browseName"
],
"properties": {
"alias": {
"type": "string",
"description": "Companion spec alias where the type is defined (e.g. \"machinery\")"
},
"browseName": {
"type": "string",
"description": "The type browse name (e.g. \"MachineryItemIdentificationType\")"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}Search for types across ALL companion specs by keyword. Use this when you don't know which namespace defines a type. Returns matching types with their namespace alias.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Search keyword (e.g. "identification", "temperature", "motion") |
{
"name": "search_types",
"title": "Search types across specs",
"description": "Search for types across ALL companion specs by keyword. Use this when you don't know which namespace defines a type. Returns matching types with their namespace alias.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Search keyword (e.g. \"identification\", \"temperature\", \"motion\")"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}Find reusable Interfaces / AddIns by capability — pass a member name or keyword (e.g. "SerialNumber", "DeviceHealth", "Location") and get the standard blocks that already expose it. PREFER applying/composing an existing block over redefining its members inline. Interfaces are applied with `interfaces:`; addins (types with a DefaultInstanceBrowseName) are composed with `addIns:`. A single property → use the Interface; a whole named sub-object → use the AddIn.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Member name or capability keyword (e.g. "SerialNumber", "health", "calibration") |
{
"name": "find_reusable_block",
"title": "Find a reusable interface or AddIn",
"description": "Find reusable Interfaces / AddIns by capability — pass a member name or keyword (e.g. \"SerialNumber\", \"DeviceHealth\", \"Location\") and get the standard blocks that already expose it. PREFER applying/composing an existing block over redefining its members inline. Interfaces are applied with `interfaces:`; addins (types with a DefaultInstanceBrowseName) are composed with `addIns:`. A single property → use the Interface; a whole named sub-object → use the AddIn.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Member name or capability keyword (e.g. \"SerialNumber\", \"health\", \"calibration\")"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}Find the official UNECE Rec. 20 engineering unit symbol for a given description. ALWAYS call this before using any engineering unit — NEVER guess unit symbols.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Description or common name of the unit (e.g. "revolutions per minute", "celsius", "pressure bar") |
{
"name": "find_engineering_unit",
"title": "Find an engineering unit",
"description": "Find the official UNECE Rec. 20 engineering unit symbol for a given description. ALWAYS call this before using any engineering unit — NEVER guess unit symbols.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Description or common name of the unit (e.g. \"revolutions per minute\", \"celsius\", \"pressure bar\")"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}Get the grammar reference for the OPC UA modeler YAML DSL: file header, top-level sections, name-prefix conventions, minimal examples, and common mistakes. Call this FIRST before writing any YAML model by hand. Works without an API key.
No parameters.
{
"name": "get_dsl_reference",
"title": "Get the DSL grammar reference",
"description": "Get the grammar reference for the OPC UA modeler YAML DSL: file header, top-level sections, name-prefix conventions, minimal examples, and common mistakes. Call this FIRST before writing any YAML model by hand. Works without an API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}Validate an OPC UA YAML model for correctness. Returns diagnostics with severity (error/warning/info), codes, messages, and line numbers. Works without an API key (limited to 50 calls/day). ALWAYS validate before generating.
| Parameter | Type | Description |
|---|---|---|
| yaml * | string | The full YAML model source to validate |
{
"name": "opcua_model_validate",
"title": "Validate an OPC UA model",
"description": "Validate an OPC UA YAML model for correctness. Returns diagnostics with severity (error/warning/info), codes, messages, and line numbers. Works without an API key (limited to 50 calls/day). ALWAYS validate before generating.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"yaml"
],
"properties": {
"yaml": {
"type": "string",
"description": "The full YAML model source to validate"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}Generate OPC UA NodeSet2.xml and the symbols CSV from a YAML model. Requires an API key (set OPCUA_MODELER_API_KEY env var). NodeIds stay stable only if each regeneration passes back the symbols of the previous one: pass symbols_csv, or mode "new" for a first generation, or mode "renumber" to change ids on purpose. A call with none of these is refused with SYMBOLS_DECISION_REQUIRED. Returns base64-encoded artifacts if the model is valid. The result lists symbol counts (reused/new/dropped), hints and next steps.
| Parameter | Type | Description |
|---|---|---|
| mode | string | "new": first generation, no symbols yet. "update": regeneration, symbols required. "renumber": allocate new NodeIds on purpose. Omit when passing symbols. |
| yaml * | string | The full YAML model source to generate from |
| symbols_csv | string | The symbols CSV of the previous generation (the content of <name>.model.symbols.csv, or the base64 symbols_csv a previous call returned). Keeps NodeIds stable. |
| include_docs | boolean | Set to true to include markdown documentation (slower) |
{
"name": "opcua_model_generate",
"title": "Generate NodeSet2 XML",
"description": "Generate OPC UA NodeSet2.xml and the symbols CSV from a YAML model. Requires an API key (set OPCUA_MODELER_API_KEY env var). NodeIds stay stable only if each regeneration passes back the symbols of the previous one: pass symbols_csv, or mode \"new\" for a first generation, or mode \"renumber\" to change ids on purpose. A call with none of these is refused with SYMBOLS_DECISION_REQUIRED. Returns base64-encoded artifacts if the model is valid. The result lists symbol counts (reused/new/dropped), hints and next steps.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"yaml"
],
"properties": {
"mode": {
"enum": [
"new",
"update",
"renumber"
],
"type": "string",
"description": "\"new\": first generation, no symbols yet. \"update\": regeneration, symbols required. \"renumber\": allocate new NodeIds on purpose. Omit when passing symbols."
},
"yaml": {
"type": "string",
"description": "The full YAML model source to generate from"
},
"symbols_csv": {
"type": "string",
"description": "The symbols CSV of the previous generation (the content of <name>.model.symbols.csv, or the base64 symbols_csv a previous call returned). Keeps NodeIds stable."
},
"include_docs": {
"type": "boolean",
"description": "Set to true to include markdown documentation (slower)"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"valid",
"mode",
"symbols_source",
"symbols",
"diagnostics",
"hints",
"next_steps"
],
"properties": {
"mode": {
"enum": [
"new",
"update",
"renumber"
],
"type": "string"
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"role",
"path",
"bytes",
"status"
],
"properties": {
"path": {
"type": "string"
},
"role": {
"enum": [
"nodeset",
"symbols",
"documentation"
],
"type": "string"
},
"bytes": {
"type": "number"
},
"status": {
"enum": [
"written",
"unchanged"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"hints": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"level",
"message"
],
"properties": {
"code": {
"type": "string"
},
"level": {
"enum": [
"info",
"warning"
],
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"valid": {
"type": "boolean"
},
"symbols": {
"anyOf": [
{
"type": "object",
"required": [
"reused",
"new",
"dropped",
"renumbered",
"match",
"new_names",
"dropped_names"
],
"properties": {
"new": {
"type": "number"
},
"match": {
"type": "number"
},
"reused": {
"type": "number"
},
"dropped": {
"type": "number"
},
"new_names": {
"type": "array",
"items": {
"type": "string"
}
},
"renumbered": {
"type": "number"
},
"dropped_names": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"artifacts": {
"type": "object",
"required": [
"nodeset2_xml",
"symbols_csv"
],
"properties": {
"symbols_csv": {
"type": "string"
},
"nodeset2_xml": {
"type": "string"
},
"documentation_md": {
"type": "string"
}
},
"additionalProperties": false
},
"next_steps": {
"type": "array",
"items": {
"type": "string"
}
},
"diagnostics": {
"type": "array",
"items": {
"type": "object",
"required": [
"severity",
"message"
],
"properties": {
"code": {
"type": "string"
},
"line": {
"type": [
"number",
"null"
]
},
"message": {
"type": "string"
},
"severity": {
"type": "string"
}
},
"additionalProperties": false
}
},
"symbols_source": {
"enum": [
"argument",
"paired-file",
"stream",
"none"
],
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}Reverse-engineer a NodeSet2.xml file back into the YAML DSL format. Requires an API key (set OPCUA_MODELER_API_KEY env var). Optionally specify the target namespace URI to extract.
| Parameter | Type | Description |
|---|---|---|
| xml * | string | The NodeSet2.xml content to reverse-engineer |
| namespace_uri | string | Target namespace URI to extract (auto-detected if omitted) |
| self_contained | boolean | Return one self-contained .opcua.yaml stream: the model, its NodeId symbol table and dependency declarations (default: bare YAML) |
{
"name": "opcua_model_reverse",
"title": "Reverse-engineer NodeSet2 XML",
"description": "Reverse-engineer a NodeSet2.xml file back into the YAML DSL format. Requires an API key (set OPCUA_MODELER_API_KEY env var). Optionally specify the target namespace URI to extract.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"xml"
],
"properties": {
"xml": {
"type": "string",
"description": "The NodeSet2.xml content to reverse-engineer"
},
"namespace_uri": {
"type": "string",
"description": "Target namespace URI to extract (auto-detected if omitted)"
},
"self_contained": {
"type": "boolean",
"description": "Return one self-contained .opcua.yaml stream: the model, its NodeId symbol table and dependency declarations (default: bare YAML)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}Generate an OPC UA YAML model from a natural language description using AI. Requires an API key (set OPCUA_MODELER_API_KEY env var). The AI will auto-detect relevant companion specs, generate a validated model with documentation, and auto-correct validation errors.
| Parameter | Type | Description |
|---|---|---|
| prompt * | string | Natural language description of the OPC UA model to generate |
| forceSpecs | array | Companion spec aliases to force (e.g. ["di", "ia"]) |
{
"name": "opcua_model_create",
"title": "Create a model from a description",
"description": "Generate an OPC UA YAML model from a natural language description using AI. Requires an API key (set OPCUA_MODELER_API_KEY env var). The AI will auto-detect relevant companion specs, generate a validated model with documentation, and auto-correct validation errors.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string",
"description": "Natural language description of the OPC UA model to generate"
},
"forceSpecs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Companion spec aliases to force (e.g. [\"di\", \"ia\"])"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Names, descriptions and schemas were written by the server and are shown as data.