@ekho/gitlab-mcp 1.1.0

package/dist/groups/access_tokens/tools.js

@@ -0,0 +1,198 @@
+import { z } from 'zod';
+import { GroupIdArg, PaginationArgs, ProjectIdArg } from '../../shared/args.js';
+import { safe } from '../../shared/handlers.js';
+import { resolveGroupId, resolveProjectId } from '../../shared/ids.js';
+const PatScope = z.enum([
+    'api',
+    'read_user',
+    'read_api',
+    'read_repository',
+    'write_repository',
+    'read_registry',
+    'write_registry',
+    'sudo',
+    'admin_mode',
+    'create_runner',
+    'k8s_proxy',
+    'ai_features',
+    'read_service_ping',
+]);
+const ResourceAccessTokenScope = z.enum([
+    'api',
+    'read_api',
+    'read_repository',
+    'write_repository',
+    'read_registry',
+    'write_registry',
+    'create_runner',
+    'k8s_proxy',
+    'ai_features',
+]);
+const ResourceAccessLevel = z.number().int().describe('10 guest, 20 reporter, 30 developer, 40 maintainer, 50 owner.');
+export function registerAccessTokenTools(server, ctx) {
+    // -- Personal access tokens --------------------------------------------
+    server.tool('pat_list', 'List personal access tokens visible to the current user.', {
+        user_id: z.number().int().optional().describe('Admin: filter by user.'),
+        revoked: z.boolean().optional(),
+        state: z.enum(['active', 'inactive']).optional(),
+        created_before: z.string().optional(),
+        created_after: z.string().optional(),
+        last_used_before: z.string().optional(),
+        last_used_after: z.string().optional(),
+        search: z.string().optional(),
+        ...PaginationArgs,
+    }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({ path: '/personal_access_tokens', query: args });
+        return res.data;
+    }));
+    server.tool('pat_get', 'Get a personal access token by id.', { token_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({ path: `/personal_access_tokens/${args.token_id}` });
+        return res.data;
+    }));
+    server.tool('pat_create_self', 'Create a PAT for the current user (GitLab 16.5+). Token value is returned only once.', {
+        name: z.string(),
+        scopes: z.array(PatScope),
+        expires_at: z.string().optional().describe('YYYY-MM-DD'),
+        description: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: '/personal_access_tokens/self',
+            body: args,
+        });
+        return res.data;
+    }));
+    server.tool('pat_create_for_user', 'Admin: create a PAT for another user.', {
+        user_id: z.number().int().positive(),
+        name: z.string(),
+        scopes: z.array(PatScope),
+        expires_at: z.string().optional(),
+        description: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const { user_id, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: `/users/${user_id}/personal_access_tokens`,
+            body,
+        });
+        return res.data;
+    }));
+    server.tool('pat_revoke', 'Revoke a personal access token (cannot be undone).', { token_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            method: 'DELETE',
+            path: `/personal_access_tokens/${args.token_id}`,
+        });
+        return res.data ?? { ok: true };
+    }));
+    server.tool('pat_rotate', 'Rotate a PAT — revokes the old token and issues a new one. New token is returned once.', {
+        token_id: z.number().int().positive(),
+        expires_at: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const { token_id, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: `/personal_access_tokens/${token_id}/rotate`,
+            body: Object.keys(body).length > 0 ? body : undefined,
+        });
+        return res.data;
+    }));
+    // -- Project access tokens --------------------------------------------
+    server.tool('project_access_token_list', 'List project access tokens.', { ...ProjectIdArg, ...PaginationArgs }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const { project_id: _p, ...rest } = args;
+        const res = await ctx.rest.request({
+            path: `/projects/${projectId}/access_tokens`,
+            query: rest,
+        });
+        return res.data;
+    }));
+    server.tool('project_access_token_create', 'Create a project access token. Token value is returned only once.', {
+        ...ProjectIdArg,
+        name: z.string(),
+        scopes: z.array(ResourceAccessTokenScope),
+        access_level: ResourceAccessLevel.optional(),
+        expires_at: z.string().optional(),
+        description: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const { project_id: _p, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: `/projects/${projectId}/access_tokens`,
+            body,
+        });
+        return res.data;
+    }));
+    server.tool('project_access_token_revoke', 'Revoke a project access token.', { ...ProjectIdArg, token_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const res = await ctx.rest.request({
+            method: 'DELETE',
+            path: `/projects/${projectId}/access_tokens/${args.token_id}`,
+        });
+        return res.data ?? { ok: true };
+    }));
+    server.tool('project_access_token_rotate', 'Rotate a project access token.', {
+        ...ProjectIdArg,
+        token_id: z.number().int().positive(),
+        expires_at: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const projectId = resolveProjectId(ctx.config, args.project_id);
+        const { project_id: _p, token_id, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: `/projects/${projectId}/access_tokens/${token_id}/rotate`,
+            body: Object.keys(body).length > 0 ? body : undefined,
+        });
+        return res.data;
+    }));
+    // -- Group access tokens ----------------------------------------------
+    server.tool('group_access_token_list', 'List group access tokens.', { ...GroupIdArg, ...PaginationArgs }, async (args) => safe(async () => {
+        const groupId = resolveGroupId(ctx.config, args.group_id);
+        const { group_id: _g, ...rest } = args;
+        const res = await ctx.rest.request({
+            path: `/groups/${groupId}/access_tokens`,
+            query: rest,
+        });
+        return res.data;
+    }));
+    server.tool('group_access_token_create', 'Create a group access token. Token value is returned only once.', {
+        ...GroupIdArg,
+        name: z.string(),
+        scopes: z.array(ResourceAccessTokenScope),
+        access_level: ResourceAccessLevel.optional(),
+        expires_at: z.string().optional(),
+        description: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const groupId = resolveGroupId(ctx.config, args.group_id);
+        const { group_id: _g, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: `/groups/${groupId}/access_tokens`,
+            body,
+        });
+        return res.data;
+    }));
+    server.tool('group_access_token_revoke', 'Revoke a group access token.', { ...GroupIdArg, token_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const groupId = resolveGroupId(ctx.config, args.group_id);
+        const res = await ctx.rest.request({
+            method: 'DELETE',
+            path: `/groups/${groupId}/access_tokens/${args.token_id}`,
+        });
+        return res.data ?? { ok: true };
+    }));
+    server.tool('group_access_token_rotate', 'Rotate a group access token.', {
+        ...GroupIdArg,
+        token_id: z.number().int().positive(),
+        expires_at: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const groupId = resolveGroupId(ctx.config, args.group_id);
+        const { group_id: _g, token_id, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: `/groups/${groupId}/access_tokens/${token_id}/rotate`,
+            body: Object.keys(body).length > 0 ? body : undefined,
+        });
+        return res.data;
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/groups/access_tokens/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/access_tokens/tools.ts"],"names":[],"mappings":"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"}

package/dist/groups/admin/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolContext } from '../../tools/types.js';
+export declare function registerAdminTools(server: McpServer, ctx: ToolContext): void;

package/dist/groups/admin/tools.js

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+import { PaginationArgs } from '../../shared/args.js';
+import { safe } from '../../shared/handlers.js';
+const BroadcastTarget = z.enum(['banner', 'notification']);
+const BroadcastTheme = z.enum(['indigo', 'light-indigo', 'blue', 'light-blue', 'green', 'light-green', 'red', 'light-red', 'dark', 'light']);
+export function registerAdminTools(server, ctx) {
+    // -- Application settings ---------------------------------------------
+    server.tool('application_settings_get', 'Get current instance application settings (admin).', {}, async () => safe(async () => {
+        const res = await ctx.rest.request({ path: '/application/settings' });
+        return res.data;
+    }));
+    server.tool('application_settings_update', 'Update instance application settings. Pass the keys you want to change as `settings`.', {
+        settings: z.record(z.unknown()).describe('Map of setting name to new value.'),
+    }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            method: 'PUT',
+            path: '/application/settings',
+            body: args.settings,
+        });
+        return res.data;
+    }));
+    // -- OAuth applications -----------------------------------------------
+    server.tool('application_list', 'List OAuth applications registered on the instance (admin).', PaginationArgs, async (args) => safe(async () => {
+        const res = await ctx.rest.request({ path: '/applications', query: args });
+        return res.data;
+    }));
+    server.tool('application_create', 'Register a new OAuth application (admin). Secret is returned only once.', {
+        name: z.string(),
+        redirect_uri: z.string(),
+        scopes: z.string().describe('Space-separated scopes, e.g. "api read_user".'),
+        confidential: z.boolean().optional(),
+        trusted: z.boolean().optional(),
+    }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: '/applications',
+            body: args,
+        });
+        return res.data;
+    }));
+    server.tool('application_delete', 'Delete an OAuth application (admin).', { application_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            method: 'DELETE',
+            path: `/applications/${args.application_id}`,
+        });
+        return res.data ?? { ok: true };
+    }));
+    // -- Broadcast messages -----------------------------------------------
+    server.tool('broadcast_message_list', 'List broadcast messages.', PaginationArgs, async (args) => safe(async () => {
+        const res = await ctx.rest.request({ path: '/broadcast_messages', query: args });
+        return res.data;
+    }));
+    server.tool('broadcast_message_get', 'Get a broadcast message by id.', { broadcast_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            path: `/broadcast_messages/${args.broadcast_id}`,
+        });
+        return res.data;
+    }));
+    server.tool('broadcast_message_create', 'Create a broadcast message (admin).', {
+        message: z.string(),
+        starts_at: z.string().optional().describe('ISO 8601'),
+        ends_at: z.string().optional(),
+        color: z.string().optional().describe('Hex (banner only)'),
+        font: z.string().optional(),
+        target_path: z.string().optional().describe('Path regex to show on, e.g. "/group/*".'),
+        target_access_levels: z.array(z.number().int()).optional(),
+        broadcast_type: BroadcastTarget.optional(),
+        dismissable: z.boolean().optional(),
+        theme: BroadcastTheme.optional(),
+    }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: '/broadcast_messages',
+            body: args,
+        });
+        return res.data;
+    }));
+    server.tool('broadcast_message_update', 'Update a broadcast message.', {
+        broadcast_id: z.number().int().positive(),
+        message: z.string().optional(),
+        starts_at: z.string().optional(),
+        ends_at: z.string().optional(),
+        color: z.string().optional(),
+        font: z.string().optional(),
+        target_path: z.string().optional(),
+        target_access_levels: z.array(z.number().int()).optional(),
+        broadcast_type: BroadcastTarget.optional(),
+        dismissable: z.boolean().optional(),
+        theme: BroadcastTheme.optional(),
+    }, async (args) => safe(async () => {
+        const { broadcast_id, ...body } = args;
+        const res = await ctx.rest.request({
+            method: 'PUT',
+            path: `/broadcast_messages/${broadcast_id}`,
+            body,
+        });
+        return res.data;
+    }));
+    server.tool('broadcast_message_delete', 'Delete a broadcast message.', { broadcast_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            method: 'DELETE',
+            path: `/broadcast_messages/${args.broadcast_id}`,
+        });
+        return res.data ?? { ok: true };
+    }));
+    // -- License ----------------------------------------------------------
+    server.tool('license_get_current', 'Get the current self-managed license (admin, self-managed only).', {}, async () => safe(async () => {
+        const res = await ctx.rest.request({ path: '/license' });
+        return res.data;
+    }));
+    server.tool('license_list', 'List all licenses uploaded to the instance (admin).', {}, async () => safe(async () => {
+        const res = await ctx.rest.request({ path: '/licenses' });
+        return res.data;
+    }));
+    server.tool('license_add', 'Upload a new license (admin, self-managed).', { license: z.string().describe('License key contents.') }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            method: 'POST',
+            path: '/license',
+            body: args,
+        });
+        return res.data;
+    }));
+    server.tool('license_delete', 'Delete a license (admin).', { license_id: z.number().int().positive() }, async (args) => safe(async () => {
+        const res = await ctx.rest.request({
+            method: 'DELETE',
+            path: `/license/${args.license_id}`,
+        });
+        return res.data ?? { ok: true };
+    }));
+    // -- Version ----------------------------------------------------------
+    server.tool('version_get', 'Get the GitLab server version (alternative to metadata_get).', {}, async () => safe(async () => {
+        const res = await ctx.rest.request({ path: '/version' });
+        return res.data;
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/groups/admin/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/admin/tools.ts"],"names":[],"mappings":"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"}

package/dist/groups/ai_catalog/queries.d.ts

@@ -0,0 +1,3 @@
+export declare const AI_CATALOG_ITEMS = "\n  query AiCatalogItems(\n    $projectPath: ID\n    $itemType: AiCatalogItemType\n    $first: Int\n    $after: String\n  ) {\n    aiCatalogItems(projectPath: $projectPath, itemType: $itemType, first: $first, after: $after) {\n      pageInfo {\n        endCursor\n        hasNextPage\n      }\n      nodes {\n        id\n        name\n        description\n        itemType\n        public\n        createdAt\n        updatedAt\n        project {\n          id\n          fullPath\n        }\n        versions {\n          nodes {\n            id\n            versionName\n            createdAt\n          }\n        }\n      }\n    }\n  }\n";
+export declare const AI_CATALOG_ITEM_GET = "\n  query AiCatalogItem($id: AiCatalogItemID!) {\n    aiCatalogItem(id: $id) {\n      id\n      name\n      description\n      itemType\n      public\n      createdAt\n      updatedAt\n      project {\n        id\n        fullPath\n      }\n      versions {\n        nodes {\n          id\n          versionName\n          createdAt\n        }\n      }\n    }\n  }\n";
+export declare const AI_SELF_HOSTED_MODELS = "\n  query AiSelfHostedModels {\n    aiSelfHostedModels {\n      nodes {\n        id\n        name\n        model\n        endpoint\n        identifier\n        hasApiToken\n        modelProvider\n      }\n    }\n  }\n";

package/dist/groups/ai_catalog/queries.js

@@ -0,0 +1,75 @@
+export const AI_CATALOG_ITEMS = /* GraphQL */ `
+  query AiCatalogItems(
+    $projectPath: ID
+    $itemType: AiCatalogItemType
+    $first: Int
+    $after: String
+  ) {
+    aiCatalogItems(projectPath: $projectPath, itemType: $itemType, first: $first, after: $after) {
+      pageInfo {
+        endCursor
+        hasNextPage
+      }
+      nodes {
+        id
+        name
+        description
+        itemType
+        public
+        createdAt
+        updatedAt
+        project {
+          id
+          fullPath
+        }
+        versions {
+          nodes {
+            id
+            versionName
+            createdAt
+          }
+        }
+      }
+    }
+  }
+`;
+export const AI_CATALOG_ITEM_GET = /* GraphQL */ `
+  query AiCatalogItem($id: AiCatalogItemID!) {
+    aiCatalogItem(id: $id) {
+      id
+      name
+      description
+      itemType
+      public
+      createdAt
+      updatedAt
+      project {
+        id
+        fullPath
+      }
+      versions {
+        nodes {
+          id
+          versionName
+          createdAt
+        }
+      }
+    }
+  }
+`;
+export const AI_SELF_HOSTED_MODELS = /* GraphQL */ `
+  query AiSelfHostedModels {
+    aiSelfHostedModels {
+      nodes {
+        id
+        name
+        model
+        endpoint
+        identifier
+        hasApiToken
+        modelProvider
+      }
+    }
+  }
+`;
+//# sourceMappingURL=queries.js.map

package/dist/groups/ai_catalog/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/groups/ai_catalog/queries.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC7C,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;CAuBhD,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC;;;;;;;;;;;;;;CAclD,CAAC"}

package/dist/groups/ai_catalog/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolContext } from '../../tools/types.js';
+export declare function registerAiCatalogTools(server: McpServer, ctx: ToolContext): void;

package/dist/groups/ai_catalog/tools.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { safe } from '../../shared/handlers.js';
+import { AI_CATALOG_ITEM_GET, AI_CATALOG_ITEMS, AI_SELF_HOSTED_MODELS } from './queries.js';
+const AiCatalogItemType = z.enum(['AGENT', 'FLOW']);
+export function registerAiCatalogTools(server, ctx) {
+    server.tool('ai_catalog_item_list', 'List AI Catalog items (agents and flows). Filter by project_path or item_type.', {
+        project_path: z.string().optional(),
+        item_type: AiCatalogItemType.optional(),
+        first: z.number().int().positive().max(100).optional(),
+        after: z.string().optional(),
+    }, async (args) => safe(async () => {
+        const data = await ctx.graphql.query({
+            query: AI_CATALOG_ITEMS,
+            variables: {
+                projectPath: args.project_path,
+                itemType: args.item_type,
+                first: args.first ?? 20,
+                after: args.after,
+            },
+        });
+        return {
+            items: data.aiCatalogItems.nodes,
+            page_info: data.aiCatalogItems.pageInfo,
+        };
+    }));
+    server.tool('ai_catalog_item_get', 'Get a single AI Catalog item by global id.', { id: z.string().describe('Global id: gid://gitlab/Ai::Catalog::Item/<n>') }, async (args) => safe(async () => {
+        const data = await ctx.graphql.query({
+            query: AI_CATALOG_ITEM_GET,
+            variables: { id: args.id },
+        });
+        if (!data.aiCatalogItem)
+            throw new Error(`AI catalog item ${args.id} not found.`);
+        return data.aiCatalogItem;
+    }));
+    server.tool('ai_self_hosted_model_list', 'List self-hosted models configured on the instance (Duo Enterprise on-prem).', {}, async () => safe(async () => {
+        const data = await ctx.graphql.query({ query: AI_SELF_HOSTED_MODELS });
+        return data.aiSelfHostedModels?.nodes ?? [];
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/groups/ai_catalog/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/ai_catalog/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE5F,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEpD,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,GAAgB;IACxE,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,gFAAgF,EAChF;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,SAAS,EAAE,iBAAiB,CAAC,QAAQ,EAAE;QACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC7B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAKjC;YACD,KAAK,EAAE,gBAAgB;YACvB,SAAS,EAAE;gBACT,WAAW,EAAE,IAAI,CAAC,YAAY;gBAC9B,QAAQ,EAAE,IAAI,CAAC,SAAS;gBACxB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB;SACF,CAAC,CAAC;QACH,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK;YAChC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ;SACxC,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,4CAA4C,EAC5C,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC,EAAE,EAC5E,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAoC;YACtE,KAAK,EAAE,mBAAmB;YAC1B,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,2BAA2B,EAC3B,8EAA8E,EAC9E,EAAE,EACF,KAAK,IAAI,EAAE,CACT,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAEjC,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAAC;IAC9C,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/groups/analytics/queries.d.ts

@@ -0,0 +1 @@
+export declare const USAGE_TRENDS = "\n  query UsageTrends(\n    $identifier: MeasurementIdentifier!\n    $first: Int\n    $after: String\n    $recordedAfter: Time\n    $recordedBefore: Time\n  ) {\n    usageTrendsMeasurements(\n      identifier: $identifier\n      first: $first\n      after: $after\n      recordedAfter: $recordedAfter\n      recordedBefore: $recordedBefore\n    ) {\n      pageInfo {\n        endCursor\n        hasNextPage\n      }\n      nodes {\n        recordedAt\n        count\n        identifier\n      }\n    }\n  }\n";

package/dist/groups/analytics/queries.js

@@ -0,0 +1,28 @@
+export const USAGE_TRENDS = /* GraphQL */ `
+  query UsageTrends(
+    $identifier: MeasurementIdentifier!
+    $first: Int
+    $after: String
+    $recordedAfter: Time
+    $recordedBefore: Time
+  ) {
+    usageTrendsMeasurements(
+      identifier: $identifier
+      first: $first
+      after: $after
+      recordedAfter: $recordedAfter
+      recordedBefore: $recordedBefore
+    ) {
+      pageInfo {
+        endCursor
+        hasNextPage
+      }
+      nodes {
+        recordedAt
+        count
+        identifier
+      }
+    }
+  }
+`;
+//# sourceMappingURL=queries.js.map

package/dist/groups/analytics/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/groups/analytics/queries.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BzC,CAAC"}

package/dist/groups/analytics/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolContext } from '../../tools/types.js';
+export declare function registerAnalyticsTools(server: McpServer, ctx: ToolContext): void;