Webex MCP Server

Instructions

Implementation Reference

• tools/webex-public-workspace/webex-messaging/update-a-team-membership.js:10-42 (handler)

  The core handler function `executeFunction` that performs the HTTP PUT request to the Webex API endpoint `/team/memberships/{membershipId}` to update the isModerator status. Includes URL construction using helpers, JSON body preparation, fetch call, response validation, JSON parsing, and comprehensive error handling with logging.

  const executeFunction = async ({ membershipId, isModerator }) => {
  
    try {
      // Construct the URL with the membership ID
      const url = getWebexUrl(`/team/memberships/${encodeURIComponent(membershipId)}`);
  
      // Set up headers for the request
      const headers = getWebexJsonHeaders();
  
      // Prepare the request body
      const body = JSON.stringify({ isModerator });
  
      // Perform the fetch request
      const response = await fetch(url, {
        method: 'PUT',
        headers,
        body
      });
  
      // Check if the response was successful
      if (!response.ok) {
        const errorData = await response.json();
        throw new Error(errorData);
      }
  
      // Parse and return the response data
      const data = await response.json();
      return data;
    } catch (error) {
      console.error('Error updating team membership:', error);
      return { error: 'An error occurred while updating the team membership.' };
    }
  };

• tools/webex-public-workspace/webex-messaging/update-a-team-membership.js:53-69 (schema)

  Tool schema defining the name 'update_team_membership', description, and parameters: membershipId (required string) and isModerator (required boolean). Used for input validation in MCP.

    name: 'update_team_membership',
    description: 'Update a team membership in Webex.',
    parameters: {
      type: 'object',
      properties: {
        membershipId: {
          type: 'string',
          description: 'The unique identifier for the team membership.'
        },
        isModerator: {
          type: 'boolean',
          description: 'Indicates if the user is a moderator.'
        }
      },
      required: ['membershipId', 'isModerator']
    }
  }

• tools/paths.js:18-18 (registration)

  Specific registration of the tool by including its relative path in the central toolPaths array. This array is mapped in lib/tools.js#discoverTools() to dynamically import and load apiTool from each file for MCP server registration.

  'webex-public-workspace/webex-messaging/update-a-team-membership.js',