MCP Server for AI Agents

Let Claude Code, Cursor and other AI agents build WinCC Unified widgets with the same converter and checks that run on svghmi.pro.

What it does

AI agents that write WinCC Unified widgets by hand tend to get the SVGHMI format subtly wrong — headers, property declarations and binding expressions that WinCC then rejects. The svghmi.pro MCP server gives your agent the real tools instead. It works with your svghmi.pro account and spends the same credits as the site.

convert_svg_to_svghmi

1 credit per file

Turns a plain SVG (from Illustrator, Inkscape, Figma or written by the agent) into a WinCC Unified dynamic widget: cleans the SVG and binds colours and other properties that you can edit in TIA Portal. Returns the .svghmi file and a link to open it on the site.

validate_svghmi

Free

Checks an existing .svghmi file for the mistakes WinCC Unified rejects — headers, property declarations and binding expressions — and explains what to fix.

render_svghmi_preview

Free

Renders a widget with the property values you choose, so the agent can check what it looks like before you import it.

search_widgets

Free

Searches the svghmi.pro widget catalog — valves, pumps, gauges, buttons and other ready-made WinCC Unified widgets.

get_account

Free

Shows your credit balance and plan, and gives the agent a link to buy credits when they run out.

Pricing

Converting a file costs 1 credit — the same as downloading a converted widget on the site. Validation, previews, catalog search and account checks are free. Credits come from the same balance you use on svghmi.pro, do not expire, and are bought on the site: see pricing.

If a conversion fails, the credit is returned. Calls are rate limited per key to protect the service.

1. Get an API key

Keys are personal and tied to your account. Create one in your profile under API & MCP (login required; your email must be confirmed). The key is shown once — copy it straight into your agent's config. You can have up to 5 active keys and revoke any of them at any time.

Log in to get an API key

2. Connect your agent

Server URL: https://mcp.svghmi.pro

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.

.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 horizontal pump symbol as SVG and convert it to an SVGHMI widget with the body colour as a property". The agent calls convert_svg_to_svghmi, saves the .svghmi into your project, and can check it with render_svghmi_preview. Import the file into WinCC Unified as a custom widget.

ChatGPT and claude.ai

Connectors for ChatGPT and claude.ai need OAuth sign-in instead of an API key. Support for them is coming later. Until then, use any client above that accepts a custom header.

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