Merge pull request #14 from event-catalog/added-owners

feat(core): added owners tools

Author: boyney123

.changeset/thirty-cycles-wait.md

@@ -0,0 +1,5 @@
+---
+"@eventcatalog/mcp-server": patch
+---
+
+feat(core): added owners tools

README.md

@@ -138,6 +138,9 @@ Here is a list of all the APIs that the MCP server supports.
   - Reviews schema changes for breaking changes and suggests fixes.
 - `explain_ubiquitous_language_terms`
   - Explain ubiquitous language terms for a given domain
+- `find_owners`
+  - Find owners (teams or users) for a domain, services, messages, events, commands, queries, flows or entities in EventCatalog
+
 
 ## Resources
 

src/tools/index.ts

@@ -73,6 +73,7 @@ export const TOOL_DEFINITIONS = [
       '- If the resource has a domain, include it in the response',
       '- Ask the user if they would like more information about a specific resource',
       '- When you return a message, in brackets let me know if its a query, command or event',
+      `- If you are returning a flow (state machine) try and return the result in mermaid to the user, visualizing how the business logic flows`,
       `- If you return any URLS make sure to include the host URL ${process.env.EVENTCATALOG_URL}`,
     ].join('\n'),
     paramsSchema: {
@@ -83,6 +84,22 @@ export const TOOL_DEFINITIONS = [
         .describe('The type of resource to find'),
     },
   },
+  {
+    name: 'find_owners' as const,
+    description: [
+      'Find owners (teams or users) for a domain, services, messages, events, commands, queries, flows or entities in EventCatalog',
+      'Use this tool when you need to:',
+      '- Find owners (teams or users) for a domain, services, messages, events, commands, queries, flows or entities in EventCatalog',
+      '- A resource in eventcatalog can have owners, use that id to find the owners',
+      '- Return everything you know about the owners',
+      '- When you find owners the url would look something like /docs/users/{id} if its a user or /docs/teams/{id} if its a team',
+      '- When you return owners make sure they include the url to the documentation',
+      `- If you return any URLS make sure to include the host URL ${process.env.EVENTCATALOG_URL}`,
+    ].join('\n'),
+    paramsSchema: {
+      id: z.string().trim().describe('The id of the owner (user or team) to find'),
+    },
+  },
   {
     name: 'explain_ubiquitous_language_terms' as const,
     description: [
@@ -187,6 +204,12 @@ const handlers = {
       content: [{ type: 'text', text: text }],
     };
   },
+  find_owners: async (params: any) => {
+    const text = await getEventCatalogResources();
+    return {
+      content: [{ type: 'text', text: text }],
+    };
+  },
 };
 
 export function registerTools(server: McpServer) {