Webex MCP Server

Instructions

Implementation Reference

• tools/webex-public-workspace/webex-messaging/delete-a-membership.js:9-36 (handler)

  The main handler function that performs the DELETE request to the Webex API to delete a membership by its ID.

  const executeFunction = async ({ membershipId }) => {
  
    try {
      // Construct the URL with the membership ID
      const url = getWebexUrl(`/memberships/${encodeURIComponent(membershipId)}`);
  
      // Set up headers for the request
      const headers = getWebexHeaders();
  
      // Perform the fetch request
      const response = await fetch(url, {
        method: 'DELETE',
        headers
      });
  
      // Check if the response was successful
      if (!response.ok) {
        const errorData = await response.json();
        throw new Error(errorData);
      }
  
      // Return the response status
      return { status: response.status, message: 'Membership deleted successfully.' };
    } catch (error) {
      console.error('Error deleting membership:', error);
      return { error: 'An error occurred while deleting the membership.' };
    }
  };

• tools/webex-public-workspace/webex-messaging/delete-a-membership.js:44-61 (schema)

  Tool schema definition including the name, description, input parameters (membershipId as required string), used for validation.

    definition: {
      type: 'function',
      function: {
        name: 'delete_membership',
        description: 'Delete a membership by ID in Webex.',
        parameters: {
          type: 'object',
          properties: {
            membershipId: {
              type: 'string',
              description: 'The unique identifier for the membership to be deleted.'
            }
          },
          required: ['membershipId']
        }
      }
    }
  };

• tools/webex-public-workspace/webex-messaging/delete-a-membership.js:42-63 (registration)

  The apiTool object that bundles the handler function and schema definition, exported for registration in the MCP tools system.

  const apiTool = {
    function: executeFunction,
    definition: {
      type: 'function',
      function: {
        name: 'delete_membership',
        description: 'Delete a membership by ID in Webex.',
        parameters: {
          type: 'object',
          properties: {
            membershipId: {
              type: 'string',
              description: 'The unique identifier for the membership to be deleted.'
            }
          },
          required: ['membershipId']
        }
      }
    }
  };
  
  export { apiTool };