LicenseSpring MCP Server

Instructions

Implementation Reference

• src/license-api-server.ts:669-693 (handler)

  The asynchronous handler function that performs an API GET request to fetch installation file data using the provided license_key, hardware_id, and product parameters. It returns the JSON response or an error message.

  }, async ({ license_key, hardware_id, product }) => {
    try {
      const queryParams = new URLSearchParams({
        license_key,
        hardware_id,
        product,
      });
      const response = await apiClient.get(`/api/v4/installation_file?${queryParams}`);
  
      return {
        content: [{
          type: 'text',
          text: JSON.stringify(response.data, null, 2),
        }],
      };
    } catch (error) {
      return {
        content: [{
          type: 'text',
          text: `Error getting installation file: ${handleApiError(error)}`,
        }],
        isError: true,
      };
    }
  });

• src/license-api-server.ts:664-668 (schema)

  Zod-based input schema defining required string parameters: license_key, hardware_id, and product.

  inputSchema: {
    license_key: z.string().min(1, 'License key is required'),
    hardware_id: z.string().min(1, 'Hardware ID is required'),
    product: z.string().min(1, 'Product code is required'),
  },

• src/license-api-server.ts:661-693 (registration)

  Registers the 'get_installation_file' tool on the MCP server with title, description, input schema, and inline handler function.

  server.registerTool('get_installation_file', {
    title: 'Get Installation File',
    description: 'Get installation file download information',
    inputSchema: {
      license_key: z.string().min(1, 'License key is required'),
      hardware_id: z.string().min(1, 'Hardware ID is required'),
      product: z.string().min(1, 'Product code is required'),
    },
  }, async ({ license_key, hardware_id, product }) => {
    try {
      const queryParams = new URLSearchParams({
        license_key,
        hardware_id,
        product,
      });
      const response = await apiClient.get(`/api/v4/installation_file?${queryParams}`);
  
      return {
        content: [{
          type: 'text',
          text: JSON.stringify(response.data, null, 2),
        }],
      };
    } catch (error) {
      return {
        content: [{
          type: 'text',
          text: `Error getting installation file: ${handleApiError(error)}`,
        }],
        isError: true,
      };
    }
  });