{"id":26641126,"url":"https://github.com/event-catalog/mcp-server","last_synced_at":"2025-08-16T18:09:26.815Z","repository":{"id":282901410,"uuid":"950031561","full_name":"event-catalog/mcp-server","owner":"event-catalog","description":"MCP server for EventCatalog","archived":false,"fork":false,"pushed_at":"2025-06-27T08:21:57.000Z","size":825,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-11T03:45:25.964Z","etag":null,"topics":["architecture","documentation","mcp","mcp-server"],"latest_commit_sha":null,"homepage":"https://eventcatalog.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/event-catalog.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/funding.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["event-catalog"]}},"created_at":"2025-03-17T14:21:35.000Z","updated_at":"2025-07-23T19:38:00.000Z","dependencies_parsed_at":"2025-03-17T22:15:28.954Z","dependency_job_id":null,"html_url":"https://github.com/event-catalog/mcp-server","commit_stats":null,"previous_names":["event-catalog/mcp-server"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/event-catalog/mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/event-catalog%2Fmcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/event-catalog%2Fmcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/event-catalog%2Fmcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/event-catalog%2Fmcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/event-catalog","download_url":"https://codeload.github.com/event-catalog/mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/event-catalog%2Fmcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270749361,"owners_count":24638720,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-16T02:00:11.002Z","response_time":91,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["architecture","documentation","mcp","mcp-server"],"created_at":"2025-03-24T18:19:50.275Z","updated_at":"2025-08-16T18:09:26.806Z","avatar_url":"https://github.com/event-catalog.png","language":"TypeScript","funding_links":["https://github.com/sponsors/event-catalog"],"categories":["Knowledge \u0026 Memory","Cloud Services","Developer Tools"],"sub_categories":["How to Submit"],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003ch1\u003e📖 EventCatalog - MCP Server\u003c/h1\u003e\n\u003ch3\u003eSave time and money by getting insights from your EventCatalog directly from your MCP Client (\u003ca href=\"https://www.anthropic.com/claude\"\u003eClaude\u003c/a\u003e, \u003ca href=\"https://www.cursor.com/\"\u003eCursor\u003c/a\u003e, \u003ca href=\"https://codeium.com/windsurf\"\u003eWindsurf\u003c/a\u003e, etc)\u003c/h3\u003e\n\n\u003c!-- \u003cimg width=\"745\" alt=\"Screenshot 2024-12-13 at 09 56 05\" src=\"https://github.com/user-attachments/assets/f537ec1f-54ee-4de1-996c-c6b72191be39\" /\u003e --\u003e\n\u003cimg width=\"745\" alt=\"EventCatalog\" src=\"./images/mcp.png\" /\u003e\n\n\n\u003ch4\u003eFeatures: Ask about domains, services and messages. Get answers in seconds. Request schemas, who owns what and much more.\u003c/h4\u003e\n\n[Read the Docs](https://www.eventcatalog.dev/docs/development/getting-started/introduction) | [View Demo](https://demo.eventcatalog.dev)\n\n\u003c/div\u003e\n\u003chr/\u003e\n\n## Why EventCatalog MCP Server?\n\nEventCatalog is an Open Source tool that helps you document your event-driven architecture.\nUsing EventCatalog you can document your domains, services and messages, schemas and much more.\n\nUsing the **EventCatalog MCP Server** you can get more value from your EventCatalog by asking questions about your architecture in the tools you already use.\n\nExample questions:\n\n- What events do we have in our architecture?\n- Tell me more about the {service} service.\n- 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?\n- Get me the schema for the event `UserCreated` in EventCatalog.\n- Here is a new version of the `UserCreated` schema, what downstream consumers will be affected by this change?\n\nRather then digging through your architecture to find the answers you need, you can ask the MCP server directly from your MCP Client.\n\n---\n\n## EventCatalog MCP Features\n\n- 🤖 Connect to any MCP Client ([Claude](https://www.anthropic.com/claude), [Cursor](https://www.cursor.com/), [Windsurf](https://codeium.com/windsurf), etc)\n- 🤖 Run MCP server locally on your machine with one command\n- 🤖 Connect to your EventCatalog instances\n- 🤖 Ask questions about your architectures\n- 🤖 Ask questions about your OpenAPI and AsyncAPI specifications\n- 🤖 Ask about domains, services and messages, and much more\n- 🤖 Get the schemas for events, queries, commands and services (OpenAPI, AsyncAPI, JSON Schema)\n- 🤖 Ask questions about ubiquitous language for any domain and their entities\n\n---\n\n# Getting Started\n\n## Installation\n\nFirst, you need to enable the [`LLMS.txt` feature](https://www.eventcatalog.dev/docs/development/developer-tools/llms.txt) in your EventCatalog instance.\n\n1. Enable the [`LLMS.txt` feature](https://www.eventcatalog.dev/docs/development/developer-tools/llms.txt) in your EventCatalog instance, by configuring your `eventcatalog.config.js` file.\n2. Deploy your EventCatalog instance with the `LLMS.txt` feature enabled.\n\nNext, you will need to get a EventCatalog Scale license key, you can get a 14 day trial license key from [EventCatalog Cloud](https://eventcatalog.cloud).\n\n### Installing via Smithery\n\nTo install EventCatalog for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@event-catalog/mcp-server):\n\n```bash\nnpx -y @smithery/cli install @event-catalog/mcp-server --client claude\n```\n\n## Setup MCP Clients\n\nEach MCP client has a different way of adding the MCP server.\n\nYou can find some helpful links below to get started.\n\n- [Claude Desktop](#adding-the-mcp-server-to-claude-desktop)\n- [Cursor](#adding-the-mcp-server-to-cursor)\n\n## Adding the MCP server to Claude Desktop\n\nTo use this with Claude Desktop, add the following to your `claud_desktop_config.json` file. The full path on MacOS: `~/Library/Application Support/Claude/claud_desktop_config.json`, on Windows: `%APPDATA%\\Claude\\claud_desktop_config.json`\n\n```js\n{\n  \"mcpServers\": {\n    \"eventcatalog\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@eventcatalog/mcp-server\",\n        \"https://demo.eventcatalog.dev\", // Replace with your EventCatalog URL\n        \"ABCD-1234-5678-9012-3456-7890\" // Replace with your EventCatalog Scale license key\n      ]\n    }\n  }\n}\n```\n\n## Adding the MCP server to Cursor\n\nGo to Cursor Settings -\u003e MCP Servers -\u003e Add MCP Server.\n\n- Name: `eventcatalog`\n- Command: `npx`\n- Args: `-y @eventcatalog/mcp-server {URL_TO_YOUR_EVENTCATALOG_INSTANCE}`\n\n### Configuration for your project\n\nYou can also create `.mcp.json` files in your project to configure the MCP server for your project using Cursor.\n\n```json\n{\n  \"mcpServers\": {\n    \"eventcatalog\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@eventcatalog/mcp-server\", \"https://demo.eventcatalog.dev\", \"ABCD-1234-5678-9012-3456-7890\"]\n    }\n  }\n}\n```\n\nYou can read more about configuration for your project in the [Cursor documentation](https://docs.cursor.com/context/model-context-protocol#configuration-locations).\n\n\n# API\n\nHere is a list of all the APIs that the MCP server supports.\n\n## Tools\n\n- `find_resources`\n  - Find resources that are available in EventCatalog\n- `find_resource`\n  - Get more information about a service, domain, event, command, query or flow in EventCatalog using its id and version\n- `find_producers_and_consumers`\n  - Get the producers (sends) and consumers (receives) for a service in EventCatalog\n- `get_schema`\n  - Returns the schema for a service, event, command or query in EventCatalog\n- `review_schema_changes`\n  - Reviews schema changes for breaking changes and suggests fixes.\n- `explain_ubiquitous_language_terms`\n  - Explain ubiquitous language terms for a given domain\n- `find_owners`\n  - Find owners (teams or users) for a domain, services, messages, events, commands, queries, flows or entities in EventCatalog\n- `create_flow`\n  - Create a new flow in EventCatalog given a description of the business workflow.\n  - The tool will check all your resources in EventCatalog to find the best resources to match against the description.\n  - The flow will be created (markdown file) and can be visualized in EventCatalog.\n\n\n## Resources\n\n- `eventcatalog://all`\n  - All messages, domains and services in EventCatalog\n- `eventcatalog://events`\n  - All events in EventCatalog\n- `eventcatalog://domains`\n  - All domains in EventCatalog\n- `eventcatalog://services`\n  - All services in EventCatalog\n- `eventcatalog://queries`\n  - All queries in EventCatalog\n- `eventcatalog://commands`\n  - All commands in EventCatalog\n- `eventcatalog://flows`\n  - All flows in EventCatalog\n- `eventcatalog://teams`\n  - All teams in EventCatalog\n- `eventcatalog://users`\n  - All users in EventCatalog\n\n\n\n## Missing an API?\n\nWe are working on adding more APIs to the MCP server. If you need something specific, please [open an issue](https://github.com/eventcatalog/mcp-server/issues) and we will add it to the server.\n\n\n## Contributing\n\n1. Clone the repository\n2. Run `pnpm install` to install the dependencies\n3. Run `pnpm run build`\n\nTo use the build as your MCP server you can point your MCP client to the `dist` folder.\n\nExample for Cursor:\n\n```json\n{\n  \"mcpServers\": {\n    \"eventcatalog\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"tsx /PATH_TO_YOUR_REPO/src/index.ts\",  \"https://demo.eventcatalog.dev\", \"ABCD-1234-5678-9012-3456-7890\"]\n    }\n  }\n}\n```\n# Sponsors\n\nThank you to our project sponsors.\n\n## Gold sponsors\n\n\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource srcset=\"./images/sponsors/gravitee-logo-white.webp\" media=\"(prefers-color-scheme: dark)\" /\u003e\n    \u003cimg alt=\"hookdeck\" src=\"./images/sponsors/gravitee-logo-black.svg\" width=\"50%\" /\u003e\n  \u003c/picture\u003e\n  \u003cp style=\"margin: 0; padding: 0;\"\u003eManage, secure, and govern every API in your organization\u003c/p\u003e\n  \u003ca href=\"https://gravitee.io?utm_source=eventcatalog\u0026utm_medium=web\u0026utm_campaign=sponsorship\" target=\"_blank\"\u003eLearn more\u003c/a\u003e\n\u003c/div\u003e\n\n\u003chr /\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"oso\" src=\"./images/sponsors/oso-logo-green.png\" width=\"30%\" /\u003e\n  \u003cp style=\"margin: 0; padding: 0;\"\u003eDelivering Apache Kafka professional services to your business\n\u003c/p\u003e\n  \u003ca href=\"https://oso.sh/?utm_source=eventcatalog\u0026utm_medium=web\u0026utm_campaign=sponsorship\" target=\"_blank\" \u003eLearn more\u003c/a\u003e\n\u003c/div\u003e\n\n\u003chr /\u003e\n\n_Sponsors help make EventCatalog sustainable, want to help the project? Get in touch! Or [visit our sponsor page](https://www.eventcatalog.dev/support)._\n\n# Enterprise support\n\nInterested in collaborating with us? Our offerings include dedicated support, priority assistance, feature development, custom integrations, and more.\n\nFind more details on our [services page](https://eventcatalog.dev/services).\n\n# License\n\nUsage of this feature is part of the [EventCatalog Pro Edition](https://www.eventcatalog.dev/pricing)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevent-catalog%2Fmcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevent-catalog%2Fmcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevent-catalog%2Fmcp-server/lists"}