# Nalpeiron V10 MCP

> Nalpeiron V10 connects your AI agent directly to your license management backend. This server lets you automate core entitlement functions: activate, deactivate, and track licenses for desktop or cloud apps. You can query usage analytics, list all active customer accounts, and audit product entitlements using simple conversation prompts.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** software-licensing, entitlement-management, activation-tracking, license-keys, saas-security

## Description

Nalpeiron V10 connects your AI agent right into your license management backend. This server lets you automate core entitlement functions without ever having to log into a dashboard or mess with complex UIs. Your agent can handle everything from activating a new seat to running usage reports, all through simple conversation prompts.

### Managing the Core Inventory

You've got to know what you own first. You can list every single product you manage using `list_products`, giving you definitions for all the software lines in your portfolio. Want specifics on one of those products? Just ask, and `get_product` pulls that general info for you.

For licenses themselves, use `list_licenses` to generate a full inventory list of every available code out there. If you need deep technical metadata—like the exact rules governing a specific license—run `get_license` with just the code. You can also pull a complete directory of all registered accounts by calling `list_customers`.

### Controlling Entitlements and Access

This is where you make things happen. To get someone started, use `activate_license`. This tool requires both the license code and the unique machine identifier so it can correctly turn that entitlement on. When a customer leaves or changes setups, you need to cut off access immediately; run `deactivate_license` to revoke operational rights instantly.

### Auditing Usage and Tracking History

You gotta keep tabs on usage. Run `get_analytics` whenever you need real-time reports detailing how the product is being used across different features or geographical regions. For a full audit trail, use `list_activations`. This tool lists every current and historical activation record for compliance checks.

You can always check system health first; running `check_nalpeiron_status` verifies that your AI client's connection to the Nalpeiron API is active and ready to go. You’ll find all these tools working together, letting you manage licenses, audit usage, and track customers directly through your agent.

## Tools

### activate_license
Activates a specific software license using both its code and the machine's unique identifier.

### check_nalpeiron_status
Verifies if the Nalpeiron API connection is working correctly for immediate service status checks.

### deactivate_license
Deactivates a specific license, immediately revoking its operational access.

### get_analytics
Runs usage reports to give you detailed statistics on how the product is being used across regions and features.

### get_license
Pulls all technical details for a specific license code.

### get_product
Retrieves general information about a named product within the system.

### list_activations
Lists every current and historical record of license activations for auditing purposes.

### list_customers
Retrieves a complete list of all customer profiles managed in your system.

### list_licenses
Generates a comprehensive list of every available license code in the portfolio.

### list_products
Lists all defined products that are managed within your Nalpeiron account.

## Prompt Examples

**Prompt:** 
```
List all products in my Nalpeiron account.
```

**Response:** 
```
You have 5 products registered. 'ProEditor v3' has 245 active licenses and 'DataSync Plus' has 89. Would you like to see activation details or usage analytics?
```

**Prompt:** 
```
Activate license LIC-9821 on machine MAC-4501.
```

**Response:** 
```
License LIC-9821 activated on machine MAC-4501. This license now has 2 of 3 allowed activations in use. Would you like to check the remaining activation slots?
```

**Prompt:** 
```
Show usage analytics for product PROD-101.
```

**Response:** 
```
Product PROD-101: 245 total activations, 12 new this month. Most active region: North America (68%). Feature usage: Export (92%), Import (78%), API (45%). Would you like customer-level breakdown?
```

## Capabilities

### Manage License Inventory
Use tools like `list_products` or `get_license` to pull detailed technical metadata about every software item and its current status.

### Control Entitlement Lifecycle
Activate new licenses using `activate_license`, or revoke access immediately by running the `deactivate_license` tool.

### Audit Usage and Customers
Run `get_analytics` to view real-time usage volume, or use `list_customers` to pull a directory of all registered accounts.

## Use Cases

### Support ticket requires immediate license verification.
A client calls saying their software access stopped. Instead of asking the user to email screenshots or logging into a separate portal, you tell your agent: 'Check status for customer XYZ.' The agent runs `list_customers` and then `get_license`, confirming if the account is active and if the license was recently deactivated.

### Quarterly Product Review Audit.
The PM needs to know which product line (e.g., ProEditor v3) is growing fastest. They prompt the agent: 'Show usage analytics for ProEditor v3.' The agent uses `get_analytics`, providing a breakdown of total activations and feature adoption rates in one response.

### Mass License Cleanup.
An Ops Lead identifies 50 unused licenses through the system. They prompt: 'Deactivate these keys.' The agent executes `deactivate_license` for all codes, ensuring no old or orphaned entitlements remain active.

### Initial Product Onboarding.
A new product needs to be added to the system's inventory. The agent first runs `list_products` to check existing definitions, then uses `get_product` to verify details before the manual entry is finalized.

## Benefits

- Automate activation/deactivation. Don't manually log in to run `activate_license` or `deactivate_license`. Your agent handles the API calls instantly.
- Real-time usage data. Use `get_analytics` to see which features are hot and where your users operate, without running complex database queries yourself.
- Instant customer lookup. Running `list_customers` pulls all account details immediately. You don't waste time clicking through segmented dashboards just to find one user ID.
- Full audit trail. The combination of `list_activations` and `get_license` lets you build a perfect, verifiable history for any single license key.
- System health check. Need to know if the connection is live? Just run `check_nalpeiron_status`. It's faster than checking three different dashboard panels.

## How It Works

The bottom line is: your AI client acts as a dedicated coordinator, giving you immediate access to license status without manual dashboard navigation.

1. Subscribe to the Nalpeiron V10 server and grab your required credentials: Customer ID, Username, and Password from the dashboard.
2. Connect your preferred AI client (Claude, Cursor, etc.) to the server using these credentials.
3. Start issuing commands naturally. Your agent executes the specific tools (`list_customers`, `activate_license`, etc.) and returns structured data you can read.

## Frequently Asked Questions

**How do I check if my Nalpeiron V10 server connection is working?**
Run the `check_nalpeiron_status` tool. This verifies API connectivity immediately, letting you know whether to trust the data or check your credentials first.

**Can I use Nalpeiron V10 to find a customer's active licenses?**
Yes. First, run `list_customers` to get the ID. Then, you can ask for that customer's specific license details using `get_license`.

**What is the difference between `list_licenses` and `list_products`?**
`list_products` shows all types of software you sell (e.g., 'ProEditor v3'). `list_licenses` shows every single, available code key that can be used to activate those products.

**How do I track usage metrics using Nalpeiron V10?**
Use the `get_analytics` tool. This provides detailed reports on total activations and feature-specific usage percentages, giving you real performance data.

**Before running any command, what credentials does Nalpeiron V10 require for my AI agent?**
You need your Customer ID, Username, and Password. You retrieve these three items from your Nalpeiron V10 dashboard. Your AI client uses these details to authenticate the connection before executing any tool calls.

**If I run `activate_license` using Nalpeiron V10, what happens if the activation fails?**
The agent provides a specific error code and reason for failure. This usually means the license key is invalid or that your organization has hit its quota limit. You can use this feedback to troubleshoot immediately.

**When I use `list_activations` versus using `get_license`, what data depth do I get?**
`list_activations` gives you a comprehensive list of all recorded activations. However, if you run `get_license`, you retrieve the deep technical metadata and current status for one specific license code only.

**How should my agent handle deactivating an old key using Nalpeiron V10?**
You simply ask your AI client to run `deactivate_license`. This action removes the usage from the active count and ensures that license slot is available for future activations. It keeps your audit trail clean.

**How do I activate a software license via AI?**
Use the `activate_license` tool with the license code and machine identifier. The activation is processed instantly through the Nalpeiron licensing server.

**Can I view usage analytics for my products?**
Yes. Use `get_analytics` with the product ID to retrieve usage telemetry, activation trends, and feature usage statistics.

**How do I deactivate a license from a machine?**
Use `deactivate_license` with the license code and machine ID. This frees up the activation slot for reuse on another device.