Webex MCP Server

Instructions

Implementation Reference

• tools/webex-public-workspace/webex-messaging/update-a-webhook.js:13-59 (handler)

  The core handler function that executes the update_webhook tool. It constructs the Webex API URL, request body with webhook details, headers (including optional token), performs a PUT fetch request, handles errors, and returns the response or error.

  const executeFunction = async ({ webhookId, name, targetUrl, secret, status }) => {
  
    try {
      // Construct the URL with the webhook ID
      const url = getWebexUrl('/webhooks/${webhookId}');
  
      // Prepare the request body
      const body = JSON.stringify({
        name,
        targetUrl,
        secret,
        ownedBy: 'org',
        status
      });
  
      // Set up headers for the request
      const headers = {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
      };
  
      // If a token is provided, add it to the Authorization header
      if (token) {
        headers['Authorization'] = `Bearer ${token}`;
      }
  
      // 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 webhook:', error);
      return { error: 'An error occurred while updating the webhook.' };
    }
  };

• tools/webex-public-workspace/webex-messaging/update-a-webhook.js:70-99 (schema)

  The JSON schema definition for the update_webhook tool, including name, description, input parameters (webhookId, name, targetUrl, secret, status), and required fields.

      name: 'update_webhook',
      description: 'Update a webhook in Webex.',
      parameters: {
        type: 'object',
        properties: {
          webhookId: {
            type: 'string',
            description: 'The unique identifier for the webhook.'
          },
          name: {
            type: 'string',
            description: 'The name of the webhook.'
          },
          targetUrl: {
            type: 'string',
            description: 'The target URL for the webhook.'
          },
          secret: {
            type: 'string',
            description: 'The secret for the webhook.'
          },
          status: {
            type: 'string',
            description: 'The status of the webhook (e.g., active).'
          }
        },
        required: ['webhookId', 'name', 'event']
      }
    }
  }

• tools/webex-public-workspace/webex-messaging/update-a-webhook.js:65-102 (registration)

  The apiTool export that packages the handler function and schema definition, intended for registration in the MCP tools registry.

  const apiTool = {
    function: executeFunction,
    definition: {
      type: 'function',
      function: {
        name: 'update_webhook',
        description: 'Update a webhook in Webex.',
        parameters: {
          type: 'object',
          properties: {
            webhookId: {
              type: 'string',
              description: 'The unique identifier for the webhook.'
            },
            name: {
              type: 'string',
              description: 'The name of the webhook.'
            },
            targetUrl: {
              type: 'string',
              description: 'The target URL for the webhook.'
            },
            secret: {
              type: 'string',
              description: 'The secret for the webhook.'
            },
            status: {
              type: 'string',
              description: 'The status of the webhook (e.g., active).'
            }
          },
          required: ['webhookId', 'name', 'event']
        }
      }
    }
  };
  
  export { apiTool };