@itm-platform/mcp-server 1.0.0

package/dist/src/tools/write-tools.js

@@ -0,0 +1,193 @@
+import { z } from 'zod';
+import { hashParameters } from '../clients/audit-client.js';
+import { createLogger } from '../logger.js';
+import { hasScope } from '../auth/effective-user-context.js';
+export const STALE_AFTER_WRITE_NOTICE = 'Note: DataMart reads (search_projects, get_project, list_project_tasks, etc.) ' +
+    'may return stale data for 5-60 seconds after a write due to eventual consistency. ' +
+    'The confirmed state above is from the v2 REST API (source of truth).';
+export function buildInsufficientScopeResponse() {
+    return {
+        content: [{ type: 'text', text: 'Error: insufficient_scope -- the mcp:write scope is required for write operations' }],
+        isError: true,
+    };
+}
+export function buildWriteResponse(data) {
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(data, null, 2) },
+            { type: 'text', text: STALE_AFTER_WRITE_NOTICE },
+        ],
+    };
+}
+export async function auditWrap(clients, toolName, args, userContext, operation) {
+    const start = Date.now();
+    try {
+        const result = await operation();
+        try {
+            await clients.audit.log({
+                timestamp: new Date().toISOString(),
+                userId: userContext.userId,
+                accountId: userContext.accountId,
+                toolName,
+                parametersHash: hashParameters(args),
+                success: true,
+                aiClientId: userContext.aiClientId,
+                durationMs: Date.now() - start,
+            });
+        }
+        catch {
+            // fire-and-forget: audit failure must not break writes
+        }
+        return result;
+    }
+    catch (err) {
+        try {
+            await clients.audit.log({
+                timestamp: new Date().toISOString(),
+                userId: userContext.userId,
+                accountId: userContext.accountId,
+                toolName,
+                parametersHash: hashParameters(args),
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+                aiClientId: userContext.aiClientId,
+                durationMs: Date.now() - start,
+            });
+        }
+        catch {
+            // fire-and-forget
+        }
+        throw err;
+    }
+}
+export function splitCreateTaskArgs(args) {
+    const { projectId, ...body } = args;
+    return { path: `projects/${projectId}/tasks`, body };
+}
+export function splitUpdateTaskArgs(args) {
+    const { projectId, taskId, ...body } = args;
+    return { path: `projects/${projectId}/tasks/${taskId}`, body };
+}
+export function splitCreateRiskArgs(args) {
+    const { projectId, ...body } = args;
+    return { path: `projects/${projectId}/risks`, body };
+}
+export function splitCreateIssueArgs(args) {
+    const { projectId, ...body } = args;
+    return { path: `projects/${projectId}/issues`, body };
+}
+export function splitUpdateProjectArgs(args) {
+    const { projectId, ...body } = args;
+    return { path: `projects/${projectId}`, body };
+}
+export function registerWriteTools(server, clients, userContext, log, effectiveUserContext) {
+    const l = log ?? createLogger('write-tools');
+    server.registerTool('create_task', {
+        description: 'Create a new task in a project. Returns the created task from v2 REST (source of truth). Use get_reference_data with entity "gettaskstatuses", "gettasktypes", or "gettaskpriorities" to discover valid IDs.',
+        inputSchema: {
+            projectId: z.number().describe('The project ID to create the task in'),
+            Name: z.string().describe('Task name (required)'),
+            Description: z.string().optional().describe('Task description'),
+            StatusId: z.number().optional().describe('Task status ID'),
+            TypeId: z.number().optional().describe('Task type ID'),
+            PriorityId: z.number().optional().describe('Task priority ID'),
+            StartDate: z.string().optional().describe('Start date (ISO 8601)'),
+            EndDate: z.string().optional().describe('End date (ISO 8601)'),
+            AssignedToUserId: z.number().optional().describe('User ID to assign the task to'),
+        },
+    }, async (args) => {
+        if (effectiveUserContext && !hasScope(effectiveUserContext, 'mcp:write'))
+            return buildInsufficientScopeResponse();
+        const { path, body } = splitCreateTaskArgs(args);
+        l.info({ tool: 'create_task', projectId: args.projectId }, 'Write tool invoked');
+        const data = await auditWrap(clients, 'create_task', args, userContext, () => clients.rest.post(path, body));
+        l.debug({ tool: 'create_task', projectId: args.projectId }, 'Write tool completed');
+        return buildWriteResponse(data);
+    });
+    server.registerTool('update_task', {
+        description: 'Update task fields (status, dates, assignee, progress, etc.) via PATCH. Only send the fields you want to change. Returns the updated task from v2 REST.',
+        inputSchema: {
+            projectId: z.number().describe('The project ID containing the task'),
+            taskId: z.number().describe('The task ID to update'),
+            Name: z.string().optional().describe('New task name'),
+            Description: z.string().optional().describe('New description'),
+            StatusId: z.number().optional().describe('New status ID'),
+            TypeId: z.number().optional().describe('New type ID'),
+            PriorityId: z.number().optional().describe('New priority ID'),
+            StartDate: z.string().optional().describe('New start date (ISO 8601)'),
+            EndDate: z.string().optional().describe('New end date (ISO 8601)'),
+            PercentComplete: z.number().min(0).max(100).optional().describe('Completion percentage (0-100)'),
+            AssignedToUserId: z.number().optional().describe('User ID to reassign to'),
+        },
+    }, async (args) => {
+        if (effectiveUserContext && !hasScope(effectiveUserContext, 'mcp:write'))
+            return buildInsufficientScopeResponse();
+        const { path, body } = splitUpdateTaskArgs(args);
+        l.info({ tool: 'update_task', projectId: args.projectId, taskId: args.taskId }, 'Write tool invoked');
+        const data = await auditWrap(clients, 'update_task', args, userContext, () => clients.rest.patch(path, body));
+        l.debug({ tool: 'update_task', projectId: args.projectId, taskId: args.taskId }, 'Write tool completed');
+        return buildWriteResponse(data);
+    });
+    server.registerTool('create_risk', {
+        description: 'Log a new risk in a project. Returns the created risk from v2 REST. Use get_reference_data with entity "riskstatuses" or "risktypes" to discover valid IDs.',
+        inputSchema: {
+            projectId: z.number().describe('The project ID to create the risk in'),
+            Name: z.string().describe('Risk name (required)'),
+            Description: z.string().optional().describe('Risk description'),
+            StatusId: z.number().optional().describe('Risk status ID'),
+            TypeId: z.number().optional().describe('Risk type ID'),
+            Probability: z.number().optional().describe('Probability level'),
+            Impact: z.number().optional().describe('Impact level'),
+            MitigationPlan: z.string().optional().describe('Mitigation plan description'),
+        },
+    }, async (args) => {
+        if (effectiveUserContext && !hasScope(effectiveUserContext, 'mcp:write'))
+            return buildInsufficientScopeResponse();
+        const { path, body } = splitCreateRiskArgs(args);
+        l.info({ tool: 'create_risk', projectId: args.projectId }, 'Write tool invoked');
+        const data = await auditWrap(clients, 'create_risk', args, userContext, () => clients.rest.post(path, body));
+        l.debug({ tool: 'create_risk', projectId: args.projectId }, 'Write tool completed');
+        return buildWriteResponse(data);
+    });
+    server.registerTool('create_issue', {
+        description: 'Log a new issue in a project. Returns the created issue from v2 REST. Use get_reference_data with entity "issuestatuses" or "issuetypes" to discover valid IDs.',
+        inputSchema: {
+            projectId: z.number().describe('The project ID to create the issue in'),
+            Name: z.string().describe('Issue name (required)'),
+            Description: z.string().optional().describe('Issue description'),
+            StatusId: z.number().optional().describe('Issue status ID'),
+            TypeId: z.number().optional().describe('Issue type ID'),
+            Severity: z.number().optional().describe('Severity level'),
+            Resolution: z.string().optional().describe('Resolution description'),
+        },
+    }, async (args) => {
+        if (effectiveUserContext && !hasScope(effectiveUserContext, 'mcp:write'))
+            return buildInsufficientScopeResponse();
+        const { path, body } = splitCreateIssueArgs(args);
+        l.info({ tool: 'create_issue', projectId: args.projectId }, 'Write tool invoked');
+        const data = await auditWrap(clients, 'create_issue', args, userContext, () => clients.rest.post(path, body));
+        l.debug({ tool: 'create_issue', projectId: args.projectId }, 'Write tool completed');
+        return buildWriteResponse(data);
+    });
+    server.registerTool('update_project', {
+        description: 'Update project fields (name, status, dates, priority, etc.) via PATCH. Only send the fields you want to change. Returns the updated project from v2 REST.',
+        inputSchema: {
+            projectId: z.number().describe('The project ID to update'),
+            Name: z.string().optional().describe('New project name'),
+            Description: z.string().optional().describe('New project description'),
+            StatusId: z.number().optional().describe('New project status ID'),
+            PriorityId: z.number().optional().describe('New priority ID'),
+            StartDate: z.string().optional().describe('New start date (ISO 8601)'),
+            EndDate: z.string().optional().describe('New end date (ISO 8601)'),
+        },
+    }, async (args) => {
+        if (effectiveUserContext && !hasScope(effectiveUserContext, 'mcp:write'))
+            return buildInsufficientScopeResponse();
+        const { path, body } = splitUpdateProjectArgs(args);
+        l.info({ tool: 'update_project', projectId: args.projectId }, 'Write tool invoked');
+        const data = await auditWrap(clients, 'update_project', args, userContext, () => clients.rest.patch(path, body));
+        l.debug({ tool: 'update_project', projectId: args.projectId }, 'Write tool completed');
+        return buildWriteResponse(data);
+    });
+}
+//# sourceMappingURL=write-tools.js.map

package/dist/src/tools/write-tools.js.map

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

package/dist/src/validation/query-validator.d.ts

@@ -0,0 +1,15 @@
+export interface ValidationResult {
+    ok: boolean;
+    error?: {
+        code: string;
+        message: string;
+    };
+    warning?: string;
+}
+interface DataMartBody {
+    query?: string;
+    variables?: Record<string, unknown>;
+}
+export declare function validateDataMartQuery(body: DataMartBody | null | undefined): ValidationResult;
+export {};
+//# sourceMappingURL=query-validator.d.ts.map

package/dist/src/validation/query-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-validator.d.ts","sourceRoot":"","sources":["../../../src/validation/query-validator.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAiGD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,CA8C7F"}

package/dist/src/validation/query-validator.js

@@ -0,0 +1,141 @@
+// SYNC: Ported from ITM.PMPilot (inference/datamart/validators.js).
+//       If you change the allowed operators or aggregation stages here, update the PMPilot copy too.
+//
+// Differences from PMPilot's copy:
+//   - TypeScript types
+//   - Adds $not to ALLOWED_WHERE_OPERATORS (allowed by DataMart's validate.ts)
+const ALLOWED_WHERE_OPERATORS = new Set([
+    '$eq', '$ne', '$in', '$nin', '$gt', '$gte', '$lt', '$lte',
+    '$regex', '$options', '$exists', '$not', '$and', '$or', '$nor',
+]);
+const ALLOWED_AGG_STAGES = new Set([
+    '$match', '$project', '$group', '$sort', '$limit', '$skip',
+    '$unwind', '$addFields', '$set', '$unset',
+]);
+function isAggregateQuery(query) {
+    return /\baggregateComponents\s*\(/.test(query);
+}
+function isListQuery(query) {
+    return /\bcomponents\s*\(/.test(query) && !isAggregateQuery(query);
+}
+function selectsJsonSubfields(query) {
+    return /\bcomponent\s*\{/.test(query)
+        || /\bcomponents\s*\{/.test(query)
+        || /\baggregateComponents\s*\{/.test(query);
+}
+function pipelineHasFacet(p) {
+    return p.some(st => st && typeof st === 'object' && Object.prototype.hasOwnProperty.call(st, '$facet'));
+}
+function validateWhereObject(whereObj, path = '$') {
+    if (whereObj == null || typeof whereObj !== 'object')
+        return { ok: true };
+    for (const [key, value] of Object.entries(whereObj)) {
+        if (key.startsWith('$')) {
+            if (!ALLOWED_WHERE_OPERATORS.has(key)) {
+                return { ok: false, error: { code: 'CLIENT_VALIDATION', message: `Disallowed operator ${key} at ${path}` } };
+            }
+            if (key === '$and' || key === '$or' || key === '$nor') {
+                if (Array.isArray(value)) {
+                    for (let i = 0; i < value.length; i++) {
+                        const res = validateWhereObject(value[i], `${path}.${key}[${i}]`);
+                        if (!res.ok)
+                            return res;
+                    }
+                }
+                continue;
+            }
+            // $not wraps a single condition object
+            if (key === '$not') {
+                if (value && typeof value === 'object') {
+                    const res = validateWhereObject(value, `${path}.${key}`);
+                    if (!res.ok)
+                        return res;
+                }
+                continue;
+            }
+        }
+        if (value && typeof value === 'object') {
+            const res = validateWhereObject(value, `${path}.${key}`);
+            if (!res.ok)
+                return res;
+        }
+    }
+    return { ok: true };
+}
+function validatePipeline(pipeline) {
+    if (!Array.isArray(pipeline)) {
+        return { ok: false, error: { code: 'CLIENT_VALIDATION', message: 'Aggregation pipeline must be an array' } };
+    }
+    if (pipeline.length === 0) {
+        return { ok: false, error: { code: 'CLIENT_VALIDATION', message: 'Aggregation pipeline must include a final $limit stage' } };
+    }
+    for (let i = 0; i < pipeline.length; i++) {
+        const stage = pipeline[i];
+        const keys = stage && typeof stage === 'object' ? Object.keys(stage) : [];
+        if (keys.length !== 1) {
+            return { ok: false, error: { code: 'CLIENT_VALIDATION', message: `Aggregation stage at index ${i} must have exactly one key` } };
+        }
+        if (!ALLOWED_AGG_STAGES.has(keys[0])) {
+            return { ok: false, error: { code: 'CLIENT_VALIDATION', message: `Forbidden stage ${keys[0]} at index ${i}` } };
+        }
+    }
+    const last = pipeline[pipeline.length - 1];
+    const lastKey = last && typeof last === 'object' ? Object.keys(last)[0] : null;
+    if (lastKey !== '$limit') {
+        return { ok: false, error: { code: 'CLIENT_VALIDATION', message: 'Aggregation must end with a final $limit stage' } };
+    }
+    const limitVal = last['$limit'];
+    if (typeof limitVal !== 'number' || !Number.isFinite(limitVal) || limitVal <= 0) {
+        return { ok: false, error: { code: 'CLIENT_VALIDATION', message: 'Final $limit must be a positive number' } };
+    }
+    if (limitVal > 1000) {
+        return { ok: false, error: { code: 'CLIENT_VALIDATION', message: 'Final $limit must be ≤ 1000' } };
+    }
+    return { ok: true };
+}
+export function validateDataMartQuery(body) {
+    if (!body || typeof body !== 'object')
+        return { ok: true };
+    const query = body.query ?? '';
+    const variables = (body.variables ?? {});
+    if (selectsJsonSubfields(query)) {
+        return { ok: false, error: { code: 'CLIENT_VALIDATION', message: 'Do not select subfields of JSON; project fields via variables (proj / w / p) instead.' } };
+    }
+    if (isAggregateQuery(query)) {
+        const pipeline = variables.p ?? variables.pipeline;
+        const res = validatePipeline(pipeline);
+        if (!res.ok)
+            return res;
+        if (pipelineHasFacet(pipeline)) {
+            return {
+                ok: false,
+                error: {
+                    code: 'CLIENT_VALIDATION',
+                    message: 'Forbidden stage $facet. For totals use components(where...).total with limit=1, or run separate $count pipelines.',
+                },
+            };
+        }
+        return { ok: true };
+    }
+    if (isListQuery(query)) {
+        const limit = variables.limit;
+        if (typeof limit === 'number' && limit > 100) {
+            return { ok: true, warning: 'High limit requested (>100). Server may clamp to 200.' };
+        }
+        const whereObj = variables.w ?? variables.where;
+        if (whereObj) {
+            const res = validateWhereObject(whereObj, '$.w');
+            if (!res.ok)
+                return res;
+        }
+        return { ok: true };
+    }
+    const genericWhere = variables.w ?? variables.where;
+    if (genericWhere) {
+        const res = validateWhereObject(genericWhere, '$.w');
+        if (!res.ok)
+            return res;
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=query-validator.js.map

package/dist/src/validation/query-validator.js.map

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

package/dist/startup-mode.d.ts

@@ -0,0 +1,13 @@
+import type { OAuthConfig } from './auth/oauth-auth.js';
+export type StartupMode = {
+    mode: 'stdio';
+} | {
+    mode: 'http-dev';
+    port: number;
+} | {
+    mode: 'http-oauth';
+    port: number;
+    oauthConfig: OAuthConfig;
+};
+export declare function resolveStartupMode(env: Record<string, string | undefined>, argv: string[]): StartupMode;
+//# sourceMappingURL=startup-mode.d.ts.map

package/dist/startup-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-mode.d.ts","sourceRoot":"","sources":["../src/startup-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC;AAEnE,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,IAAI,EAAE,MAAM,EAAE,GACb,WAAW,CAiBb"}

package/dist/startup-mode.js

@@ -0,0 +1,17 @@
+export function resolveStartupMode(env, argv) {
+    const useHttp = env.PORT || argv.includes('--http');
+    if (!useHttp)
+        return { mode: 'stdio' };
+    const port = parseInt(env.PORT ?? '0', 10);
+    const authUrl = env.ITM_AUTH_URL;
+    const audience = env.MCP_SERVER_URL;
+    if (authUrl && audience) {
+        return {
+            mode: 'http-oauth',
+            port,
+            oauthConfig: { tokenExchangeUrl: `${authUrl}/auth/exchange-token`, audience },
+        };
+    }
+    return { mode: 'http-dev', port };
+}
+//# sourceMappingURL=startup-mode.js.map

package/dist/startup-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-mode.js","sourceRoot":"","sources":["../src/startup-mode.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,kBAAkB,CAChC,GAAuC,EACvC,IAAc;IAEd,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC;IACjC,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,CAAC;IAEpC,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACxB,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,IAAI;YACJ,WAAW,EAAE,EAAE,gBAAgB,EAAE,GAAG,OAAO,sBAAsB,EAAE,QAAQ,EAAE;SAC9E,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC"}

package/dist/tools/datamart.d.ts

@@ -0,0 +1,17 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Clients } from '../clients/index.js';
+export declare function buildDataMartQueryBody(args: {
+    operation: string;
+    id?: number;
+    where?: Record<string, unknown>;
+    project?: Record<string, unknown>;
+    sort?: Record<string, unknown>;
+    limit?: number;
+    skip?: number;
+    pipeline?: Record<string, unknown>[];
+}): {
+    query: string;
+    variables: Record<string, unknown>;
+};
+export declare function registerDataMartTool(server: McpServer, clients: Clients): void;
+//# sourceMappingURL=datamart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datamart.d.ts","sourceRoot":"","sources":["../../src/tools/datamart.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAUnD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACtC;;;EAkBA;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,QA0CvE"}

package/dist/tools/datamart.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { COMPONENTS_QUERY, COMPONENT_QUERY, AGGREGATE_QUERY, MAX_LIST_LIMIT, clampLimit } from './graphql-queries.js';
+import { validateDataMartQuery } from '../validation/query-validator.js';
+const QUERY_MAP = {
+    component: COMPONENT_QUERY,
+    components: COMPONENTS_QUERY,
+    aggregateComponents: AGGREGATE_QUERY,
+};
+export function buildDataMartQueryBody(args) {
+    const query = QUERY_MAP[args.operation] ?? COMPONENTS_QUERY;
+    const variables = {};
+    if (args.operation === 'component') {
+        variables.id = args.id;
+        variables.proj = args.project;
+    }
+    else if (args.operation === 'aggregateComponents') {
+        variables.p = args.pipeline;
+    }
+    else {
+        if (args.where)
+            variables.w = args.where;
+        if (args.project)
+            variables.proj = args.project;
+        if (args.sort)
+            variables.sort = args.sort;
+        variables.limit = clampLimit(args.limit, MAX_LIST_LIMIT);
+        variables.skip = args.skip ?? 0;
+    }
+    return { query, variables };
+}
+export function registerDataMartTool(server, clients) {
+    server.registerTool('query_datamart', {
+        description: `Run a custom query against ITM DataMart (MongoDB-backed). For advanced analysis beyond typed tools.
+
+Operations:
+- "components": list with filters. Params: where, project, sort, limit (max 200), skip
+- "component": single by ID. Params: id, project
+- "aggregateComponents": aggregation pipeline. Params: pipeline (must end with $limit, max 1000)
+
+Allowed filter operators: $eq, $ne, $in, $nin, $gt, $gte, $lt, $lte, $regex, $options, $exists, $not, $and, $or, $nor
+Allowed pipeline stages: $match, $project, $group, $sort, $limit, $skip, $unwind, $addFields, $set, $unset
+Banned: $lookup, $merge, $out, $function, $accumulator, $where, $facet
+
+Key fields: id, name, code, componentType, statusLabel, priorityLabel, percentComplete, startDate, endDate, methodology, managers, tasks, risks, issues, purchases, revenues, budgetTopDown, budgetActual.`,
+        inputSchema: {
+            operation: z.enum(['component', 'components', 'aggregateComponents']).describe('The DataMart operation'),
+            id: z.number().optional().describe('Component ID (for "component" operation)'),
+            where: z.record(z.unknown()).optional().describe('MongoDB filter (for "components")'),
+            project: z.record(z.unknown()).optional().describe('Field projection (1 = include)'),
+            sort: z.record(z.unknown()).optional().describe('Sort spec (1 = ascending, -1 = descending)'),
+            limit: z.number().optional().describe('Max results (default 50, max 200 for list, 1000 for agg)'),
+            skip: z.number().optional().describe('Offset for pagination'),
+            pipeline: z.array(z.record(z.unknown())).optional().describe('Aggregation pipeline stages (must end with $limit)'),
+        },
+    }, async (args) => {
+        const body = buildDataMartQueryBody(args);
+        const validation = validateDataMartQuery({ query: body.query, variables: body.variables });
+        if (!validation.ok) {
+            return {
+                content: [{ type: 'text', text: `Validation error: ${validation.error?.message}` }],
+                isError: true,
+            };
+        }
+        const data = await clients.datamart.query(body);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=datamart.js.map

package/dist/tools/datamart.js.map

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

package/dist/tools/financials.d.ts

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

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

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

package/dist/tools/financials.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { COMPONENT_QUERY } from './graphql-queries.js';
+export function registerFinancialTools(server, clients) {
+    server.registerTool('get_project_budget', {
+        description: 'Get budget summary for a project. Returns four budget objects: budgetTopDown (planned), budgetBottomUp (estimated), budgetPeriodEndClose (forecast), budgetActual (spent).',
+        inputSchema: {
+            projectId: z.number().describe('The project ID'),
+        },
+    }, async (args) => {
+        const proj = { budgetTopDown: 1, budgetBottomUp: 1, budgetPeriodEndClose: 1, budgetActual: 1 };
+        const data = await clients.datamart.query({ query: COMPONENT_QUERY, variables: { id: args.projectId, proj } });
+        const component = data.component;
+        const budget = {
+            budgetTopDown: component?.budgetTopDown ?? null,
+            budgetBottomUp: component?.budgetBottomUp ?? null,
+            budgetPeriodEndClose: component?.budgetPeriodEndClose ?? null,
+            budgetActual: component?.budgetActual ?? null,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(budget, null, 2) }] };
+    });
+    server.registerTool('get_project_purchases', {
+        description: 'Get purchase orders for a project. Returns an array of purchase items with amount, status, dates, and provider.',
+        inputSchema: {
+            projectId: z.number().describe('The project ID'),
+        },
+    }, async (args) => {
+        const data = await clients.datamart.query({
+            query: COMPONENT_QUERY,
+            variables: { id: args.projectId, proj: { purchases: 1 } },
+        });
+        const component = data.component;
+        const purchases = component?.purchases ?? [];
+        return { content: [{ type: 'text', text: JSON.stringify(purchases, null, 2) }] };
+    });
+    server.registerTool('get_project_revenues', {
+        description: 'Get revenue items for a project. Returns an array of revenue entries with amount, status, and dates.',
+        inputSchema: {
+            projectId: z.number().describe('The project ID'),
+        },
+    }, async (args) => {
+        const data = await clients.datamart.query({
+            query: COMPONENT_QUERY,
+            variables: { id: args.projectId, proj: { revenues: 1 } },
+        });
+        const component = data.component;
+        const revenues = component?.revenues ?? [];
+        return { content: [{ type: 'text', text: JSON.stringify(revenues, null, 2) }] };
+    });
+}
+//# sourceMappingURL=financials.js.map

package/dist/tools/financials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"financials.js","sourceRoot":"","sources":["../../src/tools/financials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,OAAgB;IACxE,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EAAE,4KAA4K;QACzL,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,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/G,MAAM,SAAS,GAAG,IAAI,CAAC,SAA2C,CAAC;QACnE,MAAM,MAAM,GAAG;YACb,aAAa,EAAE,SAAS,EAAE,aAAa,IAAI,IAAI;YAC/C,cAAc,EAAE,SAAS,EAAE,cAAc,IAAI,IAAI;YACjD,oBAAoB,EAAE,SAAS,EAAE,oBAAoB,IAAI,IAAI;YAC7D,YAAY,EAAE,SAAS,EAAE,YAAY,IAAI,IAAI;SAC9C,CAAC;QACF,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;IAEF,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EAAE,iHAAiH;QAC9H,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,SAAS,EAAE,CAAC,EAAE,EAAE;SAC1D,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,SAA2C,CAAC;QACnE,MAAM,SAAS,GAAG,SAAS,EAAE,SAAS,IAAI,EAAE,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC5F,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EAAE,sGAAsG;QACnH,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,QAAQ,EAAE,CAAC,EAAE,EAAE;SACzD,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,SAA2C,CAAC;QACnE,MAAM,QAAQ,GAAG,SAAS,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC3C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3F,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/graphql-queries.d.ts

@@ -0,0 +1,22 @@
+export declare const COMPONENTS_QUERY = "query($w: JSON, $proj: JSON, $sort: JSON, $limit: Int, $skip: Int) {\n  components(where: $w, project: $proj, sort: $sort, limit: $limit, skip: $skip) {\n    items total limit skip\n  }\n}";
+export declare const COMPONENT_QUERY = "query($id: ID!, $proj: JSON) {\n  component(id: $id, project: $proj)\n}";
+export declare const AGGREGATE_QUERY = "query($p: JSON!) {\n  aggregateComponents(pipeline: $p)\n}";
+export declare const DEFAULT_PROJECT_FIELDS: {
+    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;
+};
+export declare const MAX_LIST_LIMIT = 200;
+export declare const MAX_AGG_LIMIT = 1000;
+export declare function clampLimit(limit: number | undefined, max: number): number;
+//# sourceMappingURL=graphql-queries.d.ts.map

package/dist/tools/graphql-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-queries.d.ts","sourceRoot":"","sources":["../../src/tools/graphql-queries.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,iMAI3B,CAAC;AAEH,eAAO,MAAM,eAAe,4EAE1B,CAAC;AAEH,eAAO,MAAM,eAAe,+DAE1B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;CAMlC,CAAC;AAEF,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGzE"}