Webex MCP Server

Instructions

Implementation Reference

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

  The core handler function `executeFunction` that implements the tool logic: fetches message details from Webex API using the `messageId`, handles HTTP errors, and returns the JSON response or an error object.

  const executeFunction = async ({ messageId }) => {
  
    try {
      // Construct the URL with the message ID
      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: 'GET',
        headers
      });
  
      // Check if the response was successful
      if (!response.ok) {
        const errorData = await response.json();
        throw new Error(JSON.stringify(errorData));
      }
  
      // Parse and return the response data
      const data = await response.json();
      return data;
    } catch (error) {
      console.error('Error fetching message details:', error);
      return {
        error: error.message || 'An error occurred while fetching message details.',
        details: error.stack
      };
    }
  };

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

  The input parameters schema specifying a required `messageId` string for the tool.

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

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

  Central registration/discovery function that dynamically imports all Webex tool modules (including get-message-details.js) via paths.js and spreads their `apiTool` definitions to register them as MCP 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:16-16 (registration)

  The path to the get_message_details tool file, listed for use in dynamic tool discovery and registration.

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