πŸ“– EventCatalog MCP Server

MCP server for EventCatalog

Local serverstdioGo

What is the πŸ“– EventCatalog MCP server?

Most team communication work still happens through a UI a human drives. πŸ“– EventCatalog MCP server moves it into the conversation instead. MCP server for EventCatalog.

The short version

  • What events do we have in our architecture?
  • Tell me more about the {service} service
  • I want to create a new feature that will send emails when a user signs up, what events do we have in our architecture that are related to user signups?
  • Get me the schema for the event UserCreated in EventCatalog
  • Here is a new version of the UserCreated schema, what downstream consumers will be affected by this change?

The tools it exposes

The server publishes 10 tools. What each one is for:

  • find_resources β€” Find resources that are available in EventCatalog including services, domains, events, commands, queries, flows, entities, channels, teams, users
  • find_resource β€” Get more information about a service, domain, event, command, query, flow, entity, or channel in EventCatalog using its id and version
  • find_owners β€” Find owners (teams or users) for a domain, service, message, event, command, query, flow, or entity in EventCatalog
  • find_producers_and_consumers β€” Get the producers (sends) and consumers (receives) for services in EventCatalog
  • get_schema β€” Returns the schema for a service (e.g., OpenAPI, AsyncAPI, GraphQL), event, command, or query in EventCatalog
  • review_schema_changes β€” Reviews schema changes for breaking changes and suggests fixes
  • explain_ubiquitous_language_terms β€” Explain ubiquitous language terms for a given domain
  • create_flow β€” Create a new flow in EventCatalog given a description of the business workflow
  • eventstorm_to_eventcatalog β€” Turn a photo of an EventStorm session into an EventCatalog
  • create_eventcatalog β€” Create a new EventCatalog project from scratch

What it needs from you

Configuration is passed through the environment: LICENSE_KEY. Treat anything key-shaped as a real credential β€” scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Getting it running

Installation goes through your MCP client rather than a global install: point it at @smithery/cli on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

How it compares

Plenty of team communication servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. πŸ“– EventCatalog's toolset β€” find_resources, find_resource, find_owners and 7 more β€” is a fair guide to whether it matches your workflow. It is maintained by event-catalog; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against πŸ“– EventCatalog's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 10 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch πŸ“– EventCatalog.
  • Missing credentials fail quietly in some clients β€” if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
find_resourcesFind resources that are available in EventCatalog including services, domains, events, commands, queries, flows, entities, channels, teams, users, and docs
find_resourceGet more information about a service, domain, event, command, query, flow, entity, or channel in EventCatalog using its id and version
find_ownersFind owners (teams or users) for a domain, service, message, event, command, query, flow, or entity in EventCatalog
find_producers_and_consumersGet the producers (sends) and consumers (receives) for services in EventCatalog
get_schemaReturns the schema for a service (e.g., OpenAPI, AsyncAPI, GraphQL), event, command, or query in EventCatalog
review_schema_changesReviews schema changes for breaking changes and suggests fixes
explain_ubiquitous_language_termsExplain ubiquitous language terms for a given domain
create_flowCreate a new flow in EventCatalog given a description of the business workflow
eventstorm_to_eventcatalogTurn a photo of an EventStorm session into an EventCatalog
create_eventcatalogCreate a new EventCatalog project from scratch

How to install the πŸ“– EventCatalog MCP server

{
  "mcpServers": {
    "eventcatalog": {
      "command": "npx",
      "args": ["-y", "tsx /PATH_TO_YOUR_REPO/src/index.ts",  "https://demo.eventcatalog.dev", "ABCD-1234-5678-9012-3456-7890"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
LICENSE_KEYCredential the server authenticates with.Yes

Example prompts to try

  • β€œUse πŸ“– EventCatalog to find resources.”
  • β€œUse πŸ“– EventCatalog to find resource.”
  • β€œUse πŸ“– EventCatalog to find owners.”

Frequently asked questions

Yes, usage of this feature requires an EventCatalog Scale plan license key. A 14‑day trial key is available from EventCatalog Cloud.