npm package: @genxis/whmrockstar
Description: GenXis WHMRockStar - AI-powered multi-server WHM/cPanel management via Model Context Protocol. Enhanced with TypeScript support, comprehensive IDE integration, and advanced tool discovery for seamless AI development workflows.
Author: GenXis
Latest version: 2.2.5

﻿# GenXis WHMRockStar v2.2.5

[![npm version](https://img.shields.io/npm/v/%40genxis%2Fwhmrockstar.svg)](https://www.npmjs.com/package/@genxis/whmrockstar)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
![Node.js Version](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen)

AI-powered multi-server WHM/cPanel management via Model Context Protocol (MCP).

## Table of Contents
- [Quick Start](#quick-start)
- [CLI](#cli)
- [IDE Integration](#ide-integration)
- [TypeScript](#typescript)
- [Schemas](#schemas)
- [Security Notes](#security-notes)
- [Migration from 2.1.x](#migration-from-21x)
- [What's New in v2.2](#whats-new-in-v22)
- [Paths and Resources](#paths-and-resources)
- [Validate your install](#validate-your-install)
- [Support](#support)

## Quick Start
```bash
# One-line setup
npx @genxis/whmrockstar setup

# Start MCP server (for IDEs)
npx @genxis/whmrockstar start
```

## CLI
```bash
# Introspect available tools
npx @genxis/whmrockstar introspect

# Export schemas (machine-readable)
npx @genxis/whmrockstar export-schema all > whm-schemas.json

# Generate IDE configs
npx @genxis/whmrockstar generate-ide-config vscode
npx @genxis/whmrockstar generate-ide-config windsurf
npx @genxis/whmrockstar generate-ide-config claude
npx @genxis/whmrockstar generate-ide-config jetbrains
```

## IDE Integration
- Templates for VS Code, Windsurf, Claude Desktop, JetBrains live under `templates/`.
- MCP stdio server is exposed by the `start` script for IDEs.

## TypeScript
- Type definitions are provided in `types/` and `types/index.d.ts`.
- Import in TS projects for autocomplete and type safety.

## Schemas
- Machine-readable tool definitions in `schemas/` for AI/IDE discovery.
- Includes:
  - MCP tool schema: `schemas/mcp-tools.json`
  - WHM API reference: `schemas/whm-api-reference.json`
  - Examples index: `schemas/examples.json`
  - Server config schema: `schemas/server-config-schema.json`

## Security Notes
- No real IPs/tokens are included in examples.
- Prefer `verifyTLS: true` with a valid certificate or provide a custom CA.

## Migration from 2.1.x
- No breaking changes to existing commands.
- New CLI verbs are additive: `export-schema`, `generate-ide-config`, `introspect`, `describe-tools`.
- If you vendor configs, consider validating them against `schemas/server-config-schema.json`.

## What's New in v2.2
- TypeScript definitions (types/) for IDE autocompletion and type safety
- Machine-readable MCP tool schemas (schemas/) for AI/IDE discovery
- IDE templates (templates/): VS Code, Windsurf, Claude Desktop, JetBrains
- New CLI verbs:
  - `genxis-whm export-schema [all|mcp-tools|whm-api]`
  - `genxis-whm generate-ide-config <vscode|windsurf|claude|jetbrains>`
  - `genxis-whm introspect`
  - `genxis-whm describe-tools`

## Paths and Resources
- TypeScript types: [`types/index.d.ts`](./types/index.d.ts)
- MCP tool schema: [`schemas/mcp-tools.json`](./schemas/mcp-tools.json)
- WHM API reference: [`schemas/whm-api-reference.json`](./schemas/whm-api-reference.json)
- Examples index: [`schemas/examples.json`](./schemas/examples.json)
- Server config schema: [`schemas/server-config-schema.json`](./schemas/server-config-schema.json)
- IDE templates: [`templates/`](./templates/)

## Validate your install
```bash
# From the package root
node -e "console.log(require('./package.json').version)"  # should print 2.2.x
npx @genxis/whmrockstar introspect                      # should list tools
npm pack --dry-run                                      # shows publish contents
```

## Support
- NPM: https://www.npmjs.com/package/@genxis/whmrockstar
- Issues: https://github.com/genxis/genxis-whmrockstar/issues
- License: MIT