MCP SERVERWrite and validate Ilograph architecture diagrams with the live spec, curated examples and the icon catalogue on hand.
LABSCO SUMMARY
An agent writing Ilograph without this reaches for remembered syntax and iterates until the file opens. Here it can read the authoritative property table first and then get told exactly which line failed and what to change. The project is unofficial and reads public Ilograph docs — check generated diagrams against the vendor's own documentation before you rely on them.
A documentation-and-validation companion for Ilograph diagrams. It fetches the official specification and documentation sections from Ilograph's own sources, checks a diagram in two stages — YAML syntax, then the Ilograph schema — and searches the live icon catalogue. It is a community project, not affiliated with Ilograph LLC.
fetch_documentation_tool, list_documentation_sectionsfetch_spec_toolvalidate_diagram_tool, get_validation_helplist_examples, fetch_examplesearch_icons_tool, list_icon_providers_toolcheck_documentation_health, check_spec_healthDocker installed and running; the client launches ghcr.io/quincymillerdev/ilograph-mcp-server:latest with docker run -i --rm. No account and no key. Python 3.11+ if you build it yourself.
One command — docker run -i --rm ghcr.io/quincymillerdev/ilograph-mcp-server:latest
USE CASES
Pull the resources and perspectives documentation, read the property table from the spec, then write the file with the right property names the first time.
Run validation and get back separate YAML and schema verdicts, per-error locations and suggested fixes, rather than a single failure message.
Search the live icon catalogue by meaning and filter to one provider, so the AWS or Azure services in your diagram get the icons that exist rather than guessed paths.
List the bundled examples by complexity and fetch one — it comes back with the diagram, the patterns it demonstrates and the context for why it is built that way.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
check_documentation_healthChecks the health and connectivity of the documentation fetching service.
This tool performs connectivity tests and returns status information about the documentation fetching capabilities, including cache statistics.
Returns: str: Health status report with service connectivity and cache information
check_spec_healthChecks the health and connectivity of the specification fetching service.
This tool performs connectivity tests specifically for the specification endpoint and returns status information about spec fetching capabilities.
Returns: str: Health status report with spec service connectivity and cache information
fetch_documentation_toolFetches and formats narrative documentation from Ilograph website.
This tool provides detailed explanations, tutorials, and examples for learning Ilograph concepts and implementation patterns. Content is fetched from the official Ilograph documentation site and converted to clean markdown format.
fetch_exampleRetrieves a static example diagram with its content and learning context.
fetch_spec_toolFetches the official Ilograph specification from https://www.ilograph.com/docs/spec/
This tool provides the authoritative reference for all Ilograph properties, types, and requirements in a structured table format - perfect for validation and quick lookups.
Returns: str: Complete specification in markdown format with:
get_validation_helpProvides comprehensive help for Ilograph diagram validation.
Returns guidance on common validation issues, proper syntax, and best practices for creating valid Ilograph diagrams.
Returns: str: Detailed validation help in markdown format
list_documentation_sectionsLists all available Ilograph documentation sections with descriptions.
This tool provides an overview of all available documentation sections that can be fetched using the fetch_documentation_tool.
Returns: str: Formatted list of available documentation sections with descriptions
list_examplesLists available Ilograph example diagrams, optionally filtering by category.
list_icon_providers_toolLists all available icon providers and their categories.
This tool provides an overview of the icon catalog structure, showing available providers and their service categories.
Returns: dict: Provider information with categories and icon counts
search_icons_toolSearches the current icon catalog with semantic matching.
This tool fetches the live icon catalog from Ilograph and provides intelligent search capabilities to help find appropriate icons for diagram resources.
validate_diagram_toolValidates Ilograph YAML syntax and structure.
This tool performs comprehensive validation of Ilograph diagrams:
BEFORE YOU INSTALL
11 tools when we connected.
All 5 documented setups run the server on your machine.
CONTEXT COST
Rated by the size of the 11 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
docker run -i --rm ghcr.io/quincymillerdev/ilograph-mcp-server:latest{
"servers": {
"ilograph": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/quincymillerdev/ilograph-mcp-server:latest"
]
}
}
}{
"mcpServers": {
"ilograph": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/quincymillerdev/ilograph-mcp-server:latest"
]
}
}
}MCP servers
h0rv
peng-shawn
bnomei
Narasimhaponnada