LadDoc Cloud — LadDoc to SimaticML over MCP

io.github.tia-forgePublished by GitHub account tia-forgev0.1.1Updated Oct 25, 2026

Generate TIA Portal importable SimaticML (V19) from LadDoc IR, with strict validation, over MCP.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Remote MCP service that validates ladder-logic LadDoc documents and generates TIA Portal-importable SimaticML (V19) blocks.

What you can do
Check the LAD-IR schema version, bundle hash and source commit the service implements, free of charge and without a paid call count being consumed for version checks per the README's pricing note (lad_version). Validate a single LadDoc document and get back a valid flag plus issues with code, path and message (lad_validate). Generate a SimaticML block (FC, FB or OB) only when validation passes, with deterministic, byte-identical output and generator-assigned UIds and connections (lad_generate). Optionally cross-check against a target project's inventory to catch symbol mismatches before generation. One document per call, so several blocks mean several calls.
When to use it
Useful when you have ladder logic expressed as LadDoc IR and want an assistant to check it and produce SimaticML for import into TIA Portal V19. The validation gate suits workflows where an unimportable block must never reach the PLC project.
Requirements
A remote Streamable HTTP endpoint; no local package or runtime. A bearer API key sent in the Authorization header (an X-API-Key header is also accepted), obtained from the provider's dashboard; WeChat login there issues a free key with 100 calls. Network access to the provider's host.
Before you install
The Authorization header carries a secret API key; keep it out of shared configuration and logs. Calls beyond the free allowance are billed per the provider's pricing, so repeated validate-and-retry loops consume quota. The service only produces text/XML and does not touch a running TIA Portal; importing and compiling is a separate step. It is an independent third-party tool, not affiliated with Siemens.

Installation

In SourceWeft

  1. Open LadDoc Cloud — LadDoc to SimaticML over MCP in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.tia-forge%2Fladdoc-cloud/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "laddoc-cloud-laddoc-to-simaticml-over": {
      "type": "http",
      "url": "https://tia.hubwiz.com/lad/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

LadDoc Cloud — LadDoc → SimaticML over MCP

LadDoc Cloud turns a ladder-logic document (LadDoc IR) into SimaticML that TIA Portal imports directly — with a strict validation gate in front of the generator.

This repository is documentation and client configuration only. The service runs at tia.hubwiz.com; its implementation is not open source.

  • Endpoint: https://tia.hubwiz.com/lad/mcp
  • Transport: Streamable HTTP (stateless, POST JSON-RPC)
  • Auth: Authorization: Bearer lad_live_… (the X-API-Key header is also accepted)
  • Dashboard / API keys: https://tia.hubwiz.com/lad
  • Registry entry: io.github.tia-forge/laddoc-cloud (official MCP Registry)

What it does

ToolPurpose
lad_versionFree: returns the LAD-IR identity this service implements (schemaVersion, bundleHash, sourceCommit)
lad_validateValidate one LadDoc document; returns valid plus issues with code / path / message
lad_generateGenerate a SimaticML block (FC / FB / OB) — only if validation passes

Behaviour worth knowing:

  • Validation is the gate. One issue and no XML is produced — you never hand TIA Portal a block that cannot be imported. Fix and retry; the remaining issues come back in full.
  • Deterministic output. The same LadDoc always produces byte-identical SimaticML; UIds and connections are assigned by the generator.
  • Target format: V19 SimaticML documents.
  • Optional cross-check: pass the target project's inventory to catch symbol mismatches before generation.
  • One document per call: to generate several blocks, call once per block (called FC/FBs are submitted as their own documents).

Quick start

Claude Code

bash
claude mcp add --transport http lad-cloud https://tia.hubwiz.com/lad/mcp \  --header "Authorization: Bearer lad_live_YOUR_KEY"claude mcp list

Cursor / VS Code / any JSON-configured client

json
{  "mcpServers": {    "lad-cloud": {      "url": "https://tia.hubwiz.com/lad/mcp",      "headers": { "Authorization": "Bearer lad_live_YOUR_KEY" }    }  }}

First calls

jsonc
// free — confirm which LAD-IR bundle this service implements{ "name": "lad_version", "arguments": {} }
// validate, then generate{ "name": "lad_validate", "arguments": { "doc": { "schemaVersion": "1.0", "block": { /* … */ } } } }{ "name": "lad_generate", "arguments": { "doc": { /* same doc */ } } }

Pricing

WeChat login on the dashboard issues a key immediately: 100 calls free. Handshake requests (initialize, tools/list) and lad_version are free.

Notes

  • This service produces text/XML; it does not touch a running TIA Portal. To import the result and compile it, use TIA Portal itself or the on-machine gateway (TiaLink).
  • Free companion: PLC Cloud Sim runs the logic before you import it.
  • Documentation license: CC BY 4.0. "TIA Portal", "SIMATIC" and "S7" are trademarks of Siemens AG; this service is an independent third-party tool, not affiliated with or endorsed by Siemens.

Source: README.md at commit a21c4f6

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v0.1.1LatestOct 25, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.