@itm-platform/mcp-server 1.0.0

package/dist/tools/graphql-queries.js

@@ -0,0 +1,26 @@
+export const COMPONENTS_QUERY = `query($w: JSON, $proj: JSON, $sort: JSON, $limit: Int, $skip: Int) {
+  components(where: $w, project: $proj, sort: $sort, limit: $limit, skip: $skip) {
+    items total limit skip
+  }
+}`;
+export const COMPONENT_QUERY = `query($id: ID!, $proj: JSON) {
+  component(id: $id, project: $proj)
+}`;
+export const AGGREGATE_QUERY = `query($p: JSON!) {
+  aggregateComponents(pipeline: $p)
+}`;
+export const DEFAULT_PROJECT_FIELDS = {
+    id: 1, name: 1, code: 1, componentType: 1,
+    statusLabel: 1, priorityLabel: 1, percentComplete: 1,
+    startDate: 1, endDate: 1,
+    'managers.name': 1, 'managers.userId': 1,
+    methodology: 1, customTypeLabel: 1,
+};
+export const MAX_LIST_LIMIT = 200;
+export const MAX_AGG_LIMIT = 1000;
+export function clampLimit(limit, max) {
+    if (limit === undefined || limit <= 0)
+        return 50;
+    return Math.min(limit, max);
+}
+//# sourceMappingURL=graphql-queries.js.map

package/dist/tools/graphql-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-queries.js","sourceRoot":"","sources":["../../src/tools/graphql-queries.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;EAI9B,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;;EAE7B,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;;EAE7B,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC;IACzC,WAAW,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC;IACpD,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,eAAe,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAElC,MAAM,UAAU,UAAU,CAAC,KAAyB,EAAE,GAAW;IAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC"}

package/dist/tools/portfolio.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Clients } from '../clients/index.js';
+export declare function buildAggregationPipeline(args: {
+    groupBy: string;
+    metrics: string[];
+    filter?: Record<string, unknown>;
+    limit?: number;
+}): Record<string, unknown>[];
+export declare function registerPortfolioTools(server: McpServer, clients: Clients): void;
+//# sourceMappingURL=portfolio.d.ts.map

package/dist/tools/portfolio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio.d.ts","sourceRoot":"","sources":["../../src/tools/portfolio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAWnD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,6BAkBA;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,QAgCzE"}

package/dist/tools/portfolio.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import { AGGREGATE_QUERY, MAX_AGG_LIMIT, clampLimit } from './graphql-queries.js';
+import { validateDataMartQuery } from '../validation/query-validator.js';
+const METRIC_MAP = {
+    count: { count: { $sum: 1 } },
+    avgProgress: { avgProgress: { $avg: '$percentComplete' } },
+    totalBudget: { totalBudget: { $sum: '$budgetTopDown.totalCost' } },
+    totalActual: { totalActual: { $sum: '$budgetActual.totalCost' } },
+};
+export function buildAggregationPipeline(args) {
+    const pipeline = [];
+    const matchStage = { componentType: { $eq: 'project' } };
+    if (args.filter)
+        Object.assign(matchStage, args.filter);
+    pipeline.push({ $match: matchStage });
+    const groupStage = { _id: `$${args.groupBy}` };
+    for (const metric of args.metrics) {
+        const mapping = METRIC_MAP[metric];
+        if (mapping)
+            Object.assign(groupStage, mapping);
+    }
+    pipeline.push({ $group: groupStage });
+    pipeline.push({ $sort: { count: -1 } });
+    pipeline.push({ $limit: clampLimit(args.limit, MAX_AGG_LIMIT) });
+    return pipeline;
+}
+export function registerPortfolioTools(server, clients) {
+    server.registerTool('aggregate_portfolio', {
+        description: 'Portfolio-level analytics: group projects by any field and compute metrics (count, avgProgress, totalBudget, totalActual). Uses DataMart aggregation -- no REST equivalent. Available groupBy fields: statusLabel, priorityLabel, methodology, customTypeLabel, isClosed, managers.name.',
+        inputSchema: {
+            groupBy: z.string().describe('Field to group by (e.g. "statusLabel", "methodology", "customTypeLabel")'),
+            metrics: z.array(z.enum(['count', 'avgProgress', 'totalBudget', 'totalActual']))
+                .describe('Metrics to compute per group'),
+            filter: z.record(z.unknown()).optional().describe('Additional MongoDB filter to narrow the portfolio (merged with componentType: project)'),
+            limit: z.number().optional().describe('Max groups to return (default 50, max 1000)'),
+        },
+    }, async (args) => {
+        const pipeline = buildAggregationPipeline(args);
+        const queryBody = {
+            query: AGGREGATE_QUERY.replace('$p', 'pipeline'),
+            variables: { p: pipeline },
+        };
+        const validation = validateDataMartQuery({ query: `query($p: JSON!) { aggregateComponents(pipeline: $p) }`, variables: { p: pipeline } });
+        if (!validation.ok) {
+            return {
+                content: [{ type: 'text', text: `Validation error: ${validation.error?.message}` }],
+                isError: true,
+            };
+        }
+        const data = await clients.datamart.query({ query: AGGREGATE_QUERY, variables: { p: pipeline } });
+        return { content: [{ type: 'text', text: JSON.stringify(data.aggregateComponents, null, 2) }] };
+    });
+}
+//# sourceMappingURL=portfolio.js.map

package/dist/tools/portfolio.js.map

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

package/dist/tools/projects.d.ts

@@ -0,0 +1,42 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Clients } from '../clients/index.js';
+interface SearchProjectsArgs {
+    query?: string;
+    status?: string;
+    type?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    sort?: string;
+    limit?: number;
+    skip?: number;
+}
+export declare function buildSearchProjectsVariables(args: SearchProjectsArgs): {
+    w: Record<string, unknown>;
+    proj: {
+        id: number;
+        name: number;
+        code: number;
+        componentType: number;
+        statusLabel: number;
+        priorityLabel: number;
+        percentComplete: number;
+        startDate: number;
+        endDate: number;
+        'managers.name': number;
+        'managers.userId': number;
+        methodology: number;
+        customTypeLabel: number;
+    };
+    sort: {
+        [args.sort]: number;
+        name?: undefined;
+    } | {
+        name: number;
+    };
+    limit: number;
+    skip: number;
+};
+export declare function buildGetProjectProjection(include: string[]): Record<string, number>;
+export declare function registerProjectTools(server: McpServer, clients: Clients): void;
+export {};
+//# sourceMappingURL=projects.d.ts.map

package/dist/tools/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,UAAU,kBAAkB;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;QAY7C,CAAC,IAAI,CAAC,IAAI,CAAC,SAAG;;;;;;;EAIrC;AAWD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOnF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,QAyCvE"}

package/dist/tools/projects.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { COMPONENTS_QUERY, COMPONENT_QUERY, DEFAULT_PROJECT_FIELDS, MAX_LIST_LIMIT, clampLimit } from './graphql-queries.js';
+export function buildSearchProjectsVariables(args) {
+    const where = { componentType: { $eq: 'project' } };
+    if (args.query)
+        where.name = { $regex: args.query, $options: 'i' };
+    if (args.status)
+        where.statusLabel = { $regex: args.status, $options: 'i' };
+    if (args.type)
+        where.customTypeLabel = { $regex: args.type, $options: 'i' };
+    if (args.dateFrom)
+        where.startDate = { $gte: args.dateFrom };
+    if (args.dateTo)
+        where.endDate = { $lte: args.dateTo };
+    return {
+        w: where,
+        proj: DEFAULT_PROJECT_FIELDS,
+        sort: args.sort ? { [args.sort]: 1 } : { name: 1 },
+        limit: clampLimit(args.limit, MAX_LIST_LIMIT),
+        skip: args.skip ?? 0,
+    };
+}
+const INCLUDE_MAP = {
+    tasks: { tasks: 1 },
+    risks: { risks: 1 },
+    issues: { issues: 1 },
+    purchases: { purchases: 1 },
+    revenues: { revenues: 1 },
+    budget: { budgetTopDown: 1, budgetBottomUp: 1, budgetPeriodEndClose: 1, budgetActual: 1 },
+};
+export function buildGetProjectProjection(include) {
+    const proj = { ...DEFAULT_PROJECT_FIELDS };
+    for (const inc of include) {
+        const fields = INCLUDE_MAP[inc];
+        if (fields)
+            Object.assign(proj, fields);
+    }
+    return proj;
+}
+export function registerProjectTools(server, clients) {
+    server.registerTool('search_projects', {
+        description: 'Find projects by name, status, type, or date range. Returns id, name, status, progress, dates, managers. Filterable fields: name, statusLabel, customTypeLabel, startDate, endDate.',
+        inputSchema: {
+            query: z.string().optional().describe('Search projects by name (case-insensitive regex)'),
+            status: z.string().optional().describe('Filter by status label (e.g. "In Progress", "Closed")'),
+            type: z.string().optional().describe('Filter by project type label'),
+            dateFrom: z.string().optional().describe('Filter projects starting on or after this date (ISO 8601)'),
+            dateTo: z.string().optional().describe('Filter projects ending on or before this date (ISO 8601)'),
+            sort: z.string().optional().describe('Sort field (default: "name"). Use DataMart field names.'),
+            limit: z.number().optional().describe('Max results (default 50, max 200)'),
+            skip: z.number().optional().describe('Offset for pagination'),
+        },
+    }, async (args) => {
+        const variables = buildSearchProjectsVariables(args);
+        const data = await clients.datamart.query({ query: COMPONENTS_QUERY, variables });
+        return { content: [{ type: 'text', text: JSON.stringify(data.components, null, 2) }] };
+    });
+    server.registerTool('get_project', {
+        description: 'Get full project details by ID, optionally including subcomponents (tasks, risks, issues, budget, purchases, revenues). One query returns everything requested.',
+        inputSchema: {
+            projectId: z.number().describe('The project ID'),
+            include: z.array(z.enum(['tasks', 'risks', 'issues', 'budget', 'purchases', 'revenues']))
+                .optional()
+                .describe('Subcomponents to include (default: none)'),
+        },
+    }, async (args) => {
+        const proj = buildGetProjectProjection(args.include ?? []);
+        const variables = { id: args.projectId, proj };
+        const data = await clients.datamart.query({ query: COMPONENT_QUERY, variables });
+        return { content: [{ type: 'text', text: JSON.stringify(data.component, null, 2) }] };
+    });
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

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

package/dist/tools/reference-data.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Clients } from '../clients/index.js';
+export declare function registerReferenceDataTools(server: McpServer, clients: Clients): void;
+//# sourceMappingURL=reference-data.d.ts.map

package/dist/tools/reference-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-data.d.ts","sourceRoot":"","sources":["../../src/tools/reference-data.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAUnD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,QAc7E"}

package/dist/tools/reference-data.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+const ALLOWED_ENTITIES = [
+    'projectstatuses', 'gettaskstatuses', 'gettasktypes', 'gettaskpriorities',
+    'getprojecttypes', 'projectpriorities', 'riskstatuses', 'risktypes',
+    'riskimpacts', 'riskprobabilities',
+    'issuestatuses', 'issuetypes', 'purchasestatuses', 'purchasetypes',
+    'revenuestatuses',
+];
+export function registerReferenceDataTools(server, clients) {
+    server.registerTool('get_reference_data', {
+        description: 'Get reference data lists (statuses, types, priorities, risk impact/probability) for any entity. Useful for understanding valid values when filtering or interpreting data. Available entities: projectstatuses, gettaskstatuses, gettasktypes, gettaskpriorities, getprojecttypes, projectpriorities, riskstatuses, risktypes, riskimpacts, riskprobabilities, issuestatuses, issuetypes, purchasestatuses, purchasetypes, revenuestatuses. Some risk/issue reference data includes BaseId; write tools accept either Id or BaseId and normalize when v2 REST requires BaseId.',
+        inputSchema: {
+            entity: z.enum(ALLOWED_ENTITIES).describe('The reference data entity to retrieve'),
+        },
+    }, async (args) => {
+        const data = await clients.rest.get(args.entity);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=reference-data.js.map

package/dist/tools/reference-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-data.js","sourceRoot":"","sources":["../../src/tools/reference-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,gBAAgB,GAAG;IACvB,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB;IACzE,iBAAiB,EAAE,mBAAmB,EAAE,cAAc,EAAE,WAAW;IACnE,aAAa,EAAE,mBAAmB;IAClC,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe;IAClE,iBAAiB;CACT,CAAC;AAEX,MAAM,UAAU,0BAA0B,CAAC,MAAiB,EAAE,OAAgB;IAC5E,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EAAE,gjBAAgjB;QAC7jB,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;SACnF;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/risks-issues.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Clients } from '../clients/index.js';
+export declare function registerRisksIssuesTools(server: McpServer, clients: Clients): void;
+//# sourceMappingURL=risks-issues.d.ts.map

package/dist/tools/risks-issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risks-issues.d.ts","sourceRoot":"","sources":["../../src/tools/risks-issues.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,QAsC3E"}

package/dist/tools/risks-issues.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { COMPONENT_QUERY } from './graphql-queries.js';
+export function registerRisksIssuesTools(server, clients) {
+    server.registerTool('get_project_risks', {
+        description: 'Get risks for a project. Returns an array of risk items with name, description, status, probability, impact, and mitigation plan.',
+        inputSchema: {
+            projectId: z.number().describe('The project ID'),
+        },
+    }, async (args) => {
+        const data = await clients.datamart.query({
+            query: COMPONENT_QUERY,
+            variables: { id: args.projectId, proj: { risks: 1 } },
+        });
+        const component = data.component;
+        const risks = component?.risks ?? [];
+        return { content: [{ type: 'text', text: JSON.stringify(risks, null, 2) }] };
+    });
+    server.registerTool('get_project_issues', {
+        description: 'Get issues for a project. Returns an array of issue items with name, description, status, severity, and resolution.',
+        inputSchema: {
+            projectId: z.number().describe('The project ID'),
+        },
+    }, async (args) => {
+        const data = await clients.datamart.query({
+            query: COMPONENT_QUERY,
+            variables: { id: args.projectId, proj: { issues: 1 } },
+        });
+        const component = data.component;
+        const issues = component?.issues ?? [];
+        return { content: [{ type: 'text', text: JSON.stringify(issues, null, 2) }] };
+    });
+}
+//# sourceMappingURL=risks-issues.js.map

package/dist/tools/risks-issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risks-issues.js","sourceRoot":"","sources":["../../src/tools/risks-issues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,OAAgB;IAC1E,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EAAE,mIAAmI;QAChJ,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SACjD;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACxC,KAAK,EAAE,eAAe;YACtB,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;SACtD,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,SAA2C,CAAC;QACnE,MAAM,KAAK,GAAG,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACxF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EAAE,qHAAqH;QAClI,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SACjD;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACxC,KAAK,EAAE,eAAe;YACtB,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;SACvD,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,SAA2C,CAAC;QACnE,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,IAAI,EAAE,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/services.d.ts

@@ -0,0 +1,41 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Clients } from '../clients/index.js';
+interface SearchServicesArgs {
+    query?: string;
+    status?: string;
+    type?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    sort?: string;
+    limit?: number;
+    skip?: number;
+}
+export declare function buildSearchServicesVariables(args: SearchServicesArgs): {
+    w: Record<string, unknown>;
+    proj: {
+        id: number;
+        name: number;
+        code: number;
+        componentType: number;
+        statusLabel: number;
+        priorityLabel: number;
+        percentComplete: number;
+        startDate: number;
+        endDate: number;
+        'managers.name': number;
+        'managers.userId': number;
+        methodology: number;
+        customTypeLabel: number;
+    };
+    sort: {
+        [args.sort]: number;
+        name?: undefined;
+    } | {
+        name: number;
+    };
+    limit: number;
+    skip: number;
+};
+export declare function registerServiceTools(server: McpServer, clients: Clients): void;
+export {};
+//# sourceMappingURL=services.d.ts.map

package/dist/tools/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/tools/services.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,UAAU,kBAAkB;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;QAY7C,CAAC,IAAI,CAAC,IAAI,CAAC,SAAG;;;;;;;EAIrC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,QAmDvE"}

package/dist/tools/services.js

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+import { COMPONENTS_QUERY, COMPONENT_QUERY, DEFAULT_PROJECT_FIELDS, MAX_LIST_LIMIT, clampLimit } from './graphql-queries.js';
+export function buildSearchServicesVariables(args) {
+    const where = { componentType: { $eq: 'service' } };
+    if (args.query)
+        where.name = { $regex: args.query, $options: 'i' };
+    if (args.status)
+        where.statusLabel = { $regex: args.status, $options: 'i' };
+    if (args.type)
+        where.customTypeLabel = { $regex: args.type, $options: 'i' };
+    if (args.dateFrom)
+        where.startDate = { $gte: args.dateFrom };
+    if (args.dateTo)
+        where.endDate = { $lte: args.dateTo };
+    return {
+        w: where,
+        proj: DEFAULT_PROJECT_FIELDS,
+        sort: args.sort ? { [args.sort]: 1 } : { name: 1 },
+        limit: clampLimit(args.limit, MAX_LIST_LIMIT),
+        skip: args.skip ?? 0,
+    };
+}
+export function registerServiceTools(server, clients) {
+    server.registerTool('search_services', {
+        description: 'Find services by name, status, type, or date range. Same query shape as search_projects but for services.',
+        inputSchema: {
+            query: z.string().optional().describe('Search services by name (case-insensitive regex)'),
+            status: z.string().optional().describe('Filter by status label'),
+            type: z.string().optional().describe('Filter by service type label'),
+            dateFrom: z.string().optional().describe('Filter services starting on or after this date (ISO 8601)'),
+            dateTo: z.string().optional().describe('Filter services ending on or before this date (ISO 8601)'),
+            sort: z.string().optional().describe('Sort field (default: "name")'),
+            limit: z.number().optional().describe('Max results (default 50, max 200)'),
+            skip: z.number().optional().describe('Offset for pagination'),
+        },
+    }, async (args) => {
+        const variables = buildSearchServicesVariables(args);
+        const data = await clients.datamart.query({ query: COMPONENTS_QUERY, variables });
+        return { content: [{ type: 'text', text: JSON.stringify(data.components, null, 2) }] };
+    });
+    server.registerTool('get_service', {
+        description: 'Get full service details by ID, optionally including subcomponents (activities, purchases, revenues). Note: services have activities instead of tasks, and do not have risks or issues.',
+        inputSchema: {
+            serviceId: z.number().describe('The service ID'),
+            include: z.array(z.enum(['activities', 'purchases', 'revenues', 'budget']))
+                .optional()
+                .describe('Subcomponents to include (default: none)'),
+        },
+    }, async (args) => {
+        const proj = { ...DEFAULT_PROJECT_FIELDS };
+        const includeMap = {
+            activities: { activities: 1 },
+            purchases: { purchases: 1 },
+            revenues: { revenues: 1 },
+            budget: { budgetTopDown: 1, budgetBottomUp: 1, budgetPeriodEndClose: 1, budgetActual: 1 },
+        };
+        for (const inc of args.include ?? []) {
+            const fields = includeMap[inc];
+            if (fields)
+                Object.assign(proj, fields);
+        }
+        const variables = { id: args.serviceId, proj };
+        const data = await clients.datamart.query({ query: COMPONENT_QUERY, variables });
+        return { content: [{ type: 'text', text: JSON.stringify(data.component, null, 2) }] };
+    });
+}
+//# sourceMappingURL=services.js.map

package/dist/tools/services.js.map

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

package/dist/tools/tasks.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Clients } from '../clients/index.js';
+export declare function registerTaskTools(server: McpServer, clients: Clients): void;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/tools/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,QAiBpE"}

package/dist/tools/tasks.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { COMPONENT_QUERY } from './graphql-queries.js';
+export function registerTaskTools(server, clients) {
+    server.registerTool('list_project_tasks', {
+        description: 'List all tasks for a project. Returns task details: taskId, name, statusLabel, priorityLabel, assignedTo, startDate, endDate, percentComplete.',
+        inputSchema: {
+            projectId: z.number().describe('The project ID'),
+        },
+    }, async (args) => {
+        const variables = { id: args.projectId, proj: { tasks: 1 } };
+        const data = await clients.datamart.query({ query: COMPONENT_QUERY, variables });
+        const component = data.component;
+        const tasks = (component?.tasks ?? []);
+        return { content: [{ type: 'text', text: JSON.stringify(tasks, null, 2) }] };
+    });
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tools/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,OAAgB;IACnE,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EAAE,gJAAgJ;QAC7J,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SACjD;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,CAAC;QACjF,MAAM,SAAS,GAAG,IAAI,CAAC,SAA2C,CAAC;QACnE,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAc,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACxF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/users.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Clients } from '../clients/index.js';
+export declare function registerUserTools(server: McpServer, clients: Clients): void;
+//# sourceMappingURL=users.d.ts.map

package/dist/tools/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/tools/users.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,QAoCpE"}

package/dist/tools/users.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+export function registerUserTools(server, clients) {
+    server.registerTool('search_users', {
+        description: 'Find team members by name or email. Returns userId, name, email, role. Uses v2 REST API (not DataMart).',
+        inputSchema: {
+            query: z.string().optional().describe('Search by name or email (case-insensitive)'),
+            limit: z.number().optional().describe('Max results (default 50)'),
+        },
+    }, async (args) => {
+        const body = {
+            page: 1,
+            pageSize: Math.min(args.limit ?? 50, 200),
+        };
+        if (args.query) {
+            body.Filter = { Name: { $regex: args.query } };
+        }
+        const data = await clients.rest.post('AllUsers', body);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool('get_user', {
+        description: 'Get details for a single user by ID. Returns full user profile including roles, categories, and contact info.',
+        inputSchema: {
+            userId: z.number().describe('The user ID'),
+        },
+    }, async (args) => {
+        const data = await clients.rest.get(`users/${args.userId}`);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=users.js.map

package/dist/tools/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/tools/users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,OAAgB;IACnE,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EAAE,yGAAyG;QACtH,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACnF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;SAClE;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAA4B;YACpC,IAAI,EAAE,CAAC;YACP,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC;SAC1C,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACjD,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACvD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,WAAW,EAAE,+GAA+G;QAC5H,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;SAC3C;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/write-tools.d.ts

@@ -0,0 +1,74 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Clients } from '../clients/index.js';
+import { type EffectiveUserContext } from '../auth/effective-user-context.js';
+type JsonRecord = Record<string, unknown>;
+export declare const STALE_AFTER_WRITE_NOTICE: string;
+export declare function buildInsufficientScopeResponse(): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: true;
+};
+export declare function buildWriteResponse(data: unknown): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+export declare function splitCreateTaskArgs(args: {
+    projectId: number;
+    [key: string]: unknown;
+}): {
+    path: string;
+    body: {
+        [key: string]: unknown;
+    };
+};
+export declare function splitUpdateTaskArgs(args: {
+    projectId: number;
+    taskId: number;
+    [key: string]: unknown;
+}): {
+    path: string;
+    body: {
+        [key: string]: unknown;
+    };
+};
+export declare function splitCreateRiskArgs(args: {
+    projectId: number;
+    [key: string]: unknown;
+}): {
+    path: string;
+    body: {
+        [key: string]: unknown;
+    };
+};
+export declare function splitCreateIssueArgs(args: {
+    projectId: number;
+    [key: string]: unknown;
+}): {
+    path: string;
+    body: {
+        [key: string]: unknown;
+    };
+};
+export declare function splitUpdateProjectArgs(args: {
+    projectId: number;
+    [key: string]: unknown;
+}): {
+    path: string;
+    body: {
+        [key: string]: unknown;
+    };
+};
+export interface VerificationField {
+    requestField: string;
+    readPaths: string[];
+    label?: string;
+}
+export declare function verifyRequestedFields(requested: JsonRecord, readback: unknown, fields: VerificationField[], entityLabel: string): void;
+export declare function mapReferenceIdToBaseId(value: unknown, referenceData: unknown): unknown;
+export declare function registerWriteTools(server: McpServer, clients: Clients, effectiveUserContext?: EffectiveUserContext): void;
+export {};
+//# sourceMappingURL=write-tools.d.ts.map

package/dist/tools/write-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-tools.d.ts","sourceRoot":"","sources":["../../src/tools/write-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAY,KAAK,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAExF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,eAAO,MAAM,wBAAwB,QAGmC,CAAC;AAEzE,wBAAgB,8BAA8B,IAAI;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAKlH;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAOpG;AAoED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;;;;;EAQtF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;;;;;EAQtG;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;;;;;EAWtF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;;;;;EASvF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;;;;;EAIzF;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,UAAU,EACrB,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,iBAAiB,EAAE,EAC3B,WAAW,EAAE,MAAM,GAClB,IAAI,CAwBN;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CActF;AA8DD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,OAAO,EAChB,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,IAAI,CA6IN"}