LicenseSpring

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

- 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

- 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

- 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
- 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)

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.

Add this to yourclaude_desktop_config.json:

{ "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" } } } }

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

{ "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" } } } }

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.

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:

{ "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}" } } } } }

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

- Check: Your LicenseSpring subscription tier and available API features
- Solution: The server provides helpful guidance for subscription limitations
- Check the error messages - they provide specific guidance
- Verify your LicenseSpring subscription tier and API access
- Review theAdvanced Documentationbelow
- Open an issue on GitHub with error details

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)

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

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

For complete automation documentation, seeRelease Automation Guide.

- 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

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

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

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

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

A local stdio MCP server that proxies to a remote, OAuth2-protected HTTP MCP server.