Webex MCP Server

Instructions

Implementation Reference

• tools/webex-public-workspace/webex-messaging/get-event-details.js:9-37 (handler)

  The handler function that performs a GET request to the Webex API to retrieve details for the specified event ID, handling errors and returning the data or error message.

  const executeFunction = async ({ eventId }) => {
  
    try {
      // Construct the URL with the event ID
      const url = getWebexUrl('/events/${encodeURIComponent(eventId)}');
  
      // Set up headers for the request
      const headers = getWebexHeaders();
  
      // Perform the fetch request
      const response = await fetch(url, {
        method: 'GET',
        headers
      });
  
      // 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 fetching event details:', error);
      return { error: 'An error occurred while fetching event details.' };
    }
  };

• tools/webex-public-workspace/webex-messaging/get-event-details.js:43-62 (schema)

  Defines the tool's schema including the name 'get_event_details', description, input parameters schema requiring 'eventId' as string, and references the handler function.

  const apiTool = {
    function: executeFunction,
    definition: {
      type: 'function',
      function: {
        name: 'get_event_details',
        description: 'Get details for a specific event by event ID.',
        parameters: {
          type: 'object',
          properties: {
            eventId: {
              type: 'string',
              description: 'The unique identifier for the event.'
            }
          },
          required: ['eventId']
        }
      }
    }
  };

• lib/tools.js:7-16 (registration)

  Registers the tool by dynamically importing the apiTool from each path in toolPaths (including get-event-details.js) and collecting them into an array of tools.

  export async function discoverTools() {
    const toolPromises = toolPaths.map(async (file) => {
      const module = await import(`../tools/${file}`);
      return {
        ...module.apiTool,
        path: file,
      };
    });
    return Promise.all(toolPromises);
  }

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

  Includes the path to the get_event_details tool file in the list of all tool paths used for dynamic loading.

  'webex-public-workspace/webex-messaging/get-event-details.js',