Architecture guides and EventCatalog news
Practical guides to documenting distributed systems and the latest EventCatalog features.
Introducing EventCatalog Studio (v2): design what comes next, together
EventCatalog Studio (v2) brings live, collaborative canvases into your catalog. Plan changes with the services, messages and domains you already document, comment and review them with your team, and invite AI agents onto the same canvas through MCP.
See who owns every step of a flow
In EventCatalog v5 you can group any flow by domain, system or team, as boxes or swimlanes, without changing your flows. Plus a new step-by-step walkthrough, channel steps, and flows that tell you when something is wrong.
Your architecture diagrams, inside your agent
EventCatalog's MCP server can now show your real architecture diagrams and schemas inside AI tools that support MCP Apps, including Claude, ChatGPT and VS Code. Switch levels, search, and ask questions about any node without leaving the conversation.
One diagram, three levels of detail
In EventCatalog v5 every domain and system has a single diagram with three levels. Start with the domains and systems that talk to each other, then zoom into services, data stores, messages and channels.
EventCatalog 4.12: schemas your consumers can actually use
EventCatalog 4.12 turns every schema into a page consumers can work from, with written examples, producers and consumers, flows, and version comparison. It also removes the .eventcatalog-core folder from your project.
Whats new in EventCatalog - August 2026
August brought EventCatalog Federation v2, the new Architecture Graph, custom resource sidebars, stronger linting, channel maps, and plenty of fixes across the project.
Introducing EventCatalog Federation v2
Federation is EventCatalog at scale. Teams own their docs, services, and ADRs, and federate them into a central catalog people and AI agents can use.
Schema registry vs Architecture Catalog
A schema registry stores the contract. An architecture catalog shows how that contract fits the system. You often want both.
Whats new in EventCatalog - July 2026
July was the month EventCatalog v4 landed. Systems and context maps, custom pages and API routes, message trigger paths, scoped MCP servers, custom properties, and a lot of polish underneath.
Scope your MCP server to a domain or system
Scope EventCatalog's MCP server to a domain or system so AI tools work with the right services, language, and decisions without loading the whole catalog.
Add custom dashboards, tools, and APIs to EventCatalog
EventCatalog now supports custom pages and API routes, so teams can build their own catalog tools, dashboards, workflows, and API-backed pages.