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
12 tools: 3 change things and 9 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things3Claude Code: ask: see these tools
- Only reads9Claude Code: allow: see these tools
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/mcpFindings
Matches of fixed checks, with the text they matched.
The server marks "opcua_model_generate" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true}; The name "opcua_model_generate" says "generate": a word for a change.
The server marks "opcua_model_create" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"openWorldHint":true}; The name "opcua_model_create" says "create": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"openWorldHint":true}; The name "opcua_model_create" says "create": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true}; The name "opcua_model_generate" says "generate": a word for a change.
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.
What this check looks forMatched 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)
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/mcpRun 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.
{
"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
