Repolode
Submit
event-catalog

event-catalog/eventcatalog

A documentation tool for software architecture that catalogs domains, services, events, messages and schemas for teams and AI agents.

View on GitHubWebsite
Stars
2,946
Forks
281
Open issues
79
Last commit
yesterday

What is it?

EventCatalog is a documentation tool for software architecture. It lets teams record their domains, services, events, commands, messages and schemas as structured, versioned resources, and renders them into a browsable website with a visualiser that shows how the pieces connect.

The catalog can be populated by hand or generated from existing specifications such as AsyncAPI, OpenAPI, Protobuf, JSON Schema and Avro, as well as from event platforms like Kafka, Confluent and AWS EventBridge. Teams can also attach architecture decision records, runbooks and custom MDX pages to domains and services, and describe end-to-end business flows that reference existing messages and services.

The project includes a built-in AI chat and an MCP server so people and tools can query the catalog in natural language. It is distributed as the @eventcatalog/core application, a Node.js SDK, a scaffolding CLI and a standalone visualiser component. The code is source-available under the Business Source License 1.1, with ecosystem packages under MIT.

Key features

  • 01Documents domains, services, events, commands and messages as versioned resources.
  • 02Imports and generates catalog content from AsyncAPI, OpenAPI, Protobuf, JSON Schema, Avro and event platforms such as Kafka and AWS EventBridge.
  • 03Provides a searchable schema explorer and field-level search across the catalog.
  • 04Includes an architecture visualiser and business flow documentation.
  • 05Offers an AI chat and MCP server for querying the catalog.

Use cases

  • Documenting an event-driven or microservices architecture so teams can find which services publish and consume each message.
  • Keeping schema definitions and their usages discoverable across many services.
  • Giving AI assistants structured access to an architecture catalog through MCP.
  • Publishing architecture decision records and runbooks alongside the services they describe.

Quick start

  1. 1

    Scaffold a new catalog with the create tool

    npx @eventcatalog/create-eventcatalog@latest my-catalog
  2. 2

    Open the catalog in your browser at localhost port 3000

Things to know

  • The license is source-available under BSL 1.1 rather than an OSI-approved open-source license.
  • The README does not state a clear OSI license identifier in the metadata (license is NOASSERTION).

In collections

Microservice frameworks & service infrastructure

Topics

#documentation#architecture#event-driven-architecture#asyncapi#microservices#domain-driven-design#distributed-systems#ai#ddd#event-catalog

FAQ

What is eventcatalog?
A documentation tool for software architecture that catalogs domains, services, events, messages and schemas for teams and AI agents. EventCatalog is a documentation tool for software architecture. It lets teams record their domains, services, events, commands, messages and schemas as structured, versioned resources, and renders them into a browsable website with a visualiser that shows how the pieces connect.
Is eventcatalog free to use? What license does it have?
eventcatalog is open source under the Other license. Check the license terms before using it in commercial products.
Is eventcatalog still maintained?
Actively maintained. The last commit to eventcatalog was on Oct 23, 2026.
What can I use eventcatalog for?
Documenting an event-driven or microservices architecture so teams can find which services publish and consume each message. Keeping schema definitions and their usages discoverable across many services. Giving AI assistants structured access to an architecture catalog through MCP. Publishing architecture decision records and runbooks alongside the services they describe.
How do I install eventcatalog?
Scaffold a new catalog with the create tool: npx @eventcatalog/create-eventcatalog@latest my-catalog Open the catalog in your browser at localhost port 3000
Where can I get eventcatalog?
The source code and installation instructions are on GitHub: https://github.com/event-catalog/eventcatalog

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects