mcp-prompt-optimizer 3.7.2 → 3.7.3

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.7.3] - 2026-07-16
+
+### Fixed
+- **Stale free-tier quota in README**: docs said 7 optimizations/month, live enforcement is 20. Docs-only fix, no code change.
+
 ## [3.7.2] - 2026-07-05
 
 ### Fixed

package/README.md

@@ -26,7 +26,7 @@
 
 **1. Get your API key:**
 
-- **🆓 Free Tier** (`sk-opt-*`): 7 LLM optimizations/month, 1 API key — no credit card required
+- **🆓 Free Tier** (`sk-opt-*`): 20 LLM optimizations/month, 1 API key — no credit card required
 - **⭐ Pro** (`sk-opt-*`): 500 optimizations/month, full model config, Context Engineer
 - **🏢 Enterprise** (`sk-team-*`): Unlimited optimizations, team keys, shared quotas
 
@@ -352,7 +352,7 @@ Configure custom models in the WebUI and the MCP server uses them automatically.
 
 | Plan | Price | Optimizations/month | CE Credits | API Keys |
 |---|---|---|---|---|
-| 🆓 Free | $0 | 7 LLM | — | 1 |
+| 🆓 Free | $0 | 20 LLM | — | 1 |
 | ⭐ Pro | $19/mo | 500 | 5 | 1 |
 | 🏢 Enterprise | Custom | Unlimited | 50 | 10 (shared) |
 
@@ -501,4 +501,4 @@ Windsurf, Cline, VS Code, Zed, Replit, JetBrains IDEs, and Neovim are all suppor
 
 ---
 
-*Start free at [promptoptimizer.xyz](https://promptoptimizer.xyz) — 7 LLM optimizations/month, no credit card required.*
+*Start free at [promptoptimizer.xyz](https://promptoptimizer.xyz) — 20 LLM optimizations/month, no credit card required.*

package/index.js

@@ -57,6 +57,18 @@ const ENDPOINTS = {
   /** AG‑UI status (GET) */
   AGUI_STATUS:         '/api/status',
 
+  /** Prompt delivery by slug */
+  GET_PROMPT_BY_SLUG:      (slug) => `/api/v1/prompts/${slug}`,
+  COMPILE_PROMPT:          (slug) => `/api/v1/prompts/${slug}/compiled`,
+
+  /** Template governance (versioning, publish) */
+  TEMPLATE_VERSIONS:       (id) => `/api/v1/templates/${id}/versions`,
+  ROLLBACK_TEMPLATE:       (id, n) => `/api/v1/templates/${id}/rollback/${n}`,
+  PUBLISH_TEMPLATE:        (id) => `/api/v1/templates/${id}/publish`,
+
+  /** Quick evaluation (stateless) */
+  QUICK_EVALUATE:          '/api/v1/evaluations/quick-evaluate',
+
   /** Context Engineer (CE) endpoints */
   CE: {
     SOP:                     '/api/v1/context-engineer/sop',
@@ -73,7 +85,8 @@ const ENDPOINTS = {
 const DEPLOY_TARGET_ENUM = [
   "claude_code", "claude_desktop", "cursor", "copilot",
   "windsurf", "cline", "zed", "replit", "openai_agents", "ollama",
-  "amazon_q", "aider", "continue_dev", "crewai"
+  "amazon_q", "aider", "continue_dev", "crewai",
+  "codex_cli",
 ];
 
 class MCPPromptOptimizer {
@@ -465,6 +478,79 @@ class MCPPromptOptimizer {
             additionalProperties: false
           }
         },
+        {
+          name: "get_prompt_by_slug",
+          description: "Fetch your latest published prompt template by slug for runtime use — decouple prompts from deploys.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              slug: { type: "string", description: "The URL-safe slug of the prompt template (e.g., product-writer-a3f9c21b)" }
+            },
+            required: ["slug"]
+          }
+        },
+        {
+          name: "compile_prompt",
+          description: "Compile a prompt template with variable interpolation for runtime delivery — returns the fully interpolated prompt string ready for use.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              slug: { type: "string", description: "The URL-safe slug of the prompt template" },
+              variables: {
+                type: "object",
+                description: "Variable values to interpolate (e.g. {\"user_name\": \"Alex\", \"plan\": \"Pro\"})",
+                additionalProperties: { type: "string" }
+              }
+            },
+            required: ["slug"]
+          }
+        },
+        {
+          name: "list_template_versions",
+          description: "List all version snapshots of a saved template — every update creates a snapshot you can inspect or restore.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              template_id: { type: "string", description: "The ID of the template" }
+            },
+            required: ["template_id"]
+          }
+        },
+        {
+          name: "rollback_template",
+          description: "Restore a template to a previous version snapshot — undo unwanted changes instantly.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              template_id: { type: "string", description: "The ID of the template" },
+              version_number: { type: "number", description: "The version number to roll back to (use list_template_versions to find available versions)" }
+            },
+            required: ["template_id", "version_number"]
+          }
+        },
+        {
+          name: "publish_template",
+          description: "Publish a template — makes it available for runtime delivery via get_prompt_by_slug.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              template_id: { type: "string", description: "The ID of the template to publish" }
+            },
+            required: ["template_id"]
+          }
+        },
+        {
+          name: "run_quick_evaluation",
+          description: "Run a stateless one-shot evaluation of an optimized prompt using LLM judges — get actionable quality scoring without creating a dataset.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              prompt: { type: "string", description: "The optimized prompt to evaluate" },
+              original_prompt: { type: "string", description: "The original prompt for comparison scoring" }
+            },
+            required: ["prompt", "original_prompt"]
+          }
+        },
       ];
 
       // Add advanced tools if Bayesian optimization is enabled
@@ -524,6 +610,12 @@ class MCPPromptOptimizer {
           case "get_ce_quota_status": return await this.handleGetCEQuotaStatus();
           case "generate_harness_bundle": return await this.handleGenerateHarnessBundle(args);
           case "explore_sop_approaches": return await this.handleExploreSopApproaches(args);
+          case "get_prompt_by_slug": return await this.handleGetPromptBySlug(args);
+          case "compile_prompt": return await this.handleCompilePrompt(args);
+          case "list_template_versions": return await this.handleListTemplateVersions(args);
+          case "rollback_template": return await this.handleRollbackTemplate(args);
+          case "publish_template": return await this.handlePublishTemplate(args);
+          case "run_quick_evaluation": return await this.handleRunQuickEvaluation(args);
           default: throw new Error(`Unknown tool: ${name}`);
         }
       } catch (error) {
@@ -1349,6 +1441,129 @@ class MCPPromptOptimizer {
     }
   }
 
+  async handleGetPromptBySlug(args) {
+    if (!args.slug) throw new Error('Slug is required');
+    try {
+      const result = await this.callBackendAPI(ENDPOINTS.GET_PROMPT_BY_SLUG(args.slug), null, 'GET');
+      let output = `# 📦 Prompt by Slug: \`${args.slug}\`\n\n`;
+      output += `**Title:** ${result.title || 'N/A'}\n`;
+      output += `**Body:**\n\`\`\`\n${result.optimized_prompt || result.body || ''}\n\`\`\`\n`;
+      return { content: [{ type: "text", text: output }] };
+    } catch (error) {
+      const msg = error.message || '';
+      if (msg.includes('403') || msg.includes('TIER')) {
+        return { content: [{ type: "text", text: `Upgrade required: runtime prompt delivery requires Pro tier or higher. Upgrade at /pricing.\n\nBackend error: ${msg}` }] };
+      }
+      throw new Error(`Failed to fetch prompt by slug: ${error.message}`);
+    }
+  }
+
+  async handleCompilePrompt(args) {
+    if (!args.slug) throw new Error('Slug is required');
+    try {
+      const result = await this.callBackendAPI(ENDPOINTS.COMPILE_PROMPT(args.slug), { variables: args.variables || {} });
+      const compiled = result.compiled_prompt || result.body || JSON.stringify(result, null, 2);
+      return { content: [{ type: "text", text: `# Compiled Prompt\n\n\`\`\`\n${compiled}\n\`\`\`\n` }] };
+    } catch (error) {
+      const msg = error.message || '';
+      if (msg.includes('403') || msg.includes('TIER')) {
+        return { content: [{ type: "text", text: `Upgrade required: prompt compilation requires Pro tier or higher. Upgrade at /pricing.\n\nBackend error: ${msg}` }] };
+      }
+      throw new Error(`Failed to compile prompt: ${error.message}`);
+    }
+  }
+
+  async handleListTemplateVersions(args) {
+    if (!args.template_id) throw new Error('Template ID is required');
+    try {
+      const result = await this.callBackendAPI(ENDPOINTS.TEMPLATE_VERSIONS(args.template_id), null, 'GET');
+      const versions = result.versions || result.data || [];
+      let output = `# 📋 Template Versions\n\n`;
+      output += `**Template ID:** \`${args.template_id}\`\n\n`;
+      if (versions.length === 0) {
+        output += 'No version history found for this template.';
+      } else {
+        versions.forEach((v, i) => {
+          output += `**${i + 1}.** Version ${v.version_number || 'N/A'}`;
+          if (v.created_at) output += ` — ${v.created_at}`;
+          if (v.change_summary) output += `\n   _${v.change_summary}_`;
+          output += `\n`;
+        });
+        output += `\nUse \`rollback_template\` with a version number to restore.`;
+      }
+      return { content: [{ type: "text", text: output }] };
+    } catch (error) {
+      const msg = error.message || '';
+      if (msg.includes('403') || msg.includes('TIER')) {
+        return { content: [{ type: "text", text: `Upgrade required: template versioning requires Pro tier or higher. Upgrade at /pricing.\n\nBackend error: ${msg}` }] };
+      }
+      throw new Error(`Failed to list template versions: ${error.message}`);
+    }
+  }
+
+  async handleRollbackTemplate(args) {
+    if (!args.template_id) throw new Error('Template ID is required');
+    if (args.version_number === undefined || args.version_number === null) throw new Error('version_number is required');
+    try {
+      const result = await this.callBackendAPI(ENDPOINTS.ROLLBACK_TEMPLATE(args.template_id, args.version_number), {});
+      const msg = result.message || `Template rolled back to version ${args.version_number}`;
+      return { content: [{ type: "text", text: `# ✅ Rollback Complete\n\n${msg}\n\n**Template ID:** \`${args.template_id}\`\n**Version:** ${args.version_number}` }] };
+    } catch (error) {
+      const msg = error.message || '';
+      if (msg.includes('403') || msg.includes('TIER')) {
+        return { content: [{ type: "text", text: `Upgrade required: template rollback requires Pro tier or higher. Upgrade at /pricing.\n\nBackend error: ${msg}` }] };
+      }
+      throw new Error(`Failed to rollback template: ${error.message}`);
+    }
+  }
+
+  async handlePublishTemplate(args) {
+    if (!args.template_id) throw new Error('Template ID is required');
+    try {
+      const result = await this.callBackendAPI(ENDPOINTS.PUBLISH_TEMPLATE(args.template_id), {});
+      const msg = result.message || `Template ${args.template_id} published successfully`;
+      return { content: [{ type: "text", text: `# ✅ Template Published\n\n${msg}\n\nThe template is now available for runtime delivery via \`get_prompt_by_slug\`.` }] };
+    } catch (error) {
+      const msg = error.message || '';
+      if (msg.includes('403') || msg.includes('TIER')) {
+        return { content: [{ type: "text", text: `Upgrade required: template publishing requires Pro tier or higher. Upgrade at /pricing.\n\nBackend error: ${msg}` }] };
+      }
+      throw new Error(`Failed to publish template: ${error.message}`);
+    }
+  }
+
+  async handleRunQuickEvaluation(args) {
+    if (!args.prompt) throw new Error('prompt is required');
+    if (!args.original_prompt) throw new Error('original_prompt is required');
+    try {
+      const result = await this.callBackendAPI(ENDPOINTS.QUICK_EVALUATE, {
+        prompt: args.prompt,
+        original_prompt: args.original_prompt,
+        assertions: [
+          {
+            type: "llm-rubric",
+            value: "The optimized prompt is clearer, more specific, and better achieves the original intent than the input prompt.",
+            weight: 1.0
+          }
+        ]
+      });
+      let output = `# 📊 Quick Evaluation Result\n\n`;
+      output += `**Score:** ${result.overall_score != null ? (result.overall_score * 100).toFixed(1) + '%' : 'N/A'}\n`;
+      output += `**Passed:** ${result.passed ? '✅ Yes' : '❌ No'}\n`;
+      if (result.context_detected) output += `**Context:** ${result.context_detected}\n`;
+      if (result.actionable_feedback && result.actionable_feedback.length) {
+        output += `\n**Feedback:**\n${result.actionable_feedback.map(f => `- ${f}`).join('\n')}\n`;
+      }
+      return { content: [{ type: "text", text: output }] };
+    } catch (error) {
+      const msg = error.message || '';
+      if (msg.includes('403') || msg.includes('TIER')) {
+        return { content: [{ type: "text", text: `Upgrade required: evaluations require Pro tier or higher. Upgrade at /pricing.\n\nBackend error: ${msg}` }] };
+      }
+      throw new Error(`Failed to run quick evaluation: ${error.message}`);
+    }
+  }
+
   _formatSkillPackage(result) {
     const sections = ['# Skill Package Generated'];
     const artifacts = result.artifacts || result.steps || {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-prompt-optimizer",
-  "version": "3.7.2",
+  "version": "3.7.3",
   "description": "Professional cloud-based MCP server for AI-powered prompt optimization with intelligent context detection, Bayesian optimization, AG-UI real-time optimization, template auto-save, optimization insights, personal model configuration via WebUI, team collaboration, enterprise-grade features, production resilience, and startup validation. Universal compatibility with Claude Desktop, Cursor, Windsurf, and 17+ MCP clients.",
   "main": "index.js",
   "bin": {
@@ -195,6 +195,13 @@
     "last_sync": "2026-06-01T00:00:00Z"
   },
   "release_notes": {
+    "v3.7.3": {
+      "major_features": [
+        "Docs only: corrected stale free-tier quota in README (7 optimizations/month -> 20), matching the backend enforcement fix"
+      ],
+      "breaking_changes": [],
+      "migration_guide": "No migration required."
+    },
     "v3.7.2": {
       "major_features": [
         "MCP server startup logs (banner, status lines, mode indicators, key validation messages) now write to stderr so stdout stays a clean JSON-RPC channel for stdio MCP clients"