@softeria/ms-365-mcp-server 0.124.1 → 0.125.0

package/bin/generate-graph-client.mjs

@@ -2,7 +2,7 @@
 
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { downloadGraphOpenAPI } from './modules/download-openapi.mjs';
+import { downloadGraphOpenAPI, BETA_OPENAPI_URL } from './modules/download-openapi.mjs';
 import { generateMcpTools } from './modules/generate-mcp-tools.mjs';
 import { createAndSaveSimplifiedOpenAPI } from './modules/simplified-openapi.mjs';
 
@@ -12,12 +12,29 @@ const rootDir = path.resolve(__dirname, '..');
 const openapiDir = path.join(rootDir, 'openapi');
 const srcDir = path.join(rootDir, 'src');
 
-const openapiFile = path.join(openapiDir, 'openapi.yaml');
-const openapiTrimmedFile = path.join(openapiDir, 'openapi-trimmed.yaml');
 const endpointsFile = path.join(srcDir, 'endpoints.json');
-
 const generatedDir = path.join(srcDir, 'generated');
 
+// One generation target per Graph API version. Each downloads its own spec, trims it
+// against the endpoints declaring that version, and emits its own client module. The
+// runtime selects the URL prefix per endpoint, so the clients stay independent.
+const targets = [
+  {
+    version: 'v1.0',
+    url: undefined, // download-openapi defaults to the v1.0 spec
+    specFile: path.join(openapiDir, 'openapi.yaml'),
+    trimmedFile: path.join(openapiDir, 'openapi-trimmed.yaml'),
+    clientFile: path.join(generatedDir, 'client.ts'),
+  },
+  {
+    version: 'beta',
+    url: BETA_OPENAPI_URL,
+    specFile: path.join(openapiDir, 'openapi-beta.yaml'),
+    trimmedFile: path.join(openapiDir, 'openapi-trimmed-beta.yaml'),
+    clientFile: path.join(generatedDir, 'client-beta.ts'),
+  },
+];
+
 const args = process.argv.slice(2);
 const forceDownload = args.includes('--force');
 
@@ -26,27 +43,31 @@ async function main() {
   console.log('------------------------------------');
 
   try {
-    console.log('\n📥 Step 1: Downloading OpenAPI specification');
-    const downloaded = await downloadGraphOpenAPI(
-      openapiDir,
-      openapiFile,
-      undefined,
-      forceDownload
-    );
-
-    if (downloaded) {
-      console.log('\n✅ OpenAPI specification successfully downloaded');
-    } else {
-      console.log('\n⏭️ Download skipped (file exists)');
-    }
+    for (const target of targets) {
+      console.log(`\n=== Graph ${target.version} ===`);
 
-    console.log('\n🔧 Step 2: Creating simplified OpenAPI specification');
-    createAndSaveSimplifiedOpenAPI(endpointsFile, openapiFile, openapiTrimmedFile);
-    console.log('✅ Successfully created simplified OpenAPI specification');
+      console.log(`📥 Step 1: Downloading ${target.version} OpenAPI specification`);
+      const downloaded = await downloadGraphOpenAPI(
+        openapiDir,
+        target.specFile,
+        target.url,
+        forceDownload
+      );
+      console.log(downloaded ? '✅ Downloaded' : '⏭️ Download skipped (file exists)');
 
-    console.log('\n🚀 Step 3: Generating client code using openapi-zod-client');
-    generateMcpTools(null, generatedDir);
-    console.log('✅ Successfully generated client code');
+      console.log('🔧 Step 2: Creating simplified OpenAPI specification');
+      createAndSaveSimplifiedOpenAPI(
+        endpointsFile,
+        target.specFile,
+        target.trimmedFile,
+        target.version
+      );
+      console.log('✅ Successfully created simplified OpenAPI specification');
+
+      console.log('🚀 Step 3: Generating client code using openapi-zod-client');
+      generateMcpTools(target.trimmedFile, target.clientFile);
+      console.log('✅ Successfully generated client code');
+    }
   } catch (error) {
     console.error('\n❌ Error processing OpenAPI specification:', error.message);
     process.exit(1);

package/bin/modules/download-openapi.mjs

@@ -3,6 +3,11 @@ import fs from 'fs';
 const DEFAULT_OPENAPI_URL =
   'https://raw.githubusercontent.com/microsoftgraph/msgraph-metadata/refs/heads/master/openapi/v1.0/openapi.yaml';
 
+// Microsoft publishes a parallel /beta OpenAPI spec at the same path root. Endpoints
+// flagged "apiVersion": "beta" in endpoints.json are generated from this spec instead.
+export const BETA_OPENAPI_URL =
+  'https://raw.githubusercontent.com/microsoftgraph/msgraph-metadata/refs/heads/master/openapi/beta/openapi.yaml';
+
 export async function downloadGraphOpenAPI(
   targetDir,
   targetFile,

package/bin/modules/generate-mcp-tools.mjs

@@ -2,20 +2,18 @@ import fs from 'fs';
 import path from 'path';
 import { execSync } from 'child_process';
 
-export function generateMcpTools(openApiSpec, outputDir) {
+export function generateMcpTools(openapiTrimmedFile, clientFilePath) {
   try {
-    console.log('Generating client code from OpenAPI spec using openapi-zod-client...');
+    console.log(
+      `Generating ${path.basename(clientFilePath)} from ${path.basename(openapiTrimmedFile)} using openapi-zod-client...`
+    );
 
+    const outputDir = path.dirname(clientFilePath);
     if (!fs.existsSync(outputDir)) {
       fs.mkdirSync(outputDir, { recursive: true });
       console.log(`Created directory: ${outputDir}`);
     }
 
-    const rootDir = path.resolve(outputDir, '../..');
-    const openapiDir = path.join(rootDir, 'openapi');
-    const openapiTrimmedFile = path.join(openapiDir, 'openapi-trimmed.yaml');
-
-    const clientFilePath = path.join(outputDir, 'client.ts');
     execSync(
       `npx -y openapi-zod-client "${openapiTrimmedFile}" -o "${clientFilePath}" --with-description --strict-objects --additional-props-default-value=false`,
       {
@@ -60,6 +58,11 @@ export function generateMcpTools(openApiSpec, outputDir) {
 
     fs.writeFileSync(clientFilePath, clientCode);
 
+    // Format the generated client so `npm run generate` output is prettier-stable and
+    // the format:check step in `npm run verify` passes deterministically across versions.
+    console.log('Formatting generated client with Prettier...');
+    execSync(`npx prettier --write "${clientFilePath}"`, { stdio: 'inherit' });
+
     return true;
   } catch (error) {
     throw new Error(`Error generating client code: ${error.message}`);

package/bin/modules/simplified-openapi.mjs

@@ -1,9 +1,18 @@
 import fs from 'fs';
 import yaml from 'js-yaml';
 
-export function createAndSaveSimplifiedOpenAPI(endpointsFile, openapiFile, openapiTrimmedFile) {
+export function createAndSaveSimplifiedOpenAPI(
+  endpointsFile,
+  openapiFile,
+  openapiTrimmedFile,
+  apiVersion = 'v1.0'
+) {
   const allEndpoints = JSON.parse(fs.readFileSync(endpointsFile, 'utf8'));
-  const endpoints = allEndpoints.filter((endpoint) => !endpoint.disabled);
+  // Each spec is trimmed against only the endpoints targeting its version. Entries
+  // without an explicit apiVersion default to v1.0, so existing endpoints are unchanged.
+  const endpoints = allEndpoints.filter(
+    (endpoint) => !endpoint.disabled && (endpoint.apiVersion ?? 'v1.0') === apiVersion
+  );
 
   const spec = fs.readFileSync(openapiFile, 'utf8');
   const openApiSpec = yaml.load(spec);

package/dist/__tests__/graph-tools.test.js

@@ -9,6 +9,7 @@ vi.mock("../logger.js", () => ({
   }
 }));
 const mockEndpoints = [];
+vi.mock("../generated/client-beta.js", () => ({ api: { endpoints: [] } }));
 vi.mock("../generated/client.js", () => ({
   api: {
     get endpoints() {

package/dist/auth.js

@@ -91,6 +91,19 @@ function getMissingAllowedScopesForGroups(scopeGroups, allowedScopes) {
   }
   return closest ?? [];
 }
+function getEndpointEffectiveLoginScopes(scopeGroups, allowedScopes) {
+  if (scopeGroups.length === 0) {
+    return [];
+  }
+  if (allowedScopes === void 0) {
+    return scopeGroups[0];
+  }
+  const coveredAllowedScopes = new Set(collapseScopeHierarchy(allowedScopes));
+  const satisfied = scopeGroups.find(
+    (group) => group.every((scope) => coveredAllowedScopes.has(scope))
+  );
+  return satisfied ?? [];
+}
 function collapseRedundantScopes(scopes) {
   const scopesSet = new Set(scopes);
   Object.entries(SCOPE_HIERARCHY).forEach(([higherScope, lowerScopes]) => {
@@ -231,7 +244,9 @@ function buildAllowedScopeDiagnostics(options = {}) {
       });
       continue;
     }
-    loginScopes.forEach((scope) => effectiveToolScopes.add(scope));
+    getEndpointEffectiveLoginScopes(scopeGroups, allowedScopes).forEach(
+      (scope) => effectiveToolScopes.add(scope)
+    );
     allScopes.forEach((scope) => effectiveToolScopesAllGroups.add(scope));
   }
   const toolPermissions = collapseRedundantScopes(Array.from(normalToolScopes)).sort(

package/dist/endpoints.json

@@ -1211,6 +1211,15 @@
     "presets": ["personal", "users", "work"],
     "scopes": ["User.Read"]
   },
+  {
+    "pathPattern": "/me/profile",
+    "method": "get",
+    "toolName": "get-my-profile",
+    "apiVersion": "beta",
+    "presets": ["personal", "users", "work"],
+    "scopes": ["User.Read"],
+    "llmTip": "Retrieves the signed-in user's rich profile - a richer object than get-current-user, exposing relationships like skills, projects, languages, education and work positions. Use $expand to pull related collections (e.g. $expand=skills,projects)."
+  },
   {
     "pathPattern": "/me/mailboxSettings",
     "method": "get",

package/dist/generated/client-beta.js

@@ -0,0 +1,776 @@
+import { makeApi, Zodios } from "./hack.js";
+import { z } from "zod";
+const microsoft_graph_allowedAudiences = z.enum([
+  "me",
+  "family",
+  "contacts",
+  "groupMembers",
+  "organization",
+  "federatedOrganizations",
+  "everyone",
+  "unknownFutureValue"
+]);
+const microsoft_graph_identity = z.object({
+  displayName: z.string().describe(
+    "The display name of the identity. For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta."
+  ).nullish(),
+  id: z.string().describe(
+    "Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review."
+  ).nullish()
+}).passthrough();
+const microsoft_graph_identitySet = z.object({
+  application: microsoft_graph_identity.optional(),
+  device: microsoft_graph_identity.optional(),
+  user: microsoft_graph_identity.optional()
+}).passthrough();
+const microsoft_graph_inferenceData = z.object({
+  confidenceScore: z.number().describe(
+    "Confidence score reflecting the accuracy of the data inferred about the user. [Simplified from 3 options]"
+  ).nullish(),
+  userHasVerifiedAccuracy: z.boolean().describe("Records if the user has confirmed this inference as being True or False.").nullish()
+}).passthrough();
+const microsoft_graph_personDataSources = z.object({ type: z.array(z.string().nullable()).optional() }).passthrough();
+const microsoft_graph_profileSourceAnnotation = z.object({
+  isDefaultSource: z.boolean().describe("Indicates whether the source is the default one.").nullish(),
+  properties: z.array(z.string().nullable()).describe("Names of properties that have data from this source.").optional(),
+  sourceId: z.string().nullish()
+}).passthrough();
+const microsoft_graph_originTenantInfo = z.object({
+  originTenantId: z.string().describe("The identifier of the tenant where the user account was originally provisioned.").nullish(),
+  originUserId: z.string().describe("The identifier of the user in the origin tenant.").nullish()
+}).passthrough();
+const microsoft_graph_localeInfo = z.object({
+  displayName: z.string().describe(
+    "A name representing the user's locale in natural language, for example, 'English (United States)'."
+  ).nullish(),
+  locale: z.string().describe(
+    "A locale representation for the user, which includes the user's preferred language and country/region. For example, 'en-us'. The language component follows 2-letter codes as defined in ISO 639-1, and the country component follows 2-letter codes as defined in ISO 3166-1 alpha-2."
+  ).nullish()
+}).passthrough();
+const microsoft_graph_userPersona = z.enum([
+  "unknown",
+  "externalMember",
+  "externalGuest",
+  "internalMember",
+  "internalGuest",
+  "unknownFutureValue"
+]);
+const microsoft_graph_userAccountInformation = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  ageGroup: z.string().describe(
+    "Shows the age group of user. Allowed values null, minor, notAdult and adult are generated by the directory and can't be changed."
+  ).nullish(),
+  countryCode: z.string().describe("Contains the two-character country code associated with the users' account.").nullish(),
+  originTenantInfo: microsoft_graph_originTenantInfo.optional(),
+  preferredLanguageTag: microsoft_graph_localeInfo.optional(),
+  userPersona: microsoft_graph_userPersona.optional(),
+  userPrincipalName: z.string().describe("The user principal name (UPN) of the user associated with the account.").nullish()
+}).passthrough();
+const microsoft_graph_physicalAddressType = z.enum(["unknown", "home", "business", "other"]);
+const microsoft_graph_physicalAddress = z.object({
+  city: z.string().describe("The city.").nullish(),
+  countryOrRegion: z.string().describe(
+    "The country or region. It's a free-format string value, for example, 'United States'."
+  ).nullish(),
+  postalCode: z.string().describe("The postal code.").nullish(),
+  postOfficeBox: z.string().describe("The post office box number.").nullish(),
+  state: z.string().describe("The state.").nullish(),
+  street: z.string().describe("The street.").nullish(),
+  type: microsoft_graph_physicalAddressType.optional()
+}).passthrough();
+const microsoft_graph_geoCoordinates = z.object({
+  altitude: z.number().describe(
+    "Optional. The altitude (height), in feet,  above sea level for the item. Read-only. [Simplified from 3 options]"
+  ).nullish(),
+  latitude: z.number().describe(
+    "Optional. The latitude, in decimal, for the item. Writable on OneDrive Personal. [Simplified from 3 options]"
+  ).nullish(),
+  longitude: z.number().describe(
+    "Optional. The longitude, in decimal, for the item. Writable on OneDrive Personal. [Simplified from 3 options]"
+  ).nullish()
+}).passthrough();
+const microsoft_graph_itemAddress = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  detail: microsoft_graph_physicalAddress.optional(),
+  displayName: z.string().describe("Friendly name the user has assigned to this address.").nullish(),
+  geoCoordinates: microsoft_graph_geoCoordinates.optional()
+}).passthrough();
+const microsoft_graph_personAnnualEventType = z.enum([
+  "birthday",
+  "wedding",
+  "work",
+  "other",
+  "unknownFutureValue"
+]);
+const microsoft_graph_personAnnualEvent = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  date: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).nullish(),
+  displayName: z.string().nullish(),
+  type: microsoft_graph_personAnnualEventType.optional()
+}).passthrough();
+const microsoft_graph_personAward = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  description: z.string().describe("Descpription of the award or honor.").nullish(),
+  displayName: z.string().describe("Name of the award or honor.").nullish(),
+  issuedDate: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).describe("The date that the award or honor was granted.").nullish(),
+  issuingAuthority: z.string().describe("Authority which granted the award or honor.").nullish(),
+  thumbnailUrl: z.string().describe("URL referencing a thumbnail of the award or honor.").nullish(),
+  webUrl: z.string().describe("URL referencing the award or honor.").nullish()
+}).passthrough();
+const microsoft_graph_personCertification = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  certificationId: z.string().describe("The referenceable identifier for the certification.").nullish(),
+  description: z.string().describe("Description of the certification.").nullish(),
+  displayName: z.string().describe("Title of the certification.").nullish(),
+  endDate: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).describe("The date that the certification expires.").nullish(),
+  issuedDate: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).describe("The date that the certification was issued.").nullish(),
+  issuingAuthority: z.string().describe("Authority which granted the certification.").nullish(),
+  issuingCompany: z.string().describe("Company which granted the certification.").nullish(),
+  startDate: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).describe("The date that the certification became valid.").nullish(),
+  thumbnailUrl: z.string().describe("URL referencing a thumbnail of the certification.").nullish(),
+  webUrl: z.string().describe("URL referencing the certification.").nullish()
+}).passthrough();
+const microsoft_graph_institutionData = z.object({
+  description: z.string().describe("Short description of the institution the user studied at.").nullish(),
+  displayName: z.string().describe("Name of the institution the user studied at.").nullish(),
+  location: microsoft_graph_physicalAddress.optional(),
+  webUrl: z.string().describe("Link to the institution or department homepage.").nullish()
+}).passthrough();
+const microsoft_graph_educationalActivityDetail = z.object({
+  abbreviation: z.string().describe("Shortened name of the degree or program, for example, PhD and MBA.").nullish(),
+  activities: z.array(z.string().nullable()).describe("Extracurricular activities undertaken alongside the program.").optional(),
+  awards: z.array(z.string().nullable()).describe("Any awards or honors associated with the program.").optional(),
+  description: z.string().describe("Short description of the program provided by the user.").nullish(),
+  displayName: z.string().describe("Long-form name of the program that the user provided.").nullish(),
+  fieldsOfStudy: z.array(z.string().nullable()).describe("Majors and minors associated with the program, if applicable.").optional(),
+  grade: z.string().describe("The final grade, class, grade point average (GPA), or score.").nullish(),
+  notes: z.string().describe("More notes provided by the user.").nullish(),
+  webUrl: z.string().describe("Link to the degree or program page.").nullish()
+}).passthrough();
+const microsoft_graph_educationalActivity = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  completionMonthYear: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).describe("The month and year the user graduated or completed the activity.").nullish(),
+  endMonthYear: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).describe("The month and year the user completed the educational activity referenced.").nullish(),
+  institution: microsoft_graph_institutionData.optional(),
+  program: microsoft_graph_educationalActivityDetail.optional(),
+  startMonthYear: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).describe("The month and year the user commenced the activity referenced.").nullish()
+}).passthrough();
+const microsoft_graph_emailType = z.enum(["unknown", "work", "personal", "main", "other"]);
+const microsoft_graph_itemEmail = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  address: z.string().describe("The email address itself.").nullish(),
+  displayName: z.string().describe("The name or label a user has associated with a particular email address.").nullish(),
+  type: microsoft_graph_emailType.optional()
+}).passthrough();
+const microsoft_graph_personInterest = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  categories: z.array(z.string().nullable()).describe(
+    "Contains categories a user has associated with the interest (for example, personal, recipies)."
+  ).optional(),
+  collaborationTags: z.array(z.string().nullable()).describe(
+    "Contains experience scenario tags a user has associated with the interest. Allowed values in the collection are: askMeAbout, ableToMentor, wantsToLearn, wantsToImprove."
+  ).optional(),
+  description: z.string().describe("Contains a description of the interest.").nullish(),
+  displayName: z.string().describe("Contains a friendly name for the interest.").nullish(),
+  thumbnailUrl: z.string().nullish(),
+  webUrl: z.string().describe("Contains a link to a web page or resource about the interest.").nullish()
+}).passthrough();
+const microsoft_graph_languageProficiencyLevel = z.enum([
+  "elementary",
+  "conversational",
+  "limitedWorking",
+  "professionalWorking",
+  "fullProfessional",
+  "nativeOrBilingual",
+  "unknownFutureValue"
+]);
+const microsoft_graph_languageProficiency = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  displayName: z.string().describe("Contains the long-form name for the language.").nullish(),
+  proficiency: microsoft_graph_languageProficiencyLevel.optional(),
+  reading: microsoft_graph_languageProficiencyLevel.optional(),
+  spoken: microsoft_graph_languageProficiencyLevel.optional(),
+  tag: z.string().describe("Contains the four-character BCP47 name for the language (en-US, no-NB, en-AU).").nullish(),
+  thumbnailUrl: z.string().nullish(),
+  written: microsoft_graph_languageProficiencyLevel.optional()
+}).passthrough();
+const microsoft_graph_personNamePronounciation = z.object({
+  displayName: z.string().nullish(),
+  first: z.string().nullish(),
+  last: z.string().nullish(),
+  maiden: z.string().nullish(),
+  middle: z.string().nullish()
+}).passthrough();
+const microsoft_graph_personName = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  displayName: z.string().describe(
+    "Provides an ordered rendering of firstName and lastName depending on the locale of the user or their device."
+  ).nullish(),
+  first: z.string().describe("First name of the user.").nullish(),
+  initials: z.string().describe("Initials of the user.").nullish(),
+  languageTag: z.string().describe(
+    "Contains the name for the language (en-US, no-NB, en-AU) following IETF BCP47 format."
+  ).nullish(),
+  last: z.string().describe("Last name of the user.").nullish(),
+  maiden: z.string().describe("Maiden name of the user.").nullish(),
+  middle: z.string().describe("Middle name of the user.").nullish(),
+  nickname: z.string().describe("Nickname of the user.").nullish(),
+  pronunciation: microsoft_graph_personNamePronounciation.optional(),
+  suffix: z.string().describe("Designators used after the users name (eg: PhD.)").nullish(),
+  title: z.string().describe("Honorifics used to prefix a users name (eg: Dr, Sir, Madam, Mrs.)").nullish()
+}).passthrough();
+const microsoft_graph_bodyType = z.enum(["text", "html"]);
+const microsoft_graph_itemBody = z.object({
+  content: z.string().describe("The content of the item.").nullish(),
+  contentType: microsoft_graph_bodyType.optional()
+}).passthrough();
+const microsoft_graph_personAnnotation = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  detail: microsoft_graph_itemBody.optional(),
+  displayName: z.string().describe("Contains a friendly name for the note.").nullish(),
+  thumbnailUrl: z.string().nullish()
+}).passthrough();
+const microsoft_graph_itemPatent = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  description: z.string().describe("Descpription of the patent or filing.").nullish(),
+  displayName: z.string().describe("Title of the patent or filing.").nullish(),
+  isPending: z.boolean().describe("Indicates the patent is pending.").nullish(),
+  issuedDate: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).describe("The date that the patent was granted.").nullish(),
+  issuingAuthority: z.string().describe("Authority that granted the patent.").nullish(),
+  number: z.string().describe("The patent number.").nullish(),
+  webUrl: z.string().describe("URL referencing the patent or filing.").nullish()
+}).passthrough();
+const microsoft_graph_phoneType = z.enum([
+  "home",
+  "business",
+  "mobile",
+  "other",
+  "assistant",
+  "homeFax",
+  "businessFax",
+  "otherFax",
+  "pager",
+  "radio"
+]);
+const microsoft_graph_itemPhone = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  displayName: z.string().describe("Friendly name the user has assigned this phone number.").nullish(),
+  number: z.string().describe("Phone number provided by the user.").nullish(),
+  type: microsoft_graph_phoneType.optional()
+}).passthrough();
+const microsoft_graph_personRelationship = z.enum([
+  "manager",
+  "colleague",
+  "directReport",
+  "dotLineReport",
+  "assistant",
+  "dotLineManager",
+  "alternateContact",
+  "friend",
+  "spouse",
+  "sibling",
+  "child",
+  "parent",
+  "sponsor",
+  "emergencyContact",
+  "other",
+  "unknownFutureValue"
+]);
+const microsoft_graph_relatedPerson = z.object({
+  displayName: z.string().describe("Name of the person.").nullish(),
+  relationship: microsoft_graph_personRelationship.optional(),
+  userId: z.string().describe("The user's directory object ID (Microsoft Entra ID or CID).").nullish(),
+  userPrincipalName: z.string().describe("Email address or reference to person within the organization.").nullish()
+}).passthrough();
+const microsoft_graph_companyDetail = z.object({
+  address: microsoft_graph_physicalAddress.optional(),
+  companyCode: z.string().describe(
+    "Legal entity number of the company or its subdivision. For information on how to set the value for the companyCode, see profileSourceAnnotation."
+  ).nullish(),
+  costCenter: z.string().describe("The cost center associated with the company or department.").nullish(),
+  department: z.string().describe("Department Name within a company.").nullish(),
+  displayName: z.string().describe("Company name.").nullish(),
+  division: z.string().describe("The division within the company.").nullish(),
+  officeLocation: z.string().describe("Office Location of the person referred to.").nullish(),
+  pronunciation: z.string().describe("Pronunciation guide for the company name.").nullish(),
+  secondaryDepartment: z.string().describe("Secondary Department Name within a company.").nullish(),
+  webUrl: z.string().describe("Link to the company home page.").nullish()
+}).passthrough();
+const microsoft_graph_positionDetail = z.object({
+  company: microsoft_graph_companyDetail.optional(),
+  description: z.string().describe("A description for the position in question.").nullish(),
+  employeeId: z.string().describe("The identifier assigned to the employee.").nullish(),
+  employeeType: z.string().describe("The type of employment for the position.").nullish(),
+  endMonthYear: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).describe("The date when the position ended.").nullish(),
+  jobTitle: z.string().describe("The title of the position.").nullish(),
+  layer: z.number().gte(-2147483648).lte(2147483647).describe("The place where the employee is within the organizational hierarchy.").nullish(),
+  level: z.string().describe("The employee\u2019s experience or management level.").nullish(),
+  role: z.string().describe("The role the position entailed.").nullish(),
+  secondaryJobTitle: z.string().describe("An optional job title for the position.").nullish(),
+  secondaryRole: z.string().describe("An optional role for the position entailed.").nullish(),
+  startMonthYear: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).describe("The start date of the position.").nullish(),
+  summary: z.string().describe("The summary of the position.").nullish()
+}).passthrough();
+const microsoft_graph_workPosition = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  categories: z.array(z.string().nullable()).describe("Categories that the user has associated with this position.").optional(),
+  colleagues: z.array(microsoft_graph_relatedPerson).describe("Colleagues that are associated with this position.").optional(),
+  detail: microsoft_graph_positionDetail.optional(),
+  isCurrent: z.boolean().describe("Denotes whether or not the position is current.").nullish(),
+  manager: microsoft_graph_relatedPerson.optional()
+}).passthrough();
+const microsoft_graph_projectParticipation = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  categories: z.array(z.string().nullable()).describe(
+    "Contains categories a user has associated with the project (for example, digital transformation, oil rig)."
+  ).optional(),
+  client: microsoft_graph_companyDetail.optional(),
+  collaborationTags: z.array(z.string().nullable()).describe(
+    "Contains experience scenario tags a user has associated with the interest. Allowed values in the collection are: askMeAbout, ableToMentor, wantsToLearn, wantsToImprove."
+  ).optional(),
+  colleagues: z.array(microsoft_graph_relatedPerson).describe("Lists people that also worked on the project.").optional(),
+  detail: microsoft_graph_positionDetail.optional(),
+  displayName: z.string().describe("Contains a friendly name for the project.").nullish(),
+  sponsors: z.array(microsoft_graph_relatedPerson).describe("The Person or people who sponsored the project.").optional(),
+  thumbnailUrl: z.string().nullish()
+}).passthrough();
+const microsoft_graph_itemPublication = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  description: z.string().describe("Description of the publication.").nullish(),
+  displayName: z.string().describe("Title of the publication.").nullish(),
+  publishedDate: z.string().regex(/^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$/).describe("The date that the publication was published.").nullish(),
+  publisher: z.string().describe("Publication or publisher for the publication.").nullish(),
+  thumbnailUrl: z.string().describe("URL referencing a thumbnail of the publication.").nullish(),
+  webUrl: z.string().describe("URL referencing the publication.").nullish()
+}).passthrough();
+const microsoft_graph_skillProficiencyLevel = z.enum([
+  "elementary",
+  "limitedWorking",
+  "generalProfessional",
+  "advancedProfessional",
+  "expert",
+  "unknownFutureValue"
+]);
+const microsoft_graph_skillProficiency = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  categories: z.array(z.string().nullable()).describe(
+    "Contains categories a user has associated with the skill (for example, personal, professional, hobby)."
+  ).optional(),
+  collaborationTags: z.array(z.string().nullable()).describe(
+    "Contains experience scenario tags a user has associated with the interest. Allowed values in the collection are: askMeAbout, ableToMentor, wantsToLearn, wantsToImprove."
+  ).optional(),
+  displayName: z.string().describe("Contains a friendly name for the skill.").nullish(),
+  proficiency: microsoft_graph_skillProficiencyLevel.optional(),
+  thumbnailUrl: z.string().nullish(),
+  webUrl: z.string().describe("Contains a link to an information source about the skill.").nullish()
+}).passthrough();
+const microsoft_graph_serviceInformation = z.object({
+  name: z.string().describe("The name of the cloud service (for example, Twitter, Instagram).").nullish(),
+  webUrl: z.string().describe("Contains the URL for the service being referenced.").nullish()
+}).passthrough();
+const microsoft_graph_webAccount = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  description: z.string().describe(
+    "Contains the description the user has provided for the account on the service being referenced."
+  ).nullish(),
+  service: microsoft_graph_serviceInformation.optional(),
+  statusMessage: z.string().describe("Contains a status message from the cloud service if provided or synchronized.").nullish(),
+  thumbnailUrl: z.string().nullish(),
+  userId: z.string().describe("The user name  displayed for the webaccount.").nullish(),
+  webUrl: z.string().describe("Contains a link to the user's profile on the cloud service if one exists.").nullish()
+}).passthrough();
+const microsoft_graph_personWebsite = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  allowedAudiences: microsoft_graph_allowedAudiences.optional(),
+  createdBy: microsoft_graph_identitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  inference: microsoft_graph_inferenceData.optional(),
+  isSearchable: z.boolean().nullish(),
+  lastModifiedBy: microsoft_graph_identitySet.optional(),
+  lastModifiedDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Provides the dateTimeOffset for when the entity was created.").nullish(),
+  source: microsoft_graph_personDataSources.optional(),
+  sources: z.array(microsoft_graph_profileSourceAnnotation).describe("Where the values within an entity originated if synced from another source.").optional(),
+  categories: z.array(z.string().nullable()).describe(
+    "Contains categories a user has associated with the website (for example, personal, recipes)."
+  ).optional(),
+  description: z.string().describe("Contains a description of the website.").nullish(),
+  displayName: z.string().describe("Contains a friendly name for the website.").nullish(),
+  thumbnailUrl: z.string().nullish(),
+  webUrl: z.string().describe("Contains a link to the website itself.").nullish()
+}).passthrough();
+const microsoft_graph_profile = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  account: z.array(microsoft_graph_userAccountInformation).optional(),
+  addresses: z.array(microsoft_graph_itemAddress).describe("Represents details of addresses associated with the user.").optional(),
+  anniversaries: z.array(microsoft_graph_personAnnualEvent).describe("Represents the details of meaningful dates associated with a person.").optional(),
+  awards: z.array(microsoft_graph_personAward).describe("Represents the details of awards or honors associated with a person.").optional(),
+  certifications: z.array(microsoft_graph_personCertification).describe("Represents the details of certifications associated with a person.").optional(),
+  educationalActivities: z.array(microsoft_graph_educationalActivity).describe(
+    "Represents data that a user has supplied related to undergraduate, graduate, postgraduate or other educational activities."
+  ).optional(),
+  emails: z.array(microsoft_graph_itemEmail).describe("Represents detailed information about email addresses associated with the user.").optional(),
+  interests: z.array(microsoft_graph_personInterest).describe(
+    "Provides detailed information about interests the user has associated with themselves in various services."
+  ).optional(),
+  languages: z.array(microsoft_graph_languageProficiency).describe(
+    "Represents detailed information about languages that a user has added to their profile."
+  ).optional(),
+  names: z.array(microsoft_graph_personName).describe("Represents the names a user has added to their profile.").optional(),
+  notes: z.array(microsoft_graph_personAnnotation).describe("Represents notes that a user has added to their profile.").optional(),
+  patents: z.array(microsoft_graph_itemPatent).describe("Represents patents that a user has added to their profile.").optional(),
+  phones: z.array(microsoft_graph_itemPhone).describe(
+    "Represents detailed information about phone numbers associated with a user in various services."
+  ).optional(),
+  positions: z.array(microsoft_graph_workPosition).describe(
+    "Represents detailed information about work positions associated with a user's profile."
+  ).optional(),
+  projects: z.array(microsoft_graph_projectParticipation).describe("Represents detailed information about projects associated with a user.").optional(),
+  publications: z.array(microsoft_graph_itemPublication).describe("Represents details of any publications a user has added to their profile.").optional(),
+  skills: z.array(microsoft_graph_skillProficiency).describe(
+    "Represents detailed information about skills associated with a user in various services."
+  ).optional(),
+  webAccounts: z.array(microsoft_graph_webAccount).describe(
+    "Represents web accounts the user has indicated they use or has added to their user profile."
+  ).optional(),
+  websites: z.array(microsoft_graph_personWebsite).describe(
+    "Represents detailed information about websites associated with a user in various services."
+  ).optional()
+}).passthrough();
+const microsoft_graph_ODataErrors_ErrorDetails = z.object({ code: z.string(), message: z.string(), target: z.string().nullish() }).passthrough();
+const microsoft_graph_ODataErrors_InnerError = z.object({
+  "request-id": z.string().describe("Request Id as tracked internally by the service").nullish(),
+  "client-request-id": z.string().describe("Client request Id as sent by the client application.").nullish(),
+  date: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe("Date when the error occured.").nullish()
+}).passthrough();
+const microsoft_graph_ODataErrors_MainError = z.object({
+  code: z.string(),
+  message: z.string(),
+  target: z.string().nullish(),
+  details: z.array(microsoft_graph_ODataErrors_ErrorDetails).optional(),
+  innerError: microsoft_graph_ODataErrors_InnerError.optional()
+}).passthrough();
+const microsoft_graph_ODataErrors_ODataError = z.object({ error: microsoft_graph_ODataErrors_MainError }).passthrough();
+const schemas = {
+  microsoft_graph_allowedAudiences,
+  microsoft_graph_identity,
+  microsoft_graph_identitySet,
+  microsoft_graph_inferenceData,
+  microsoft_graph_personDataSources,
+  microsoft_graph_profileSourceAnnotation,
+  microsoft_graph_originTenantInfo,
+  microsoft_graph_localeInfo,
+  microsoft_graph_userPersona,
+  microsoft_graph_userAccountInformation,
+  microsoft_graph_physicalAddressType,
+  microsoft_graph_physicalAddress,
+  microsoft_graph_geoCoordinates,
+  microsoft_graph_itemAddress,
+  microsoft_graph_personAnnualEventType,
+  microsoft_graph_personAnnualEvent,
+  microsoft_graph_personAward,
+  microsoft_graph_personCertification,
+  microsoft_graph_institutionData,
+  microsoft_graph_educationalActivityDetail,
+  microsoft_graph_educationalActivity,
+  microsoft_graph_emailType,
+  microsoft_graph_itemEmail,
+  microsoft_graph_personInterest,
+  microsoft_graph_languageProficiencyLevel,
+  microsoft_graph_languageProficiency,
+  microsoft_graph_personNamePronounciation,
+  microsoft_graph_personName,
+  microsoft_graph_bodyType,
+  microsoft_graph_itemBody,
+  microsoft_graph_personAnnotation,
+  microsoft_graph_itemPatent,
+  microsoft_graph_phoneType,
+  microsoft_graph_itemPhone,
+  microsoft_graph_personRelationship,
+  microsoft_graph_relatedPerson,
+  microsoft_graph_companyDetail,
+  microsoft_graph_positionDetail,
+  microsoft_graph_workPosition,
+  microsoft_graph_projectParticipation,
+  microsoft_graph_itemPublication,
+  microsoft_graph_skillProficiencyLevel,
+  microsoft_graph_skillProficiency,
+  microsoft_graph_serviceInformation,
+  microsoft_graph_webAccount,
+  microsoft_graph_personWebsite,
+  microsoft_graph_profile,
+  microsoft_graph_ODataErrors_ErrorDetails,
+  microsoft_graph_ODataErrors_InnerError,
+  microsoft_graph_ODataErrors_MainError,
+  microsoft_graph_ODataErrors_ODataError
+};
+const endpoints = makeApi([
+  {
+    method: "get",
+    path: "/me/profile",
+    alias: "get-my-profile",
+    description: `Retrieve the properties and relationships of a profile object for a given user. The profile resource exposes various rich properties that are descriptive of the user as relationships, for example, anniversaries and education activities. To get one of these navigation properties, use the corresponding GET method on that property. See the methods exposed by profile.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "$select",
+        type: "Query",
+        schema: z.array(z.string()).describe("Select properties to be returned").optional()
+      },
+      {
+        name: "$expand",
+        type: "Query",
+        schema: z.array(z.string()).describe("Expand related entities").optional()
+      }
+    ],
+    response: z.void()
+  }
+]);
+const api = new Zodios(endpoints);
+function createApiClient(baseUrl, options) {
+  return new Zodios(baseUrl, endpoints, options);
+}
+export {
+  api,
+  createApiClient,
+  schemas
+};

package/dist/graph-client.js

@@ -100,7 +100,8 @@ class GraphClient {
   }
   async performRequest(endpoint, accessToken, options) {
     const cloudEndpoints = getCloudEndpoints(this.secrets.cloudType);
-    const url = `${cloudEndpoints.graphApi}/v1.0${endpoint}`;
+    const apiVersion = options.apiVersion || "v1.0";
+    const url = `${cloudEndpoints.graphApi}/${apiVersion}${endpoint}`;
     logger.info(`[GRAPH CLIENT] Final URL being sent to Microsoft: ${url}`);
     const headers = {
       Authorization: `Bearer ${accessToken}`,

package/dist/graph-tools.js

@@ -7,6 +7,8 @@ import {
   parseAllowedScopes
 } from "./auth.js";
 import { api } from "./generated/client.js";
+import { api as betaApi } from "./generated/client-beta.js";
+const allEndpoints = [...api.endpoints, ...betaApi.endpoints];
 import { z } from "zod";
 import { readFileSync } from "fs";
 import path from "path";
@@ -21,6 +23,9 @@ const __dirname = path.dirname(__filename);
 const endpointsData = JSON.parse(
   readFileSync(path.join(__dirname, "endpoints.json"), "utf8")
 );
+function withApiVersionPrefix(description, config) {
+  return config?.apiVersion === "beta" ? `[beta] ${description}` : description;
+}
 function maxTopFromEnv() {
   const raw = process.env.MS365_MCP_MAX_TOP;
   if (raw === void 0 || raw === "") return void 0;
@@ -337,6 +342,9 @@ async function executeGraphTool(tool, config, graphClient, params, authManager)
       method: tool.method.toUpperCase(),
       headers
     };
+    if (config?.apiVersion) {
+      options.apiVersion = config.apiVersion;
+    }
     if (options.method !== "GET" && body) {
       if (tool.requestFormat === "binary" && typeof body === "string") {
         options.body = Buffer.from(body, "base64");
@@ -396,7 +404,7 @@ async function executeGraphTool(tool, config, graphClient, params, authManager)
         while (nextLink && pageCount < maxPages && allItems.length < maxItems) {
           logger.info(`Fetching page ${pageCount + 1} from: ${nextLink}`);
           const url = new URL(nextLink);
-          const nextPath = url.pathname.replace("/v1.0", "") + url.search;
+          const nextPath = url.pathname.replace(/^\/(v1\.0|beta)/, "") + url.search;
           const nextOptions = { ...options };
           const nextResponse = await graphClient.graphRequest(nextPath, nextOptions);
           if (nextResponse?.content?.[0]?.text) {
@@ -505,7 +513,7 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
   let failedCount = 0;
   const allowedScopes = parseAllowedScopes(allowedScopesValue);
   const disabledByAllowedScopes = [];
-  for (const tool of api.endpoints) {
+  for (const tool of allEndpoints) {
     const endpointConfig = endpointsData.find((e) => e.toolName === tool.alias);
     if (!orgMode && endpointConfig && !endpointConfig.scopes && endpointConfig.workScopes) {
       logger.info(`Skipping work account tool ${tool.alias} - not in org mode`);
@@ -605,7 +613,10 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
         "When true, expands singleValueExtendedProperties on each event. Use this to retrieve custom extended properties (e.g., sync metadata) stored on calendar events."
       ).optional();
     }
-    let toolDescription = tool.description || `Execute ${tool.method.toUpperCase()} request to ${tool.path}`;
+    let toolDescription = withApiVersionPrefix(
+      tool.description || `Execute ${tool.method.toUpperCase()} request to ${tool.path}`,
+      endpointConfig
+    );
     if (endpointConfig?.llmTip) {
       toolDescription += `
 
@@ -665,7 +676,7 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
 function buildToolsRegistry(readOnly, orgMode, enabledToolsRegex, allowedScopesValue, disabledByAllowedScopes = []) {
   const toolsMap = /* @__PURE__ */ new Map();
   const allowedScopes = parseAllowedScopes(allowedScopesValue);
-  for (const tool of api.endpoints) {
+  for (const tool of allEndpoints) {
     const endpointConfig = endpointsData.find((e) => e.toolName === tool.alias);
     if (!orgMode && endpointConfig && !endpointConfig.scopes && endpointConfig.workScopes) {
       continue;
@@ -799,7 +810,10 @@ function registerDiscoveryTools(server, graphClient, readOnly = false, orgMode =
         name,
         method: tool.method.toUpperCase(),
         path: tool.path,
-        description: tool.description || `${tool.method.toUpperCase()} ${tool.path}`,
+        description: withApiVersionPrefix(
+          tool.description || `${tool.method.toUpperCase()} ${tool.path}`,
+          config
+        ),
         ...config?.llmTip ? { llmTip: config.llmTip } : {}
       };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softeria/ms-365-mcp-server",
-  "version": "0.124.1",
+  "version": "0.125.0",
   "description": " A Model Context Protocol (MCP) server for interacting with Microsoft 365 and Office services through the Graph API",
   "type": "module",
   "main": "dist/index.js",

package/src/endpoints.json

@@ -1211,6 +1211,15 @@
     "presets": ["personal", "users", "work"],
     "scopes": ["User.Read"]
   },
+  {
+    "pathPattern": "/me/profile",
+    "method": "get",
+    "toolName": "get-my-profile",
+    "apiVersion": "beta",
+    "presets": ["personal", "users", "work"],
+    "scopes": ["User.Read"],
+    "llmTip": "Retrieves the signed-in user's rich profile - a richer object than get-current-user, exposing relationships like skills, projects, languages, education and work positions. Use $expand to pull related collections (e.g. $expand=skills,projects)."
+  },
   {
     "pathPattern": "/me/mailboxSettings",
     "method": "get",