Webex MCP Server

Instructions

Implementation Reference

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

  The main handler function that executes the deletion of a Webex message by making a DELETE request to the `/messages/{messageId}` endpoint using Webex configuration utilities.

  const executeFunction = async ({ messageId }) => {
  
    try {
      // Construct the URL for the delete request
      const url = getWebexUrl(`/messages/${encodeURIComponent(messageId)}`);
  
      // 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(JSON.stringify(errorData));
      }
  
      // Return the response status
      return { status: response.status, message: 'Message deleted successfully.' };
    } catch (error) {
      console.error('Error deleting message:', error);
      return {
        error: error.message || 'An error occurred while deleting the message.',
        details: error.stack
      };
    }
  };

• tools/webex-public-workspace/webex-messaging/delete-a-message.js:45-64 (registration)

  The apiTool export that registers the 'delete_message' tool, linking the handler function to its schema definition for MCP integration.

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

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

  JSON schema defining the input parameters for the delete_message tool: an object requiring 'messageId' as a string.

  parameters: {
    type: 'object',
    properties: {
      messageId: {
        type: 'string',
        description: 'The unique identifier for the message to be deleted.'
      }
    },
    required: ['messageId']
  }