MCP Server over HTTP

Added in @eventcatalog/mcp-server@2.1.0

The EventCatalog can be used over HTTP, this is the recommended way to use the EventCatalog MCP server.

EventCatalog Access

The server running your MCP server will need access to your EventCatalog instance.

This is the URL of your hosted EventCatalog.

Prerequisites:

• EventCatalog instance running
• EventCatalog license
• MCP client installed (e.g Cursor, Windsurf, Claude Desktop)

Running using npx

To run the MCP Server over HTTP, you need to start the server with the --http flag.

npx -y @eventcatalog/mcp-server https://your-eventcatalog-instance.com {EVENTCATALOG_LICENSE_KEY} http {PORT} {ROOT_PATH}

Example:

npx -y @eventcatalog/mcp-server https://demo.eventcatalog.dev {EVENTCATALOG_LICENSE_KEY} http 3000 /mcp

The above command will start the MCP Server over HTTP on port 3000 and the root path /mcp.

Running using Docker

If you want to host the MCP server using our Docker image you can read our instructions on the GitHub repository.