@eventcatalog/core 4.2.6 → 4.3.0

package/dist/analytics/analytics.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(analytics_exports);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "4.2.6";
+var version = "4.3.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-NZUMNTJK.js";
-import "../chunk-XTSY2LTR.js";
+} from "../chunk-ZLUUUTWP.js";
+import "../chunk-GZOFTODZ.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

@@ -140,7 +140,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "4.2.6";
+var version = "4.3.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-OBA7TFHM.js";
+} from "../chunk-32ZHIOUO.js";
+import "../chunk-ZLUUUTWP.js";
 import "../chunk-K2XIENVT.js";
-import "../chunk-NZUMNTJK.js";
-import "../chunk-XTSY2LTR.js";
+import "../chunk-GZOFTODZ.js";
 import "../chunk-6QENHZZP.js";
 export {
   log_build_default as default

package/dist/{chunk-OBA7TFHM.js → chunk-32ZHIOUO.js}

@@ -1,10 +1,10 @@
+import {
+  raiseEvent
+} from "./chunk-ZLUUUTWP.js";
 import {
   countResources,
   serializeCounts
 } from "./chunk-K2XIENVT.js";
-import {
-  raiseEvent
-} from "./chunk-NZUMNTJK.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/{chunk-XTSY2LTR.js → chunk-GZOFTODZ.js}

@@ -1,5 +1,5 @@
 // package.json
-var version = "4.2.6";
+var version = "4.3.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/{chunk-DEGSBGEF.js → chunk-RQCRNCF6.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-XTSY2LTR.js";
+} from "./chunk-GZOFTODZ.js";
 
 // src/utils/cli-logger.ts
 import pc from "picocolors";

package/dist/{chunk-OZNVNRI7.js → chunk-TE4QQSPT.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-DEGSBGEF.js";
+} from "./chunk-RQCRNCF6.js";
 import {
   cleanup,
   getEventCatalogConfigFile

package/dist/{chunk-NZUMNTJK.js → chunk-ZLUUUTWP.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-XTSY2LTR.js";
+} from "./chunk-GZOFTODZ.js";
 
 // src/analytics/analytics.js
 import os from "os";

package/dist/constants.cjs

@@ -25,7 +25,7 @@ __export(constants_exports, {
 module.exports = __toCommonJS(constants_exports);
 
 // package.json
-var version = "4.2.6";
+var version = "4.3.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-XTSY2LTR.js";
+} from "./chunk-GZOFTODZ.js";
 export {
   VERSION
 };

package/dist/docs/development/ask-your-architecture/03-mcp-server/getting-started.md

@@ -31,6 +31,18 @@ For local development:
 http://localhost:3000/docs/mcp/
 ```
 
+The MCP server is enabled by default when EventCatalog is running in server mode with a Scale license. To disable it, set
+`mcp.enabled` to `false`:
+
+```js title="eventcatalog.config.js"
+module.exports = {
+  output: 'server',
+  mcp: {
+    enabled: false,
+  },
+};
+```
+
 ### Verify the server
 
 Visit the endpoint in your browser to verify. It returns available tools and resources:
@@ -285,4 +297,3 @@ See [instructions on the GitHub repository](https://github.com/event-catalog/mcp
 
 
 
-

package/dist/eventcatalog.cjs

@@ -144,7 +144,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "4.2.6";
+var version = "4.3.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/eventcatalog.config.d.cts

@@ -170,6 +170,11 @@ type McpAuthConfig = {
     sharedSecretEnvVar?: string;
 };
 type McpConfig = {
+    /**
+     * Enables the built-in MCP server when EventCatalog is running in server mode with a Scale license.
+     * @default true
+     */
+    enabled?: boolean;
     auth?: McpAuthConfig;
 };
 type GA4Config = {

package/dist/eventcatalog.config.d.ts

@@ -170,6 +170,11 @@ type McpAuthConfig = {
     sharedSecretEnvVar?: string;
 };
 type McpConfig = {
+    /**
+     * Enables the built-in MCP server when EventCatalog is running in server mode with a Scale license.
+     * @default true
+     */
+    enabled?: boolean;
     auth?: McpAuthConfig;
 };
 type GA4Config = {

package/dist/eventcatalog.js

@@ -1,11 +1,8 @@
 import {
   log_build_default
-} from "./chunk-OBA7TFHM.js";
+} from "./chunk-32ZHIOUO.js";
+import "./chunk-ZLUUUTWP.js";
 import "./chunk-K2XIENVT.js";
-import {
-  runMigrations
-} from "./chunk-XUAF2H54.js";
-import "./chunk-CA4U2JP7.js";
 import {
   getProjectOutDir,
   isAuthEnabled,
@@ -14,10 +11,10 @@ import {
 } from "./chunk-B7HCX5HM.js";
 import {
   generate
-} from "./chunk-OZNVNRI7.js";
+} from "./chunk-TE4QQSPT.js";
 import {
   logger
-} from "./chunk-DEGSBGEF.js";
+} from "./chunk-RQCRNCF6.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-LHR4G2UO.js";
@@ -27,7 +24,10 @@ import {
 import {
   watch
 } from "./chunk-CAJUIMDJ.js";
-import "./chunk-NZUMNTJK.js";
+import {
+  runMigrations
+} from "./chunk-XUAF2H54.js";
+import "./chunk-CA4U2JP7.js";
 import {
   createAstroDevLineFilter,
   createAstroLineFilter
@@ -38,7 +38,7 @@ import {
 import "./chunk-W5JQON7Z.js";
 import {
   VERSION
-} from "./chunk-XTSY2LTR.js";
+} from "./chunk-GZOFTODZ.js";
 import {
   linkCoreNodeModules,
   resolveInstalledCoreNodeModules

package/dist/generate.cjs

@@ -108,7 +108,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "4.2.6";
+var version = "4.3.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-OZNVNRI7.js";
-import "./chunk-DEGSBGEF.js";
-import "./chunk-XTSY2LTR.js";
+} from "./chunk-TE4QQSPT.js";
+import "./chunk-RQCRNCF6.js";
+import "./chunk-GZOFTODZ.js";
 import "./chunk-6QENHZZP.js";
 export {
   generate

package/dist/utils/cli-logger.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(cli_logger_exports);
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "4.2.6";
+var version = "4.3.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-DEGSBGEF.js";
-import "../chunk-XTSY2LTR.js";
+} from "../chunk-RQCRNCF6.js";
+import "../chunk-GZOFTODZ.js";
 export {
   logger
 };

package/eventcatalog/src/components/CopyAsMarkdown.tsx

@@ -1,8 +1,11 @@
 import * as DropdownMenu from '@radix-ui/react-dropdown-menu';
 import { Copy, FileText, Sparkles, ChevronDownIcon, ExternalLink, PenSquareIcon, RssIcon } from 'lucide-react';
-import React, { useState, isValidElement } from 'react';
+import React, { Suspense, isValidElement, lazy, useState } from 'react';
 import type { Schema } from '@utils/collections/schemas';
 import { buildUrl, toMarkdownUrl } from '@utils/url-builder';
+import McpIcon from './McpIcon';
+
+const McpConnectDialog = lazy(() => import('./McpConnectDialog'));
 
 // Type allows either a component type (like Lucide icon) or a pre-rendered element (like <img>)
 type IconInput = React.ElementType | React.ReactElement;
@@ -56,6 +59,9 @@ export function CopyPageMenu({
   preferChatAsDefault = false,
   chatButtonText = 'Ask',
   variant = 'menu',
+  mcpServerUrl,
+  resourceName,
+  mcpResourceType,
 }: {
   schemas: Schema[];
   chatQuery?: string;
@@ -66,6 +72,9 @@ export function CopyPageMenu({
   preferChatAsDefault?: boolean;
   chatButtonText?: string;
   variant?: 'menu' | 'toolbar';
+  mcpServerUrl?: string;
+  resourceName?: string;
+  mcpResourceType?: 'domain' | 'system';
 }) {
   // Define available actions
   const availableActions = {
@@ -75,6 +84,7 @@ export function CopyPageMenu({
     viewMarkdown: markdownDownloadEnabled,
     chat: chatEnabled,
     rssFeed: rssFeedEnabled,
+    mcpServer: Boolean(mcpServerUrl),
   };
 
   // Check if any actions are available
@@ -141,6 +151,13 @@ export function CopyPageMenu({
         icon: RssIcon,
       };
     }
+    if (availableActions.mcpServer) {
+      return {
+        type: 'mcpServer',
+        text: 'Connect to MCP server',
+        icon: McpIcon,
+      };
+    }
     return null;
   };
 
@@ -148,6 +165,18 @@ export function CopyPageMenu({
   const [open, setOpen] = useState(false);
   const [buttonText, setButtonText] = useState(defaultAction?.text || 'Action');
   const [copyButtonText, setCopyButtonText] = useState('Copy page as markdown');
+  const [mcpDialogOpen, setMcpDialogOpen] = useState(false);
+  const mcpDialog = mcpServerUrl && mcpDialogOpen && (
+    <Suspense fallback={null}>
+      <McpConnectDialog
+        open={mcpDialogOpen}
+        onOpenChange={setMcpDialogOpen}
+        serverUrl={mcpServerUrl}
+        resourceName={resourceName}
+        resourceType={mcpResourceType ?? 'domain'}
+      />
+    </Suspense>
+  );
 
   // Fetch the markdown from the url + .mdx
   const copyMarkdownToClipboard = async () => {
@@ -214,6 +243,9 @@ export function CopyPageMenu({
         // Dispatch custom event to open chat panel instead of navigating
         window.dispatchEvent(new CustomEvent('eventcatalog:open-chat'));
         break;
+      case 'mcpServer':
+        setMcpDialogOpen(true);
+        break;
     }
   };
 
@@ -224,6 +256,7 @@ export function CopyPageMenu({
   const actionButtonClass =
     'group inline-flex items-center gap-1.5 whitespace-nowrap text-xs font-medium text-[rgb(var(--ec-page-text-muted))] transition-colors duration-150 hover:text-[rgb(var(--ec-page-text))] focus:outline-hidden focus:ring-2 focus:ring-[rgb(var(--ec-accent))] focus:ring-offset-2 focus:ring-offset-[rgb(var(--ec-page-bg))] rounded-md';
   const actionIconClass = 'h-3.5 w-3.5 shrink-0 text-[rgb(var(--ec-icon-color))] group-hover:text-[rgb(var(--ec-page-text))]';
+  const mcpDescription = `Connect an MCP client to this ${mcpResourceType ?? 'resource'}`;
 
   const hasToolbarActions =
     availableActions.chat ||
@@ -231,12 +264,20 @@ export function CopyPageMenu({
     availableActions.viewMarkdown ||
     availableActions.copySchemas ||
     availableActions.rssFeed ||
+    availableActions.mcpServer ||
     availableActions.editPage;
 
   if (variant === 'toolbar') {
     if (!hasToolbarActions) return null;
 
-    const moreActionsAvailable = availableActions.copySchemas || availableActions.rssFeed || availableActions.editPage;
+    const showMcpToolbarAction = availableActions.mcpServer;
+    const showCopyMarkdownToolbarAction = availableActions.copyMarkdown && !showMcpToolbarAction;
+    const hasSecondaryToolbarAction = showMcpToolbarAction || showCopyMarkdownToolbarAction;
+    const moreActionsAvailable =
+      availableActions.copySchemas ||
+      availableActions.rssFeed ||
+      availableActions.editPage ||
+      (showMcpToolbarAction && availableActions.copyMarkdown);
 
     return (
       <div className="not-prose flex flex-wrap items-center gap-x-3 gap-y-1.5 text-xs text-[rgb(var(--ec-page-text-muted))]">
@@ -251,18 +292,25 @@ export function CopyPageMenu({
           </button>
         )}
 
-        {availableActions.chat && (availableActions.copyMarkdown || availableActions.viewMarkdown || moreActionsAvailable) && (
+        {availableActions.chat && (hasSecondaryToolbarAction || availableActions.viewMarkdown || moreActionsAvailable) && (
           <span className="h-4 w-px bg-[rgb(var(--ec-page-border))]" aria-hidden="true" />
         )}
 
-        {availableActions.copyMarkdown && (
+        {showMcpToolbarAction && (
+          <button type="button" onClick={() => setMcpDialogOpen(true)} className={actionButtonClass}>
+            <McpIcon className={actionIconClass} />
+            Connect to MCP server
+          </button>
+        )}
+
+        {showCopyMarkdownToolbarAction && (
           <button type="button" onClick={copyMarkdownToClipboard} className={actionButtonClass}>
             <Copy className={actionIconClass} />
             {copyButtonText}
           </button>
         )}
 
-        {availableActions.copyMarkdown && (availableActions.viewMarkdown || moreActionsAvailable) && (
+        {hasSecondaryToolbarAction && (availableActions.viewMarkdown || moreActionsAvailable) && (
           <span className="h-4 w-px bg-[rgb(var(--ec-page-border))]" aria-hidden="true" />
         )}
 
@@ -290,6 +338,15 @@ export function CopyPageMenu({
               sideOffset={10}
               align="start"
             >
+              {showMcpToolbarAction && availableActions.copyMarkdown && (
+                <DropdownMenu.Item
+                  className="cursor-pointer rounded-2xl outline-hidden transition-colors duration-150 hover:bg-[rgb(var(--ec-dropdown-hover))] data-[highlighted]:bg-[rgb(var(--ec-dropdown-hover))]"
+                  onSelect={() => copyMarkdownToClipboard()}
+                >
+                  <MenuItemContent icon={Copy} title="Copy page as markdown" description="Copy page as Markdown for LLMs" />
+                </DropdownMenu.Item>
+              )}
+
               {availableActions.copySchemas &&
                 schemas.map((schema) => {
                   const title =
@@ -348,6 +405,7 @@ export function CopyPageMenu({
             </DropdownMenu.Content>
           </DropdownMenu.Root>
         )}
+        {mcpDialog}
       </div>
     );
   }
@@ -383,6 +441,15 @@ export function CopyPageMenu({
         sideOffset={10}
         align="end"
       >
+        {availableActions.mcpServer && (
+          <DropdownMenu.Item
+            className="cursor-pointer rounded-2xl outline-hidden transition-colors duration-150 hover:bg-[rgb(var(--ec-dropdown-hover))] data-[highlighted]:bg-[rgb(var(--ec-dropdown-hover))]"
+            onSelect={() => setMcpDialogOpen(true)}
+          >
+            <MenuItemContent icon={McpIcon} title="Connect to MCP server" description={mcpDescription} />
+          </DropdownMenu.Item>
+        )}
+
         {availableActions.chat && (
           <>
             <DropdownMenu.Item
@@ -477,6 +544,7 @@ export function CopyPageMenu({
           </>
         )}
       </DropdownMenu.Content>
+      {mcpDialog}
     </DropdownMenu.Root>
   );
 }

package/eventcatalog/src/components/McpConnectDialog.tsx

@@ -0,0 +1,98 @@
+import * as Dialog from '@radix-ui/react-dialog';
+import { Check, Copy, X } from 'lucide-react';
+import { useEffect, useRef, useState } from 'react';
+import McpIcon from './McpIcon';
+
+type McpConnectDialogProps = {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  serverUrl: string;
+  resourceName?: string;
+  resourceType: 'domain' | 'system';
+};
+
+export default function McpConnectDialog({ open, onOpenChange, serverUrl, resourceName, resourceType }: McpConnectDialogProps) {
+  const [copied, setCopied] = useState(false);
+  const resetTimer = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const absoluteServerUrl = new URL(serverUrl, window.location.origin).href;
+
+  useEffect(
+    () => () => {
+      if (resetTimer.current) clearTimeout(resetTimer.current);
+    },
+    []
+  );
+
+  const copyServerUrl = async () => {
+    try {
+      await navigator.clipboard.writeText(absoluteServerUrl);
+      setCopied(true);
+      if (resetTimer.current) clearTimeout(resetTimer.current);
+      resetTimer.current = setTimeout(() => setCopied(false), 2000);
+    } catch {
+      setCopied(false);
+    }
+  };
+
+  return (
+    <Dialog.Root open={open} onOpenChange={onOpenChange}>
+      <Dialog.Portal>
+        <Dialog.Overlay className="fixed inset-0 z-50 bg-black/50 data-[state=open]:animate-overlayShow" />
+        <Dialog.Content className="fixed left-1/2 top-1/2 z-[100] w-[calc(100vw-2rem)] max-w-lg -translate-x-1/2 -translate-y-1/2 rounded-lg border border-[rgb(var(--ec-page-border))] bg-[rgb(var(--ec-card-bg,var(--ec-page-bg)))] p-6 shadow-xl focus:outline-hidden data-[state=open]:animate-contentShow">
+          <div className="flex items-start gap-3">
+            <div className="flex h-10 w-10 shrink-0 items-center justify-center rounded-lg border border-[rgb(var(--ec-page-border))] bg-[rgb(var(--ec-content-hover))]">
+              <McpIcon className="h-5 w-5" />
+            </div>
+            <div className="min-w-0 flex-1">
+              <Dialog.Title className="text-lg font-semibold text-[rgb(var(--ec-page-text))]">Connect to MCP server</Dialog.Title>
+              <Dialog.Description className="mt-1 text-sm leading-6 text-[rgb(var(--ec-page-text-muted))]">
+                Use this URL to connect an MCP client to this {resourceType}
+                {resourceName ? `: ${resourceName}` : ''}.
+              </Dialog.Description>
+            </div>
+            <Dialog.Close asChild>
+              <button
+                type="button"
+                aria-label="Close"
+                className="rounded-md p-2 text-[rgb(var(--ec-icon-color))] transition-colors hover:bg-[rgb(var(--ec-content-hover))] hover:text-[rgb(var(--ec-page-text))] focus:outline-hidden focus:ring-2 focus:ring-[rgb(var(--ec-accent))]"
+              >
+                <X className="h-4 w-4" aria-hidden="true" />
+              </button>
+            </Dialog.Close>
+          </div>
+
+          <div className="mt-6">
+            <label htmlFor="mcp-server-url" className="text-xs font-medium text-[rgb(var(--ec-page-text-muted))]">
+              MCP server URL
+            </label>
+            <div className="mt-2 flex items-center gap-2">
+              <input
+                id="mcp-server-url"
+                type="text"
+                readOnly
+                value={absoluteServerUrl}
+                onFocus={(event) => event.currentTarget.select()}
+                className="min-w-0 flex-1 rounded-md border border-[rgb(var(--ec-page-border))] bg-[rgb(var(--ec-input-bg,var(--ec-page-bg)))] px-3 py-2.5 font-mono text-xs text-[rgb(var(--ec-page-text))] outline-hidden focus:border-[rgb(var(--ec-accent))] focus:ring-1 focus:ring-[rgb(var(--ec-accent))]"
+              />
+              <button
+                type="button"
+                onClick={copyServerUrl}
+                className="inline-flex h-10 items-center gap-2 rounded-md border border-[rgb(var(--ec-page-border))] bg-[rgb(var(--ec-card-bg,var(--ec-page-bg)))] px-3 text-sm font-medium text-[rgb(var(--ec-page-text))] transition-colors hover:bg-[rgb(var(--ec-content-hover))] focus:outline-hidden focus:ring-2 focus:ring-[rgb(var(--ec-accent))]"
+              >
+                {copied ? (
+                  <Check className="h-4 w-4 text-green-500" aria-hidden="true" />
+                ) : (
+                  <Copy className="h-4 w-4" aria-hidden="true" />
+                )}
+                {copied ? 'Copied' : 'Copy'}
+              </button>
+            </div>
+            <p className="mt-3 text-xs leading-5 text-[rgb(var(--ec-page-text-muted))]">
+              Add this remote server URL to your MCP client. Authentication may be required if it is enabled for this catalog.
+            </p>
+          </div>
+        </Dialog.Content>
+      </Dialog.Portal>
+    </Dialog.Root>
+  );
+}

package/eventcatalog/src/components/McpIcon.tsx

@@ -0,0 +1,14 @@
+import { buildUrl } from '@utils/url-builder';
+
+export default function McpIcon({ className = 'h-4 w-4' }: { className?: string }) {
+  return (
+    <span className={`inline-flex shrink-0 ${className}`} aria-hidden="true">
+      <img src={buildUrl('/icons/protocols/mcp-light.svg', true)} alt="" className="h-full w-full object-contain dark:hidden" />
+      <img
+        src={buildUrl('/icons/protocols/mcp-dark.svg', true)}
+        alt=""
+        className="hidden h-full w-full object-contain dark:block"
+      />
+    </span>
+  );
+}

package/eventcatalog/src/enterprise/feature.ts

@@ -67,7 +67,7 @@ export const isCustomStylesEnabled = () => {
   return isEventCatalogStarterEnabled() || isEventCatalogScaleEnabled();
 };
 
-export const isEventCatalogMCPEnabled = () => isEventCatalogScaleEnabled() && isSSR();
+export const isEventCatalogMCPEnabled = () => isEventCatalogScaleEnabled() && isSSR() && (config?.mcp?.enabled ?? true);
 
 export const isEventCatalogMCPAuthEnabled = () => isEventCatalogMCPEnabled() && (config?.mcp?.auth?.enabled ?? false);