Overview
EventCatalog - MCP Server is a tool that allows users to gain insights from their EventCatalog directly through various MCP Clients, enabling interaction with event-driven architectures.
To use the MCP Server, you need to enable the LLMS.txt feature in your EventCatalog instance and configure your MCP clients (like Claude or Cursor) to connect to the server.
- Connect to any MCP Client (e.g., Claude, Cursor, Windsurf) - Run the MCP server locally with a single command - Query your EventCatalog for domains, services, messages, and schemas - Get real-time answers about your architecture
- Developers can integrate the MCP server with supported IDEs to streamline their workflow.
- Stakeholders can ask questions about the architecture using familiar tools.
- It can be used to document and visualize event-driven architectures effectively.
Add to your AI client
Use these steps to connect 📖 EventCatalog - MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-server-event-catalog": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-event-catalog"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-server-event-catalog": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-event-catalog"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-server-event-catalog": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-event-catalog"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-server-event-catalog": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-event-catalog"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server-event-catalog": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-event-catalog"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-server-event-catalog": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-event-catalog"
]
}
}
}FAQ
**What is the purpose of the MCP Server?**
The MCP Server enhances the EventCatalog by allowing users to query their architecture through various tools.
**Is there a cost associated with using the MCP Server?**
The MCP Server is part of the EventCatalog Pro Edition, which may have associated costs.
**Can I use the MCP Server with any IDE?**
The MCP Server is designed to work with MCP-supported IDEs, but integration with other tools is possible using the LLMS.txt standard.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3153,"uuid":"b2de0f75-4784-40f1-844d-3bb9d3b1fffe","name":"mcp-server","title":"📖 EventCatalog - MCP Server","description":"MCP server for EventCatalog","avatar_url":"https://avatars.githubusercontent.com/u/171661582?v=4","created_at":"$D2025-03-18T03:04:13.779Z","updated_at":"$D2025-03-18T16:08:26.355Z","status":"created","author_name":"event-catalog","author_avatar_url":"https://avatars.githubusercontent.com/u/171661582?v=4","tags":"documentation,mcp,architecture,mcp-server","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/event-catalog/mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/event-catalog/mcp-server/raw/main/images/mcp.png","type":null,"metadata":"{\"star\":\"13\",\"license\":\"View license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-06-02 13:33:52\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]