PlugWiki
LikeC4 MCP logo

LikeC4 MCP Server: Setup for Claude, Cursor and Other Apps

OfficialLocal
Getnpm@likec4/mcplikec4/likec4

Lets Claude, Cursor and other assistants read your LikeC4 architecture model, trace dependencies and draw diagrams of your system.

This is the LikeC4 project's own MCP server. It lets an assistant search and read the architecture model in your workspace, follow dependencies between parts of your system, and draw a view in the chat.

It runs on your computer and reads the LikeC4 files in your workspace folder. It uses the current folder unless you set a workspace. Almost every tool only reads. The one exception saves a layout snapshot.

Good for

  • Architects who keep a system model in LikeC4 and want to query it by chat
  • Developers who need to know what depends on a service before changing it
  • Teams who want an assistant to draft or preview new diagram views

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install LikeC4 MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the LikeC4 MCP server to Claude Code. Run this command:
    
    claude mcp add likec4 -- npx -y @likec4/mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Built from the package data we hold. Not yet tested by us.

Tools

  • Lists the LikeC4 projects in your workspace

    Returns the architecture projects found in your workspace folder.

    Try: “Which LikeC4 projects do I have?”

    Read · list-projects

  • Summarizes one project

    Returns a project's elements, deployment nodes and views in one summary, so the assistant learns your architecture.

    Try: “Summarize the architecture project.”

    Read · read-project-summary

  • Finds elements by name, title or description

    Searches your architecture model and ranks the matches. You can narrow it by kind, shape, tag or metadata.

    Try: “Find the elements that mention payments.”

    Read · search-element

  • Shows everything about one element

    Returns an element with its relationships, the views it appears in, where it is deployed and where it is defined in your files.

    Try: “Show me the details of the billing service.”

    Read · read-element

  • Shows a deployment node or deployed instance

    Returns details about where part of your system is deployed.

    Try: “Where is the billing service deployed?”

    Read · read-deployment

  • Shows the contents of one diagram view

    Returns the boxes and arrows of a view and where it is defined in your files.

    Try: “What does the context view contain?”

    Read · read-view

  • Draws a view as a diagram in the chat

    Shows a diagram you can pan and zoom, in apps that support MCP Apps.

    Try: “Show me the system context view.”

    Read · render-view

  • Previews a new view before you save it

    Draws a view from text you write, using your real elements, without saving anything.

    Try: “Preview a view with only the API and the database.”

    Read · preview-view

  • Finds how two elements are connected

    Returns the links between two elements, direct and indirect.

    Try: “How is the web app connected to the database?”

    Read · find-relationships

  • Finds every chain of links between two elements

    Lists the routes from one element to another through your model, optionally including implied links.

    Try: “Show all paths from the web app to the database.”

    Read · find-relationship-paths

  • Looks up parents, children, siblings and neighbours

    Returns where an element sits in the hierarchy and what links into or out of it.

    Try: “What are the children of the backend system?”

    Read · query-graph

  • Lists everything an element depends on

    Follows links upstream and returns every producer an element depends on.

    Try: “What does the billing service depend on?”

    Read · query-incomers-graph

Read from the source code

Permissions

medium risk · 3 things to watch

Medium risk

Nearly all its tools only read your model, but one applies a layout and saves a snapshot to disk. Point it at the workspace you mean to use and review any saved change.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • HTTP mode listens on every network interface

    With --http the server binds 0.0.0.0 on port 33335 (default), has no sign-in, and allows requests from any origin. Anyone who can reach the port can read your model and trigger the layout tool. The default stdio mode opens no port. github.com

  • One tool writes a layout snapshot

    The semantic layout tool applies the layout your assistant suggests and saves a snapshot. Review the result in version control. github.com

  • It reads your whole workspace

    It watches the workspace folder for changes by default. Start it in the folder with your model. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Sign-in and keysNo sign-in or key.

Questions

Is the LikeC4 MCP server official?

Yes. It is published by the LikeC4 project from its own repository as @likec4/mcp.

Does it need an API key?

No. It runs locally and reads the LikeC4 files in your workspace.

How do I point it at my project?

Set the LIKEC4_WORKSPACE variable to your workspace folder, or start the server from that folder. The README example sets it to the editor's workspace folder.

Is it local or hosted?

Local. It starts over stdio by default and opens no port. The --http flag starts a streamable HTTP server on port 33335 that listens on all network interfaces (0.0.0.0) with no sign-in, so use it only on a trusted network.

Can it change my files?

One tool can. The semantic layout tool applies a layout and saves a snapshot. The other tools in the README read your model.

Does it generate LeanIX or Draw.io files?

No. The README says the tools expose the resolved model and do not generate LeanIX bridge files or Draw.io exports.

Information

updated Nov 2, 2026

Publisher
Official
Package
@likec4/mcp
Registry
npm
Transport
stdio
Auth
None
Version
1.60.0
License
MIT
Last commit
Oct 31, 2026
Open issues
149

WebsiteGitHubnpmChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 4
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.