Microsoft 365 Core MCP Server

Instructions

Implementation Reference

• src/handlers/compliance-handler.ts:162-199 (handler)

  The core handler function that implements the manage_compliance_monitoring tool. It processes input arguments, dispatches to appropriate helper functions based on action (get_status, get_alerts, get_trends, configure_monitoring), and returns formatted results.

  export async function handleComplianceMonitoring(
    graphClient: Client,
    args: ComplianceMonitoringArgs
  ): Promise<{ content: { type: string; text: string }[] }> {
    let result: any;
  
    switch (args.action) {
      case 'get_status':
        // Get overall compliance status
        result = await getComplianceStatus(graphClient, args.framework, args.filters);
        break;
  
      case 'get_alerts':
        // Get compliance alerts
        result = await getComplianceAlerts(graphClient, args.framework, args.filters);
        break;
  
      case 'get_trends':
        // Get compliance trends
        result = await getComplianceTrends(graphClient, args.framework, args.filters);
        break;
  
      case 'configure_monitoring':
        // Configure monitoring settings
        result = {
          framework: args.framework,
          monitoringSettings: args.monitoringSettings,
          status: 'configured',
          message: 'Monitoring configured successfully'
        };
        break;
  
      default:
        throw new McpError(ErrorCode.InvalidParams, `Invalid action: ${args.action}`);
    }
  
    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
  }

• src/types/compliance-types.ts:265-270 (schema)

  TypeScript interface defining the input schema for the manage_compliance_monitoring tool, including action types and optional parameters.

  export interface ComplianceMonitoringArgs {
    action: 'get_status' | 'get_alerts' | 'get_trends' | 'configure_monitoring';
    framework?: 'hitrust' | 'iso27001' | 'soc2';
    filters?: Record<string, unknown>;
    monitoringSettings?: Record<string, unknown>;
  }

• src/tool-metadata.ts:181-184 (schema)

  Tool metadata providing description, title, and behavioral annotations (read-only, non-destructive, idempotent) for the manage_compliance_monitoring tool.

  manage_compliance_monitoring: {
    description: "Monitor ongoing compliance status with real-time alerts for policy violations and regulatory changes.",
    title: "Compliance Monitor",
    annotations: { title: "Compliance Monitor", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }

• src/handlers.ts:47-60 (registration)

  Import statement registering the handleComplianceMonitoring handler function for use in the MCP tool server.

  import {
    handleComplianceFrameworks,
    handleComplianceAssessments,
    handleComplianceMonitoring,
    handleEvidenceCollection,
    handleGapAnalysis
  } from './handlers/compliance-handler.js';
  import {
    ComplianceFrameworkArgs,
    ComplianceAssessmentArgs,
    ComplianceMonitoringArgs,
    EvidenceCollectionArgs,
    GapAnalysisArgs
  } from './types/compliance-types.js';

• src/handlers/compliance-handler.ts:360-371 (helper)

  Helper function called by the handler to retrieve current compliance status data.

  async function getComplianceStatus(graphClient: Client, framework?: string, filters?: any) {
    // Get current compliance status
    return {
      framework,
      overallScore: 85,
      riskLevel: 'medium',
      lastAssessmentDate: new Date().toISOString(),
      nextAssessmentDate: new Date(Date.now() + 30 * 24 * 3600000).toISOString(), // 30 days
      activeAlerts: [],
      trends: []
    };
  }