MCP Server for AI Agents

Let Claude, ChatGPT, Codex, Cursor and other AI agents generate, convert and check WinCC Unified widgets with the same tools that run on svghmi.pro.

What it does

Your AI agent connects to https://mcp.svghmi.pro over MCP and gets real tools instead of hand-writing SVGHMI, which WinCC Unified often rejects. It works with your svghmi.pro account and the same credits as the site.

  • 26tools
  • 3 variantsper generated widget
  • 570+ready-made widgets to search
  • Freecatalog, checks and previews

A typical session

  1. You ask"Draw me a centrifugal pump for WinCC Unified"
  2. The agent checks the catalog firstsearch_widgets looks for a ready-made pump. If none fits, generate_widget starts a generation, and the agent tells you how long it will take (about a minute for equipment).
  3. You pick one of three variantsThe agent shows a sheet with variants A, B and C. You say "B", and choose_variant returns the .svghmi file with a unique type name such as AiWidget_Pump_3f2a1c, its properties and a download link.
  4. Adjust if needed"Make the motor longer" goes to refine_widget (the first 3 edits are free); "the same in ISA-101 grey" goes to restyle_widget (free).
  5. Import into TIA PortalCopy the file into UserFiles\SvgControls of your project, open a screen and press "Refreshes the outdated dynamic graphics" in the Dynamic widgets section of the toolbox. Keep the file name.

Already have an SVG? The agent converts it with convert_svg_to_svghmi, checks it and shows a preview:

An agent session: the request for a 3-way valve widget, the tool calls search_widgets, convert_svg_to_svghmi, validate_svghmi and render_svghmi_preview, and the saved .svghmi file

All 26 tools

Prices are for an svghmi.pro account (API key or sign-in). Free tools cost nothing, however often they are called.

Generate widgets with AI

A new widget from a plain-language request, when the catalog has nothing that fits.

  • generate_widget1 credit

    Equipment (pumps, tanks, hoppers, compressors, blowers, fans, mixers, boilers, heat exchangers) comes as 3 finished variants in a style: Flat, ISA-101, 3D / Convex, P&ID line art or Dark. Gauges, panels and indicators come as one widget.

  • get_widget_jobFree

    Follows a generation and tells the agent what to show you while it runs: about a minute for equipment, a couple of minutes for other widgets.

  • choose_variantFree

    Keeps the variant you picked (A, B or C) and returns the finished .svghmi with its WinCC type, properties and a preview.

  • refine_widget3 free, then 1 credit

    Changes a widget by an instruction such as "make the motor longer" or "labels in German". Also works on your own .svghmi (the first edit costs 1 credit).

  • restyle_widgetFree / 1 credit

    Redraws a generated equipment widget in another style or detail level, instantly. Rebuilding your own .svghmi costs 1 credit.

  • more_variantsFree

    Two more variants of a widget that came as a single result (gauges, panels, indicators), once per widget.

  • draw_widget1 credit

    Renders equipment the agent designed itself as simple parts into a widget with colour properties and moving parts: rotor, level, status, blink.

  • get_parts_spec_languageFree

    The reference of the parts language that draw_widget reads.

Icons for buttons and navigation

Thermometer, alarm bell, trend, settings, home and the like, drawn as one consistent set.

  • generate_icons1 credit per icon

    A set of 1 to 12 icons in one style, each a widget with IconColor, AccentColor, State and Plate properties, plus a preview sheet and a zip. Failed icons are not charged.

  • draw_icon1 credit

    Renders one icon the agent designed itself on a 48 × 48 grid.

  • get_icon_spec_languageFree

    The reference of the icon language that draw_icon reads.

Ready-made widgets from the catalog

The agent checks the catalog of 570+ widgets before drawing anything.

  • search_widgetsFree

    Finds pumps, valves, tanks, motors, conveyors, pipes, sensors, HVAC and P&ID symbols, with previews and whether each one is free or already yours.

  • list_widget_categoriesFree

    The catalog categories with the number of widgets in each.

  • get_widgetFree

    The file of a free widget or one from a set you bought, with its WinCC type, size and properties. For other widgets: the set, its price and a shop link.

  • list_owned_setsFree

    The widget sets you bought, and the other sets with their prices.

  • get_widget_setFree

    Every widget of a set you own, as one zip download.

  • check_widget_updatesFree

    Tells which widgets in your project have a newer catalog version.

Convert, edit and check SVGHMI

For SVG you already have, and for .svghmi files that need changes or misbehave in WinCC.

  • convert_svg_to_svghmi1 credit

    Turns an SVG from Illustrator, Inkscape, Figma or the agent into a WinCC Unified widget with properties you can bind in TIA Portal.

  • edit_svghmi_graphics1 credit per edit

    Changes the drawing: remove, recolour, move or scale shapes, insert shapes and text, flatten 3D shading, add a fill level.

  • edit_svghmi_bindings1 credit per edit

    Adds, renames or removes properties and binds colour, visibility, level, rotation or text to them.

  • inspect_svghmiFree

    Lists the properties, elements and bindings of a widget, optionally on a numbered picture.

  • validate_svghmiFree

    Finds the mistakes WinCC Unified rejects and explains what to fix.

  • fix_svghmiFree

    Repairs the common mistakes automatically and returns the fixed file.

  • render_svghmi_previewFree

    A PNG preview with the property values you choose, for example Level 0, 50 and 100.

  • request_uploadFree

    A one-time upload link for a file too large to pass in the chat, up to 2 MB.

Account

  • get_accountFree

    Your credit balance, the prices on this connection and a link to buy credits.

Prices

  • 1 credit per generation, all variants included; 1 credit per icon. A failed generation is refunded.
  • 1 credit per conversion and per edit that changes a file; the same edit repeated within 24 hours is free. Bindings other than fill and stroke colour, and the fill level, need purchased credits.
  • 10 free credits with a new account, valid for 7 days, for every tool here, the converter and the AI generator on the site.
  • Credits are one balance with the site, do not expire and are bought on the site: pricing.
  • Coilmind subscribers pay no svghmi.pro credits: generation comes from the subscription's AI allowance, and the other tools are free within a daily quota.

Connect

Claude and ChatGPT: sign in, no key

  1. Claude (claude.ai and Claude Desktop): find svghmi in Claude's connector directory, or go to Settings → Connectors → Add custom connector and paste https://mcp.svghmi.pro
  2. ChatGPT: add the same URL as a custom app or connector. This currently needs developer mode in the settings.
  3. Sign in to svghmi.pro and approve access. Check that the page says it will return you to the app you are connecting.
  4. Ask for a widget in the chat.

Menu names differ between versions and plans. You can see and disconnect connected apps in your profile under API & MCP.

Coilmind

Coilmind connects to this server with its own licence, so no svghmi.pro credits are spent. About Coilmind.

Claude Code, Codex, Cursor, VS Code and others

These connect with an API key. Claude Code (the sign in tab below) and Codex can also sign in through the browser instead.

1. Get an API key

Create one in your profile under API & MCP (login and a confirmed email required). The key is shown once, so copy it straight into your agent's config. Up to 5 active keys; revoke any of them at any time.

Log in to get an API key

2. Connect your agent

Pick your client and paste the snippet.

Terminal
claude mcp add --transport http svghmi https://mcp.svghmi.pro --header "Authorization: Bearer svh_YOUR_KEY"

Adds the server for the current project. Add --scope user to make it available in every project. Replace svh_YOUR_KEY with your key.

Terminal
claude mcp add --transport http svghmi https://mcp.svghmi.pro

No key: Claude Code opens the browser (or run /mcp in Claude Code to authenticate), you sign in to svghmi.pro and approve access. The page will say it returns you to an app on this computer — approve only if you just started it.

Terminal
codex mcp add svghmi --url https://mcp.svghmi.pro
codex mcp login svghmi

OpenAI Codex CLI. The login command opens the browser: sign in to svghmi.pro and approve access (the page will say it returns you to an app on this computer). To use an API key instead, set SVGHMI_API_KEY and add --bearer-token-env-var SVGHMI_API_KEY to the first command, skipping the login.

.cursor/mcp.json
{
  "mcpServers": {
    "svghmi": {
      "url": "https://mcp.svghmi.pro",
      "headers": {
        "Authorization": "Bearer svh_YOUR_KEY"
      }
    }
  }
}

Project-level config. For all projects use ~/.cursor/mcp.json instead. Replace svh_YOUR_KEY with your key.

.vscode/mcp.json
{
  "servers": {
    "svghmi": {
      "type": "http",
      "url": "https://mcp.svghmi.pro",
      "headers": {
        "Authorization": "Bearer svh_YOUR_KEY"
      }
    }
  }
}

Works with GitHub Copilot agent mode. Start the server from the MCP view or the file itself. Replace svh_YOUR_KEY with your key.

claude_desktop_config.json
{
  "mcpServers": {
    "svghmi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.svghmi.pro",
        "--header",
        "Authorization:${SVGHMI_AUTH}"
      ],
      "env": {
        "SVGHMI_AUTH": "Bearer svh_YOUR_KEY"
      }
    }
  }
}

Uses the mcp-remote bridge (needs Node.js). The header is passed through an environment variable so the space in it survives on Windows. Restart Claude Desktop after editing. Replace svh_YOUR_KEY with your key.

Any MCP client with Streamable HTTP
URL:    https://mcp.svghmi.pro
Header: Authorization: Bearer svh_YOUR_KEY

Transport: Streamable HTTP. Authentication: a Bearer token in the Authorization header. Replace svh_YOUR_KEY with your key.

3. Ask for a widget

For example: "Draw a centrifugal pump for WinCC Unified and save it into my project". The agent follows the session above and downloads the .svghmi file into your project.

Questions or a client that does not work? Contact us or see the FAQ.