netlicensing-mcp

MCP (Model Context Protocol) server for the Labs64 NetLicensing REST API.
Lets Claude, GitHub Copilot, and any MCP-compatible AI agent manage your software licenses conversationally.

---

Features

Area	Tools
Products	list, get, create, update, delete
Product Modules	list, get, create, update, delete
License Templates	list, get, create, update, delete
Licensees	list, get, create, update, delete, validate, transfer
Licenses	list, get, create, update (activate/deactivate), delete
Tokens	list, create shop URL, create API token, revoke
Audit Prompts	full account, single customer, expiry sweep, cleanup, anomaly detection

---

Quick Start

Option A — uvx (no install required)

NETLICENSING_API_KEY=your_key uvx netlicensing-mcp

Option B — pip

pip install netlicensing-mcp
NETLICENSING_API_KEY=your_key netlicensing-mcp

Option C — Docker

docker run -i --rm \
  -e NETLICENSING_API_KEY=your_key \
  ghcr.io/yourusername/netlicensing-mcp:latest

No API key? Leave NETLICENSING_API_KEY empty to use NetLicensing's built-in demo credentials against sandbox data.

---

Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "netlicensing": {
      "command": "uvx",
      "args": ["netlicensing-mcp"],
      "env": {
        "NETLICENSING_API_KEY": "your_key_here"
      }
    }
  }
}

VS Code / GitHub Copilot

The repo ships a .vscode/mcp.json that auto-configures Copilot Agent mode. Set NETLICENSING_API_KEY in your shell environment or a .env file and click Start in the editor banner that appears above mcp.json.

JetBrains / IntelliJ IDEA

In Copilot Chat → Agent mode → Tools icon → Add More Tools… — paste the same JSON block as the Claude Desktop config above.

---

Development

git clone https://github.com/yourusername/netlicensing-mcp
cd netlicensing-mcp

python -m venv .venv
source .venv/bin/activate       # Windows: .venv\Scripts\activate

pip install -e ".[dev]"
cp .env.example .env            # add your API key

# Run the MCP Inspector (browser UI at http://localhost:5173)
mcp dev src/netlicensing_mcp/server.py

# Run tests
pytest tests/ -v

HTTP mode (for remote / shared deployments)

python -m netlicensing_mcp.server http
# Server listens on 0.0.0.0:8000

---

Audit Prompt Templates

Five built-in prompts accessible in Copilot Agent and Claude Desktop:

Prompt	Purpose
license_audit_full	End-to-end account audit for a product
license_audit_customer	Deep-dive on a single licensee
license_audit_expiry	Find licenses expiring within N days + generate renewal URLs
license_audit_cleanup	Identify inactive / orphaned licenses for cleanup
license_audit_anomaly	Detect unusual usage patterns across all customers

---

Deployment

Publish a release to PyPI + GHCR + MCP Registry

git tag v1.0.0
git push origin v1.0.0

The publish.yml GitHub Actions workflow automatically:

1. Runs the full test suite
2. Publishes to PyPI (via OIDC trusted publishing — no token needed)
3. Builds and pushes a Docker image to ghcr.io
4. Registers the server in the MCP Registry
5. Creates a GitHub Release with install instructions

One-time setup required

• PyPI: configure trusted publishing for this repo at pypi.org/manage/account/publishing
• MCP Registry: add MCP_PUBLISHER_TOKEN to your repo secrets (Settings → Secrets → Actions)

---

License

Apache 2.0 — see LICENSE.