LicenseSpring® MCP Server

An MCP server implementation that integrates with LicenseSpring APIs, providing comprehensive license management and customer operations capabilities.

Features

License Operations: Activate, check, deactivate licenses with hardware binding
Customer Management: Create, list, and manage customers
Usage Tracking: Monitor license consumption and feature usage
Trial Management: Generate and manage trial licenses
Floating Licenses: Handle floating license operations
Authentication Priority: LICENSE_API_KEY as primary method, LICENSE_SHARED_KEY optional for enhanced security
Comprehensive Testing: Full integration test suite with real API validation

Tools

License API Tools

activate_license - Activate a license with hardware ID binding
check_license - Check license status and validity
deactivate_license - Deactivate a license for specific hardware
add_consumption - Add consumption units to a license
get_trial_key - Generate trial license keys
get_product_details - Retrieve product information
floating_release - Release floating licenses
floating_borrow - Borrow floating licenses for offline use
change_password - Change user passwords for user-based licenses
get_versions - Get available software versions
get_installation_file - Get installation file information
get_sso_url - Generate Single Sign-On URLs

Management API Tools

list_licenses - List licenses with optional filtering
create_license - Create new licenses
update_license - Update existing licenses
get_license - Get detailed license information
delete_license - Delete licenses
list_customers - List customers with filtering options
create_customer - Create new customers

Configuration

Getting API Credentials

License API Key: Log into your LicenseSpring dashboard → Settings → Keys (PRIMARY authentication method)
Management API Key: Same location, copy your Management API Key
Shared Key: Optional for organizations using shared API settings (provides enhanced security)

Testing

Run the comprehensive integration test to validate functionality:

# Build the project
npm run build

# Run integration tests against real LicenseSpring API
npm run test:integration

# Run unit tests
npm test

The integration test validates all 34 MCP tools against the real LicenseSpring API and verifies authentication priority works correctly. The implementation provides 100% feature parity with the LicenseSpring Postman collection.

🔧 CI/CD Integration: GitHub Actions workflows now support full integration testing with proper secret configuration.

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

License API Server

{
  "mcpServers": {
    "licensespring": {
      "command": "npx",
      "args": [
        "-y",
        "@tfedorko/licensespring-mcp-server",
        "license-api"
      ],
      "env": {
        "LICENSE_API_KEY": "YOUR_LICENSE_API_KEY",
        "LICENSE_SHARED_KEY": "YOUR_SHARED_KEY_IF_USING_SHARED_API_SETTINGS"
      }
    }
  }
}

Management API Server

{
  "mcpServers": {
    "licensespring-management": {
      "command": "npx",
      "args": [
        "-y",
        "@tfedorko/licensespring-mcp-server",
        "management-api"
      ],
      "env": {
        "MANAGEMENT_API_KEY": "YOUR_MANAGEMENT_API_KEY"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "licensespring": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "LICENSE_API_KEY",
        "-e",
        "LICENSE_SHARED_KEY",
        "stiertfedorko/licensespring-mcp:latest"
      ],
      "env": {
        "LICENSE_API_KEY": "YOUR_LICENSE_API_KEY",
        "LICENSE_SHARED_KEY": "YOUR_SHARED_KEY_OR_LEAVE_EMPTY"
      }
    },
    "licensespring-management": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MANAGEMENT_API_KEY",
        "stiertfedorko/licensespring-mcp-management:latest"
      ],
      "env": {
        "MANAGEMENT_API_KEY": "YOUR_MANAGEMENT_API_KEY"
      }
    }
  }
}

Subscription Tier Support

The server automatically adapts to your LicenseSpring subscription tier:

Premium/Enterprise: Full functionality with HMAC authentication
Basic/Standard: Limited mode with helpful upgrade guidance
Development: Test mode for safe development

Note: LICENSE_SHARED_KEY is optional. The server will start regardless of your subscription tier and provide appropriate guidance for API limitations.

Usage with VS Code

For quick installation, use the one-click installation buttons below:

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code:

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "license_api_key",
        "description": "LicenseSpring License API Key",
        "password": true
      },
      {
        "type": "promptString",
        "id": "license_shared_key",
        "description": "LicenseSpring Shared Key (optional for Basic/Standard tiers)",
        "password": true
      }
    ],
    "servers": {
      "licensespring": {
        "command": "npx",
        "args": ["-y", "@tfedorko/licensespring-mcp-server", "license-api"],
        "env": {
          "LICENSE_API_KEY": "${input:license_api_key}",
          "LICENSE_SHARED_KEY": "${input:license_shared_key}"
        }
      }
    }
  }
}

Troubleshooting

Common Issues

Error: "npm error could not determine executable to run"

Solution: Update to version 1.0.1 or later: npx @tfedorko/licensespring-mcp-server@latest
Cause: Fixed in v1.0.1 - improved binary configuration and startup process

Error: "MCP error -1: Connection closed"

Solution: Update to version 1.0.2 or later: npx @tfedorko/licensespring-mcp-server@latest
Cause: Fixed in v1.0.2 - server now defaults to license-api mode for Claude Desktop compatibility

Error: "LICENSE_API_KEY is required"

Solution: Set your environment variables in .env file or Claude Desktop config
Check: Copy .env.example to .env and fill in your API credentials

Error: "Authentication failed"

Solution: Verify your API keys in the LicenseSpring dashboard
Note: LICENSE_SHARED_KEY is optional for Basic/Standard subscription tiers

Server starts but API calls fail

Check: Your LicenseSpring subscription tier and available API features
Solution: The server provides helpful guidance for subscription limitations

Getting Help

Check the error messages - they provide specific guidance
Verify your LicenseSpring subscription tier and API access
Review the Advanced Documentation below
Open an issue on GitHub with error details

Release Automation

This project includes comprehensive automated release versioning and NPM distribution:

Quick Release Commands

npm run release          # Patch release (1.0.0 -> 1.0.1)
npm run release:minor    # Minor release (1.0.0 -> 1.1.0)
npm run release:major    # Major release (1.0.0 -> 2.0.0)

Preview Changes

npm run version:dry      # Preview version bump
npm run publish:dry      # Preview NPM publish

Automated GitHub Releases

Commit triggers: Use [release] in commit messages
Manual dispatch: GitHub Actions workflow
Semantic release: Conventional commit messages

For complete automation documentation, see Release Automation Guide.

Advanced Documentation

For comprehensive guides and advanced configuration:

Release Automation Guide - Complete automated release and distribution system
Subscription Tier Support - Detailed guide for different LicenseSpring subscription tiers
Distribution Guide - Complete setup and sharing instructions
Test Report - Comprehensive testing results and validation
Migration Guide - Technical implementation details

Installation

NPM Package

npm install -g @tfedorko/licensespring-mcp-server

Note: Requires Node.js 20.x or higher for optimal compatibility.

Docker Images

# License API Server
docker pull stiertfedorko/licensespring-mcp:latest

# Management API Server
docker pull stiertfedorko/licensespring-mcp-management:latest

Build

Docker build:

docker build -t licensespring-mcp:latest -f Dockerfile .
docker build -t licensespring-mcp-management:latest -f Dockerfile.management .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Trademark Notice

This project uses the LicenseSpring® name under permission from Cense Data Inc. See the TRADEMARK file for details.