LAD Render Cloud MCP server
Commit Nov 11, 2026Converts TIA Portal SimaticML blocks into PNG ladder diagrams for visual review by AI agents.
Also known as tia-forge/lad-render-cloud, lad-render-cloud
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Nov 11, 2026
- License
- —
What is LAD Render Cloud MCP?
LAD Render Cloud converts TIA Portal SimaticML blocks into PNG ladder diagrams for visual review by AI agents.
Summary generated from the project's README
About LAD Render Cloud MCP server
LAD Render Cloud provides a way for AI agents to visually inspect Siemens TIA Portal logic without needing the original software installed. It converts SimaticML XML data from FC, FB, or OB blocks into PNG ladder diagrams. These images include actual ladder layouts such as contacts, coils, timers, counters, and branch merges rather than simple code text.
This remote service operates via streamable HTTP using JSON-RPC. Developers connect their MCP clients, such as Claude Code or Cursor, by configuring the endpoint at tia.hubwiz.com/render/mcp and providing a Bearer token for authentication. The system supports both LAD and SCL languages, though it will reject FBD, GRAPH, or STL formats.
Users can manage their usage through specific tools. The render_version tool is free and provides information on supported block types and input limits. The render_simaticml tool performs the actual conversion for a cost of one credit per block. You can also specify a single network index or adjust the image scale from 1 to 3 to manage large files.
What you can do with it
- 1Visual logic verificationAsk an AI agent to look at a generated ladder diagram to ensure the contacts and coils are placed correctly.
Written from the project's README. Every use case is checked against a quote from it.
How to install LAD Render Cloud MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall LAD Render Cloud MCP in Claude Code
$ claude mcp add --transport http lad-render-cloud https://tia.hubwiz.com/render/mcpInstall LAD Render Cloud MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"lad-render-cloud": {
"url": "https://tia.hubwiz.com/render/mcp"
}
}
}Install LAD Render Cloud MCP in VS Code
.vscode/mcp.json
{
"servers": {
"lad-render-cloud": {
"type": "http",
"url": "https://tia.hubwiz.com/render/mcp"
}
}
}Install LAD Render Cloud MCP in VS Code CLI
$ code --add-mcp '{"name":"lad-render-cloud","type":"http","url":"https://tia.hubwiz.com/render/mcp"}'Install LAD Render Cloud MCP in Codex
$ codex mcp add lad-render-cloud --url https://tia.hubwiz.com/render/mcpInstall LAD Render Cloud MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.lad-render-cloud] url = "https://tia.hubwiz.com/render/mcp"
Install LAD Render Cloud MCP in Gemini CLI
$ gemini mcp add -s user --transport http lad-render-cloud https://tia.hubwiz.com/render/mcpInstall LAD Render Cloud MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"lad-render-cloud": {
"url": "https://tia.hubwiz.com/render/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabletia-forge/lad-render-cloud is public and reachablegithub.com/tia-forge/lad-render-cloud ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-11github.com/tia-forge/lad-render-cloud ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubLAD Render Cloud — SimaticML → ladder diagram over MCP
LAD Render Cloud renders a TIA Portal SimaticML block (FC / FB / OB) into a PNG ladder diagram — real ladder layout (contacts, coils, timers/counters, branch merges, jumpers, network titles, interface declaration table), not syntax highlighting and not a code screenshot.
Use it so an AI agent's generated ladder logic can actually be looked at, on a machine that has no TIA Portal installed.
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/render/mcp - Transport: Streamable HTTP (stateless, POST JSON-RPC)
- Auth:
Authorization: Bearer render_live_…(theX-API-Keyheader is also accepted) - Dashboard / API keys: https://tia.hubwiz.com/render
- Registry entry:
io.github.tia-forge/lad-render-cloud(official MCP Registry)
What it does
| Tool | Purpose | Billing |
|---|---|---|
render_version |
Free: renderer version, supported languages / block types, size and input limits | free |
render_simaticml |
Take one SimaticML block, return its PNG ladder diagram | 1 credit |
initialize / tools/list / render_version are free; every other tools/call costs 1 credit, and
one call submits exactly one block.
Inputs and limits
- Accepted: FC / FB / OB blocks in LAD or SCL, including blocks where networks mix both.
- Rejected with an explicit error: GlobalDB / InstanceDB / UDT / tag tables (no ladder diagram to
draw) →
UNSUPPORTED_DOCUMENT; FBD / GRAPH / STL →UNSUPPORTED_LANGUAGE. - Options:
networkrenders a single 0-based network;scale(1–3) enlarges the image. - Limits: input XML 4 MiB, MCP request body 8 MiB, image 32,000,000 pixels with no side over
20,000 px, PNG 12 MiB, rate limit 120 requests/minute. Too tall, or
scaletoo large → render one network instead of the whole block.
How to get SimaticML
In TIA Portal: right-click the block → Export → XML. The saved
<Document><SW.Blocks.FC|FB|OB>… text is the SimaticML this service expects. No TIA Portal at hand?
Render one of the published example XMLs first.
Quick start
Claude Code
claude mcp add --transport http lad-render https://tia.hubwiz.com/render/mcp \
--header "Authorization: Bearer render_live_YOUR_KEY"
claude mcp list
Cursor / VS Code / any JSON-configured client
{
"mcpServers": {
"lad-render": {
"url": "https://tia.hubwiz.com/render/mcp",
"headers": { "Authorization": "Bearer render_live_YOUR_KEY" }
}
}
}
First calls
// free — what does this renderer support right now?
{ "name": "render_version", "arguments": {} }
// one block → PNG (costs 1 credit)
{ "name": "render_simaticml", "arguments": { "xml": "<Document>…</Document>" } }
// a single network, 2× larger
{ "name": "render_simaticml", "arguments": { "xml": "<Document>…</Document>", "network": 0, "scale": 2 } }
Pricing
| Pack | Price | Per render |
|---|---|---|
| Free trial (new API key) | 100 renders | — |
| 1,000 renders | ¥9.90 | ≈ ¥0.0099 |
| 5,000 renders | ¥29.90 | ≈ ¥0.0060 |
| 15,000 renders | ¥69.90 | ≈ ¥0.0047 |
No subscription, no monthly fee; balance is applied immediately, and render_version /
tools/list never consume credits.
Scope
- Renders text only: it does not connect to TIA Portal, does not read or write a project, and never downloads to a device. For on-premise project work use the TiaLink MCP gateway (https://github.com/tia-forge/tialink) instead.
- Output is for reading and review — it does not replace compiling the block in TIA Portal or commissioning on site.
Related
- TiaLink — TIA Portal MCP gateway, on your machine: https://github.com/tia-forge/tialink
- LadDoc Cloud — LadDoc IR → importable SimaticML: https://github.com/tia-forge/laddoc-cloud
- PLC Cloud Sim — validate and step-run LAD/SCL in the cloud: https://github.com/tia-forge/plc-cloud-sim
LAD Render Cloud MCP questions
How do I add LAD Render Cloud MCP to Claude Code?
Run claude mcp add --transport http lad-render-cloud https://tia.hubwiz.com/render/mcp in your terminal. Add --scope user to make it available in every project.
How do I add LAD Render Cloud MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does this tool connect directly to my TIA Portal project?
No, it only renders text; it does not connect to, read, or write to TIA Portal projects.