LicenseSpring MCP Server

Instructions

Implementation Reference

• src/license-api-server.ts:492-524 (handler)

  Complete tool registration, input schema, and handler implementation. The handler constructs query parameters from inputs and fetches device variables from the LicenseSpring API endpoint `/api/v4/get_device_variables`, returning the JSON response or an error.

  server.registerTool('get_device_variables', {
    title: 'Get Device Variables',
    description: 'Get tracked variables for a device',
    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/get_device_variables?${queryParams}`);
  
      return {
        content: [{
          type: 'text',
          text: JSON.stringify(response.data, null, 2),
        }],
      };
    } catch (error) {
      return {
        content: [{
          type: 'text',
          text: `Error getting device variables: ${handleApiError(error)}`,
        }],
        isError: true,
      };
    }
  });

• src/types/index.ts:66-70 (schema)

  TypeScript interface defining the request parameters for the get_device_variables tool: license_key, hardware_id, and product.

  export interface GetDeviceVariablesRequest {
    license_key: string;
    hardware_id: string;
    product: string;
  }