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

1. License API Key: Log into your LicenseSpring dashboard → Settings → Keys (PRIMARY authentication method)

2. Management API Key: Same location, copy your Management API Key

3. Shared Key: Optional for organizations using shared API settings (provides enhanced security)

Testing

Run the comprehensive integration test to validate functionality:

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

Management API Server

Docker

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

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

1. Check the error messages - they provide specific guidance

2. Verify your LicenseSpring subscription tier and API access

3. Review the Advanced Documentation below

4. Open an issue on GitHub with error details

Release Automation

This project includes comprehensive automated release versioning and NPM distribution:

Quick Release Commands

Preview Changes

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

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

Docker Images

Build

Docker build:

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.