Dataverse MCP Server

Instructions

Implementation Reference

• src/tools/team-tools.ts:179-229 (handler)

  Executes the tool logic by constructing update data from params and patching the Dataverse teams endpoint via the client.

  async (params) => {
    try {
      const updateData: any = {};
  
      if (params.name !== undefined) updateData.name = params.name;
      if (params.description !== undefined) updateData.description = params.description;
      if (params.teamType !== undefined) updateData.teamtype = parseInt(params.teamType);
      if (params.membershipType !== undefined) updateData.membershiptype = parseInt(params.membershipType);
      if (params.emailAddress !== undefined) updateData.emailaddress = params.emailAddress;
      if (params.yomiName !== undefined) updateData.yominame = params.yomiName;
      if (params.azureActiveDirectoryObjectId !== undefined) updateData.azureactivedirectoryobjectid = params.azureActiveDirectoryObjectId;
  
      // Set optional relationships
      if (params.administratorId !== undefined) {
        updateData['administratorid@odata.bind'] = `/systemusers(${params.administratorId})`;
      }
      if (params.queueId !== undefined) {
        updateData['queueid@odata.bind'] = params.queueId ? `/queues(${params.queueId})` : null;
      }
      if (params.teamTemplateId !== undefined) {
        updateData['teamtemplateid@odata.bind'] = params.teamTemplateId ? `/teamtemplates(${params.teamTemplateId})` : null;
      }
      if (params.delegatedAuthorizationId !== undefined) {
        updateData['delegatedauthorizationid@odata.bind'] = params.delegatedAuthorizationId ? `/delegatedauthorizations(${params.delegatedAuthorizationId})` : null;
      }
      if (params.transactionCurrencyId !== undefined) {
        updateData['transactioncurrencyid@odata.bind'] = params.transactionCurrencyId ? `/transactioncurrencies(${params.transactionCurrencyId})` : null;
      }
  
      await client.patch(`teams(${params.teamId})`, updateData);
  
      return {
        content: [
          {
            type: "text",
            text: `Successfully updated team.`
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error updating team: ${error instanceof Error ? error.message : 'Unknown error'}`
          }
        ],
        isError: true
      };
    }
  }

• src/tools/team-tools.ts:163-177 (schema)

  Zod input schema defining parameters for updating a Dataverse team, including optional fields for various team properties.

  inputSchema: {
    teamId: z.string().describe("ID of the team to update"),
    name: z.string().max(160).optional().describe("New name of the team"),
    description: z.string().max(2000).optional().describe("New description of the team"),
    teamType: z.enum(['0', '1', '2', '3']).optional().describe("Team type: 0=Owner, 1=Access, 2=Security Group, 3=Office Group"),
    membershipType: z.enum(['0', '1', '2', '3']).optional().describe("Membership type: 0=Members and guests, 1=Members, 2=Owners, 3=Guests"),
    emailAddress: z.string().max(100).optional().describe("Email address for the team"),
    yomiName: z.string().max(160).optional().describe("Pronunciation of the team name in phonetic characters"),
    azureActiveDirectoryObjectId: z.string().optional().describe("Azure AD Object ID for the team"),
    administratorId: z.string().optional().describe("New administrator user ID"),
    queueId: z.string().optional().describe("Default queue ID for the team"),
    teamTemplateId: z.string().optional().describe("Team template ID to associate with the team"),
    delegatedAuthorizationId: z.string().optional().describe("Delegated authorization context for the team"),
    transactionCurrencyId: z.string().optional().describe("Currency ID associated with the team")
  }

• src/tools/team-tools.ts:157-231 (registration)

  Registers the 'update_dataverse_team' tool with the MCP server using server.registerTool, providing title, description, input schema, and handler function.

  export function updateTeamTool(server: McpServer, client: DataverseClient) {
    server.registerTool(
      "update_dataverse_team",
      {
        title: "Update Dataverse Team",
        description: "Updates the properties and configuration of an existing team. Use this to modify team settings like name, description, administrator, or other team properties without changing team membership.",
        inputSchema: {
          teamId: z.string().describe("ID of the team to update"),
          name: z.string().max(160).optional().describe("New name of the team"),
          description: z.string().max(2000).optional().describe("New description of the team"),
          teamType: z.enum(['0', '1', '2', '3']).optional().describe("Team type: 0=Owner, 1=Access, 2=Security Group, 3=Office Group"),
          membershipType: z.enum(['0', '1', '2', '3']).optional().describe("Membership type: 0=Members and guests, 1=Members, 2=Owners, 3=Guests"),
          emailAddress: z.string().max(100).optional().describe("Email address for the team"),
          yomiName: z.string().max(160).optional().describe("Pronunciation of the team name in phonetic characters"),
          azureActiveDirectoryObjectId: z.string().optional().describe("Azure AD Object ID for the team"),
          administratorId: z.string().optional().describe("New administrator user ID"),
          queueId: z.string().optional().describe("Default queue ID for the team"),
          teamTemplateId: z.string().optional().describe("Team template ID to associate with the team"),
          delegatedAuthorizationId: z.string().optional().describe("Delegated authorization context for the team"),
          transactionCurrencyId: z.string().optional().describe("Currency ID associated with the team")
        }
      },
      async (params) => {
        try {
          const updateData: any = {};
  
          if (params.name !== undefined) updateData.name = params.name;
          if (params.description !== undefined) updateData.description = params.description;
          if (params.teamType !== undefined) updateData.teamtype = parseInt(params.teamType);
          if (params.membershipType !== undefined) updateData.membershiptype = parseInt(params.membershipType);
          if (params.emailAddress !== undefined) updateData.emailaddress = params.emailAddress;
          if (params.yomiName !== undefined) updateData.yominame = params.yomiName;
          if (params.azureActiveDirectoryObjectId !== undefined) updateData.azureactivedirectoryobjectid = params.azureActiveDirectoryObjectId;
  
          // Set optional relationships
          if (params.administratorId !== undefined) {
            updateData['administratorid@odata.bind'] = `/systemusers(${params.administratorId})`;
          }
          if (params.queueId !== undefined) {
            updateData['queueid@odata.bind'] = params.queueId ? `/queues(${params.queueId})` : null;
          }
          if (params.teamTemplateId !== undefined) {
            updateData['teamtemplateid@odata.bind'] = params.teamTemplateId ? `/teamtemplates(${params.teamTemplateId})` : null;
          }
          if (params.delegatedAuthorizationId !== undefined) {
            updateData['delegatedauthorizationid@odata.bind'] = params.delegatedAuthorizationId ? `/delegatedauthorizations(${params.delegatedAuthorizationId})` : null;
          }
          if (params.transactionCurrencyId !== undefined) {
            updateData['transactioncurrencyid@odata.bind'] = params.transactionCurrencyId ? `/transactioncurrencies(${params.transactionCurrencyId})` : null;
          }
  
          await client.patch(`teams(${params.teamId})`, updateData);
  
          return {
            content: [
              {
                type: "text",
                text: `Successfully updated team.`
              }
            ]
          };
        } catch (error) {
          return {
            content: [
              {
                type: "text",
                text: `Error updating team: ${error instanceof Error ? error.message : 'Unknown error'}`
              }
            ],
            isError: true
          };
        }
      }
    );
  }