Make your AI coding assistant create perfect diagram visualizations
yFiles AI Tools

AI assistants are great — but without the right context they often cannot help with the creation of interactive, high-quality diagrams. The yFiles AI tools fix this by giving your agent up-to-date, accurate knowledge about the yFiles for HTML SDK. It uses the open-source Model Context Protocol (MCP) and Skills to provide your AI agent efficient tools to use the yFiles API, documentation and demo code.

With the tools the AI assistant has deep knowledge of yFiles concepts, patterns, and common development scenarios, making it an invaluable companion for both beginners and experienced developers.

Use this prompt and paste it into your agent to get started!

Fetch https://yfiles.com/agent-start.md and follow its instructions

Watch the webinar recording on YouTube

Benefits of using the yFiles AI Tools

  • Accurate and up-to-date information about the yFiles for HTML SDK
  • Scaffolding new diagramming applications
  • Code suggestions that follow best practices
  • Easing the learning curve of the yFiles SDK
  • Compatible with AI agents via the Model Context Protocol (MCP) and Skills
Receive guidance from our knowledgeable support hub.
Questions about using the yFiles AI Tools?

Get in touch to discuss your specific challenges with our diagramming experts. We're here to provide the guidance you need.

Works with your favorite AI agent

We have successfully tested the AI tools with the following AI agents. Thanks to the standards, it should work with any agent that supports MCP servers and Skills.

Because the yFiles AI tools implement the open Model Context Protocol (MCP), they should work with any agent, IDE, CLI, or harness that supports MCP servers and Skills. This includes well-known tools such as Pi, Qwen Code, Open WebUI, Claude Desktop, and many more.
Using the free yFiles AI tools requires connecting them to an AI agent. Some agents are free, while others may need a paid subscription depending on the provider you choose. Performance and capabilities can also vary depending on the agent and the LLM model it uses.

In our experience, coding-focused LLMs like Claude Sonnet work best for big scaffolding tasks where a full project setup is needed. GPT-5 has also been a solid choice for complex scenarios, while other models often shine when it comes to more specific, targeted prompts or questions.

With the help of the tools, even smaller or local models can work with the yFiles library and create impressive results quickly without doing hundreds of round trips and guessing.

Use cases

With the yFiles AI tools, your AI assistant doesn't just explain how things work — it can directly implement features, scaffold projects, and answer API questions with real code. This lowers the learning curve for newcomers and speeds up everyday development for experienced users alike.

Getting started as a yFiles newcomer

yFiles for HTML provides outstanding documentation and more than 300 demos that illustrate almost every feature and scenario. These are invaluable learning and reference resources.

For newcomers, however, combining multiple concepts from the documentation into a working first project can feel overwhelming. The yFiles MCP server and Skills lower this barrier by letting the AI agent set up a functioning project directly, so you can see results right away and learn by example. Not only can you do one-shot prompting, but use a sequence of prompts where each one adds and combines more features.

Example prompt

Create a React project with a basic yFiles component and editing capabilities.

Scaffolding new yFiles applications

When you're ready to start fresh or try out new ideas, the yFiles AI tools can scaffold a project for you. They help with generating the boilerplate, initializing the GraphComponent, wiring up interactions, and embedding common patterns—saving time on repetitive setup tasks so you can focus on your actual goals.

Example prompts for scaffolding

Create a vanilla TypeScript project with yFiles and Vite.
This workspace contains graph data for a bakery supply chain. Create a yFiles project with Vite that visualizes this data as a graph.
Cline Prompt in VS Code: Build a yFiles + Vite Graph from Bakery Data
Instruction to set up a Vite project and color nodes by production stage
Cline in VS Code: Stage Color Mapping and Live Preview
Coding agent runs the Vite dev server and previews the bakery supply chain graph
Result: Stage‑Colored Supply Chain Graph (Browser Preview)
Live preview showing nodes colored by production stage and selectable editing handles

Accelerating development in your existing projects

Once your application is up and running, the real work begins: extending features, customizing styles, refining layouts, and improving performance. With its rich API, yFiles gives you full control over all of these aspects — but finding the right combination of classes, methods, and demos can sometimes be time-consuming.

The yFiles MCP server and Skills, when paired with your AI agent, help you move faster by implementing concrete code changes directly in your project context. Instead of spending time searching for the right demo or piecing things together manually, you can simply describe what you want to achieve, and your AI assistant generates the necessary code using the official yFiles APIs and best practices.

This dramatically speeds up iterative development, helps you avoid common mistakes, and shortens the time from idea to working feature.

Example prompts for existing projects

Create a custom node style to show all relevant information in my nodes' data tags.
Add a heatmap to the graph visualization, using the "load" value of the nodes' data tags.
Please group my graph items by their category property and make it such that I can collapse/expand these groups interactively.
When a node is hovered over, that node, all directly connected nodes, and the connecting edges should be highlighted.
Agent Prompt in VS Code: Update yFiles Node and Edge Styles
Cline coding agent in Visual Studio Code executing a task‑focused prompt
Agent Prompt in VS Code: Template LitNodeStyle and Improve EdgeStyle
Cline coding agent in Visual Studio Code responding to a style‑update request for a yFiles graph
Final Result: Bakery Supply Chain with Templated Nodes and Typed Edges
Preview of the updated yFiles visualization after the agent's changes

Answering yFiles API questions

The yFiles for HTML SDK is vast and powerful, offering hundreds of classes, interfaces, and specialized layout and visualization features. Even experienced developers can't (and shouldn't) memorize the entire API surface. Traditionally, when a question arises, you'd search through the documentation or look for the right demo — both excellent resources, but sometimes too slow when you're in the middle of coding.

With the yFiles MCP server, your AI agent can directly answer API questions and implement code solutions immediately in your development environment. Instead of switching contexts to look up a class or an event, you simply ask: "How do I attach a listener for label clicks?" or "Which layout should I use for layered data?" — and your assistant can show you, explain it, and inject working code into your project.

This turns your AI agent into an interactive API companion: one that's always up-to-date, understands the entire yFiles SDK, and lowers the learning curve by translating abstract concepts into concrete, ready-to-use code.

How to get started

The yFiles AI tools are powered by the yFiles Dev Suite a development hub for working with yFiles. It's a CLI tool, meant to be used by expert developers and AI agents alike, with a lot of different functionality built in:

  • Sign up and log in to the yWorks Customer and Evaluation Center
  • Request and download a yFiles evaluation version package
  • Launch a browser UI to explore the yFiles demos and documentation, locally
  • Install instructions for local coding agents to work with yFiles
  • Install agent Skills for efficiently working with the APIs
  • Serve as an MCP server for AIs to connect to and explore the API
  • Search for a matching demo and scaffold it into a local directory

To make an AI agent aware of the yFiles AI tools, point it to the yFiles dev suite CLI's integrated help.

Launch 'npx --yes yfiles-dev-suite@latest --help' and help me install the Skills and MCP Server.

Alternatively, ask it to go to our agent welcome page and follow the instructions.

Fetch https://yfiles.com/agent-start.md and follow its instructions

Depending on the AI agent, IDE, or development harness you use, the configuration for MCP servers and Skills may vary. If the agent cannot help, always consult your harness' documentation for the expected configuration.

Using the AI tools requires that you are logged in to the yWorks Customer/Evaluation Center via the yFiles Dev Suite with an account that has a valid yFiles for HTML package (evaluation or licensed). With the above prompt, an agent can help you through this process.

Set up for VS Code & Cline

A walkthrough for connecting yFiles MCP Server to VS Code with the Cline coding agent for yFiles-enabled AI development. Watch how to configure your environment and start generating yFiles code using natural language prompts.

Go to YouTube video
Video Thumbnail
load from YouTube

Set up for JetBrains & Junie

Step-by-step instructions for integrating the yFiles MCP Server into JetBrains IDEs using the Junie agent for interactive yFiles coding sessions. See how Junie leverages the MCP server to provide context-aware suggestions right inside your IDE.

Go to YouTube video
Video Thumbnail
load from YouTube

Frequently Asked Questions

Which AI agents does the yFiles mcp-server work with?

The yFiles mcp-server has been tested with popular AI agents such as Claude Code, Codex, OpenCode, Cline, Cursor, Copilot, Gemini CLI, Windsurf Editor, Warp, goose, Roo Code, JetBrains Junie, and JetBrains AI.

Where can I get the yFiles mcp-server?

The yFiles mcp-server is included in the yFiles Dev Suite. It can be installed and connected to your preferred AI agent that supports MCP.

How much does the yFiles mcp-server cost?

The yFiles mcp-server is free to use with a valid yFiles package as part of the yfiles-dev-suite. You will need to connect it to an external AI agent, which may require a separate paid subscription depending on the provider.

Is there a CLI to use for agents?

The yFiles dev suite provides a CLI interface for agents to manage your evaluation and the various AI tools likes skills and the mcp server.

Are there agent skills available for yFiles?

The yFiles dev suite provides an mcp-server and agent skills for working with yFiles for HTML.

How accurate and fast is the yFiles mcp-server when used with an AI agent?

The performance and quality of the yFiles mcp-server strongly depend on the AI agent and the underlying large language model (LLM) you are using. While the mcp-server always provides structured, up‑to‑date access to the yFiles SDK, the quality of the generated code and responses varies with the capabilities of the connected AI agent and model version.

How does the yFiles mcp-server help beginners?

Beginners benefit from lower entry barriers: the AI assistant can scaffold a functioning yFiles project instantly, letting new users learn by example instead of starting from scratch.

How does the yFiles mcp-server help with scaffolding new projects?

The yFiles mcp-server enables your AI agent to generate boilerplate code, initialize graph components, and add essential interactions so that new projects are up and running quickly.

How does the yFiles mcp-server support existing projects?

For ongoing applications, the AI agent can add new features, adjust layouts, and other concepts directly using yFiles APIs guided by the yFiles mcp-server.

Recap

yFiles AI Tools

The yFiles AI Tools equip your AI coding assistant with up-to-date and reliable knowledge of the yFiles for HTML SDK, enabling it to deliver accurate code suggestions and use cases. By leveraging the Model Context Protocol (MCP) and Skills, it integrates seamlessly with popular AI agents to streamline tasks such as project scaffolding, feature implementation, API question answering, and many other use cases. The getting started guide explains how to connect your agent with the tools for a smooth setup. These capabilities help both newcomers and experts efficiently build, customize, and maintain yFiles-based applications.

Related content

Got questions about
the yFiles AI tools?

Nicolas Brich

Nicolas Brich

Senior Software Developer

Email: hello@yworks.com
Phone: +49 7071 9709050

Get in touch

11 reasons why web developers choose yFiles, the superior diagramming SDK

Get started right away! Test yFiles for HTML free of charge.

Download yFiles now!

Choose your next steps

Get connected

Connect with our Customer Success Team regarding your ideas or projects.

Connect with the real graph drawing experts.

Dive deep

Get more detailed information about specific yFiles topics.

Download yFiles

Try yFiles free of charge.

Download the yFiles trial version.