Illuminati Networks MCP server — drive VPS, proxies, and CDN/object-storage from any MCP client (Claude, etc.).
35 tools with consistent naming (verb_noun pattern) and basic schemas. All tools have descriptions (10-200 chars, mostly adequate). Input schemas present for all tools with proper type definitions. However, parameter descriptions are MISSING, the code shows only type definitions, no explanatory text for what each parameter controls. Output schemas are undocumented. Error handling and recovery guidance absent. No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Parameter constraints (enums, ranges, formats) are minimal. This is a functional but under-documented toolkit typical of community servers.
Get account profile + balance.
Get current prepaid balance.
Cancel a queued build (a running build stops at its timeout).
Create a CI-on-push trigger: returns a webhook URL + secret (shown ONCE) to add to your repo so every matching push auto-builds the pushed commit. `repoToken` (GitHub PAT w/ repo:status, or GitLab api token) enables green/red commit status checks. `branch` limits to one branch (omit = all). `env` is secret build vars.
Delete a build trigger (its webhook stops firing immediately).
Get a build with its artifacts (signed download URLs + sha256) and log URL.
Parameter descriptions completely absent. Code shows only type definitions (num, str) with no explanatory text. LLMs cannot infer what 'bandwidthGb', 'region', 'env', 'templateId' control without descriptions. Violates pattern:tool-description baseline (100% of A+ tools have param descriptions).
Output schemas undocumented. No visible schema definitions for tool responses. LLMs cannot plan downstream calls or extract required fields (e.g., does cdn_create_zone return hostname, upload_token, zone_id?). Violates pattern:tool baseline (100% of A+ tools document return types).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
List available build images (OS + toolchain + per-minute price).
List your build jobs (most recent first).
List your build triggers (secrets are never returned).
Submit a build. The repo must carry a committed build spec. Charged from prepaid balance. `env` is SECRET env (signing keys, tokens) injected at run time, never committed. `specPath` selects the spec file (default .illuminati-build.yml) for matrix builds.
List CDN/object-storage products and pricing.
Provision a new CDN zone (charged from prepaid balance). Returns its hostname + upload token.
Delete one object from a zone.
Cancel and tear down a CDN zone.
Get a CDN zone (incl. hostname, usage, upload token).
List objects in a zone.
List the account's CDN zones.
Set a zone's allowed CORS origins (comma-separated or "*").
Set a zone public or private.
Mint a time-limited signed URL for a private-zone object.
Add prepaid bandwidth GB to a zone (raises the hard cap).
Upload text content to a zone at the given key (served from the zone hostname).
List proxy products + pricing.
Provision a proxy plan (charged from prepaid balance).
Get one proxy plan (credentials + endpoints).
List your active proxy plans.
Get a time-limited noVNC console ticket for a VPS.
Provision a new VPS (charged from prepaid balance).
Take a VPS snapshot (name: 1-40 chars of [a-z0-9-]).
Delete a VPS snapshot by name.
Get one VPS (full detail).
List your VPS instances.
Power action on a VPS.
Reinstall a VPS with a new OS template (async re-provision).
List a VPS's snapshots.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Risk levels are declared in the spec (READ_ONLY, WRITE, DESTRUCTIVE) but not exposed in tool definitions. LLMs cannot distinguish safe reads from destructive operations without explicit hints.
No error handling or recovery guidance. No visible error responses, validation messages, or actionable recovery hints. If a tool fails, LLMs have no guidance on retry strategy, user-fixable issues, or next steps.
Minimal parameter constraints. Most parameters lack enums, ranges, or format specifications. E.g., 'region' is free-form string (should enumerate valid regions); 'bandwidthGb' unbounded (should specify min/max); 'action' in vps_power has enum but others don't.