Skip to content

OPC UA Modeler

by node-opcua · remote · local (npm) · no sign-in to list tools · v1.6.1 · published by GitHub user node-opcua

OPC UA companion spec types, namespace dependencies, and engineering units for AI agents

Changes · 3

12 tools: 3 change things and 9 only read.

Scanned Oct 21, 2026

2 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http node-opcua-modeler https://api.opcua-modeler.sterfive.io/api/mcp

Findings

Matches of fixed checks, with the text they matched.

2 warn
  • The server marks "opcua_model_generate" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true}; The name "opcua_model_generate" says "generate": a word for a change.

    What this check looks for
  • The server marks "opcua_model_create" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"openWorldHint":true}; The name "opcua_model_create" says "create": a word for a change.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

12 tools

Changes things 3Claude Code: ask
  • opcua_model_createGenerate an OPC UA YAML model from a natural language description using AI.Reads text others write1 finding

    Why it is in this group

    • The name "opcua_model_create" says "create": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Warn

      The server marks "opcua_model_create" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"openWorldHint":true}; The name "opcua_model_create" says "create": a word for a change.

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • opcua_model_generateGenerate OPC UA NodeSet2.xml and the symbols CSV from a YAML model.Reads text others write1 finding

    Why it is in this group

    • The name "opcua_model_generate" says "generate": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.

    Findings

    • Warn

      The server marks "opcua_model_generate" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true}; The name "opcua_model_generate" says "generate": a word for a change.

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: true
  • opcua_model_reverseReverse-engineer a NodeSet2.xml file back into the YAML DSL format.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: true
Only reads 9Claude Code: allow
  • find_engineering_unitFind the official UNECE Rec.No findings

    Why it is in this group

    • The name "find_engineering_unit" says "find": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: false
  • find_reusable_blockFind reusable Interfaces / AddIns by capability — pass a member name or keyword (e.g.No findings

    Why it is in this group

    • The name "find_reusable_block" says "find": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: false
  • get_dsl_referenceGet the grammar reference for the OPC UA modeler YAML DSL: file header, top-level sections, name-prefix conventions, minimal examples, and common mistakes.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_dsl_reference" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "get" and "file": it reads files.
    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: true
  • get_type_detailsGet detailed information about a specific type: its components, properties, methods, interfaces, and optional members.No findings

    Why it is in this group

    • The name "get_type_details" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: false
  • list_namespacesList all well-known OPC UA companion spec namespace aliases with their full names, URIs, and dependencies.No findings

    Why it is in this group

    • The name "list_namespaces" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: false
  • list_typesList ALL ObjectTypes, VariableTypes, and InterfaceTypes defined in a specific companion spec namespace.No findings

    Why it is in this group

    • The name "list_types" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: false
  • opcua_model_validateValidate an OPC UA YAML model for correctness.Reads text others writeNo findings

    Why it is in this group

    • The name "opcua_model_validate" says "validate": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: true
  • resolve_dependenciesGiven one or more companion spec namespace aliases, returns the full resolved dependency list that MUST go in the YAML `namespaces:` section.No findings

    Why it is in this group

    • The name "resolve_dependencies" says "resolve": a word for reading.
    Description, as the server wrote 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.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: false
  • search_typesSearch for types across ALL companion specs by keyword.No findings

    Why it is in this group

    • The name "search_types" says "search": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

No private-data, untrusted-input, outbound path in this server alone: no tool is tagged outbound.

Reads private data1
Reads files, mail, messages, databases, secrets, calendars or repositories.
Reads text others write5
Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
Can send data out0
Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Remote posture

What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.

Looked at Oct 22, 2026, 15:03 UTC, unchanged since Oct 22, 2026. No credentials were sent and no tool was called. What is looked at.

Reachable
yes
HTTP status of an anonymous initialize
200
tools/list served without credentials
yes
Tools that change things, listed without credentials
3
Protocol version
2025-06-18
WWW-Authenticate on 401
not observed
resource_metadata in WWW-Authenticate
none
RFC 9728 protected resource metadata
none
Authorization servers
none
Legacy HTTP+SSE transport
no
Dynamic client registration
not observed
Client ID metadata documents
not observed
  • WarnThe whole server

    The endpoint served tools/list without credentials, and the list has 3 tools that change things (3 write). Whether a call also works without credentials was not tested: tools are never called.

    Matched text

    https://api.opcua-modeler.sterfive.io/api/mcp: tools/list returned 12 tools to an anonymous client, including opcua_model_generate (write), opcua_model_reverse (write), opcua_model_create (write)

    What this check looks for

Install

Pinned to version 1.6.1. Values in angle brackets are yours to fill in.

claude mcp add --transport http node-opcua-modeler https://api.opcua-modeler.sterfive.io/api/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__node-opcua-modeler__resolve_dependencies",
      "mcp__node-opcua-modeler__list_namespaces",
      "mcp__node-opcua-modeler__list_types",
      "mcp__node-opcua-modeler__get_type_details",
      "mcp__node-opcua-modeler__search_types",
      "mcp__node-opcua-modeler__find_reusable_block",
      "mcp__node-opcua-modeler__find_engineering_unit",
      "mcp__node-opcua-modeler__get_dsl_reference",
      "mcp__node-opcua-modeler__opcua_model_validate"
    ],
    "ask": [
      "mcp__node-opcua-modeler__opcua_model_generate",
      "mcp__node-opcua-modeler__opcua_model_reverse",
      "mcp__node-opcua-modeler__opcua_model_create"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as node-opcua-modeler. Review it before you use it.

Capability tags behind 5 rules
  • mcp__node-opcua-modeler__get_dsl_reference private-data, untrusted-input
  • mcp__node-opcua-modeler__opcua_model_validate untrusted-input
  • mcp__node-opcua-modeler__opcua_model_generate untrusted-input
  • mcp__node-opcua-modeler__opcua_model_reverse untrusted-input
  • mcp__node-opcua-modeler__opcua_model_create untrusted-input