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_KEYis 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
.envfile or Claude Desktop config - Check: Copy
.env.exampleto.envand fill in your API credentials
Error: "Authentication failed"
- Solution: Verify your API keys in the LicenseSpring dashboard
- Note:
LICENSE_SHARED_KEYis 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.