@endiagram/mcp
MCP server for EN Diagram — deterministic structural analysis powered by graph theory. Every result is backed by a named mathematical theorem. No AI inside the computation.
Installation
Run directly:
Or install globally:
Connect
Claude Code
Claude Desktop
Add to your claude_desktop_config.json:
Cursor
Add to .cursor/mcp.json in your project root:
HTTP (zero install)
Any MCP client that supports HTTP transport:
Smithery
Environment Variables
Tools
Six questions about any system, plus a render tool. Every tool takes source (EN code or .en/.txt file path). Tool names are shorthand, not specs — read each description before calling; compose and equivalent are mode-based, not general analyzers.
EN Syntax
One statement per line:
Shared names between yields and needs create connections automatically:
Modeling
Same name = same thing. Put all required inputs in one needs: list (AND). Give two actions the same yield-name to offer alternatives (OR). Sequence = one action consuming another's yield. Re-yield stateful resources to keep them persistent; one-shot data stays consumed. Model at the real atomic granularity — split only when the pieces could be accessed independently.
Learn more at endiagram.com.
Telemetry
@endiagram/mcp generates a random install ID on first run, stored at
~/.endiagram/install-id (mode 0600). It is sent with every request as
the X-Endiagram-Install-Id HTTP header so we can correlate requests
from the same install for debugging issues that the per-IP signal alone
cannot track (mobile networks, VPNs, CGNAT all collapse or churn IPs).
No source code, no file paths, no environment variables, and no PII
are sent. The install ID is a random opaque UUIDv4 generated locally.
A first-run notice prints to stderr (never stdout — stdout is the
MCP JSON-RPC channel) with the disclosure and the opt-out instructions.
The notice fires once per install and never again.
Opting out
Any of these three methods disables the install ID:
- Set
ENDIAGRAM_TELEMETRY=off as an environment variable (also
accepts 0, false, no).
- Create a file at
~/.endiagram/telemetry containing the word off.
- Delete
~/.endiagram/install-id. (A new one is generated on next
run unless option 1 or 2 is also set.)
When any of these is active, the X-Endiagram-Install-Id header is not
sent at all — the server falls back to its per-IP HMAC cid for
correlation, which works fine for short-term per-session tracing.
Full privacy policy: endiagram.com/privacy
License
MIT