@miraigent/free-ai-ops-mcp 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [0.1.8] - 2026-06-12
+
+### Added
+
+- Added a copy-ready prompt_risk_review example for developers checking
+  customer-facing prompts before AI use.
+- Added README input/output for the prompt risk workflow and a matching npm
+  example script.
+
+## [0.1.7] - 2026-06-10
+
+### Added
+
+- Added Claude Desktop and Cursor MCP configuration example to README so
+  developers can copy-paste the mcpServers block directly.
+- Added npm keywords: claude-desktop, cursor-mcp, mcp-tools, ai-agent-tools, npx.
+
 ## [0.1.6] - 2026-06-08
 
 ### Added

package/README.md

@@ -21,6 +21,28 @@ first, download the free review kit:
 
 https://miraigent.gumroad.com/l/human-review-gate-ai-drafts?utm_source=github&utm_medium=readme&utm_campaign=free-ai-ops-mcp-013
 
+## Use With Claude Desktop or Cursor
+
+Add to your `claude_desktop_config.json` or Cursor MCP settings:
+
+    {
+      "mcpServers": {
+        "miraigent-free-ai-ops-mcp": {
+          "command": "npx",
+          "args": ["-y", "@miraigent/free-ai-ops-mcp"]
+        }
+      }
+    }
+
+After restarting Claude Desktop or Cursor, the four tools
+(`human_review_gate`, `faq_candidate_review`, `ai_safe_crm_note`,
+`prompt_risk_review`) will be available in the MCP tools panel.
+
+Claude Desktop config location:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
 ## Who This Helps
 
 - Developers adding review gates to AI agents or MCP tools.
@@ -92,6 +114,35 @@ Use this as a small public proof before building a larger AI support workflow.
 See examples/human-review-gate/ for copy-ready JSON-RPC examples and a sample
 decision log that match the free Gumroad kit.
 
+## Check A Prompt Before AI Use
+
+Use prompt_risk_review before a support, CRM, FAQ, or workflow prompt is sent to
+AI. It helps developers decide whether a prompt can proceed with a checklist,
+needs human review, or should stop before use because it touches sensitive data
+or customer-facing output.
+
+Example input:
+
+    {
+      "operation": "support automation",
+      "promptSummary": "Draft a customer reply from inquiry details and suggest the next support step.",
+      "dataTypes": ["customer email", "inquiry body", "plan name"],
+      "customerFacing": true,
+      "riskLevel": "medium"
+    }
+
+Expected result:
+
+    {
+      "recommendation": "human_review_required",
+      "riskFlags": ["customer_facing", "sensitive_data_possible"],
+      "boundary": "This tool is a prompt risk helper. It is not legal advice and does not call an AI API."
+    }
+
+Run the copy-ready example:
+
+    npm run example:prompt-risk-review
+
 ## Launch Flow
 
 See LAUNCH_FLOW.md for the first public posting plan, issue collection flow, and
@@ -118,6 +169,10 @@ Run the public FREE-004 example:
 
     npm run example:human-review-gate
 
+Run the prompt risk review example:
+
+    npm run example:prompt-risk-review
+
 ## npm Package
 
 Package name: @miraigent/free-ai-ops-mcp

package/examples/prompt-risk-review/README.md

@@ -0,0 +1,33 @@
+# Prompt Risk Review Example
+
+This example shows how to call the public prompt_risk_review MCP tool before an
+operational prompt is sent to AI.
+
+Use it when a support, CRM, FAQ, or workflow automation prompt might include
+customer-facing output or sensitive data.
+
+## Run
+
+From the repository root:
+
+    npm run example:prompt-risk-review
+
+The example sends sample-request.jsonl to the MCP server and prints the
+prompt_risk_review result.
+
+## What To Look For
+
+The sample includes a customer-facing support operation and customer email data,
+so the tool should return:
+
+- recommendation: human_review_required or stop_before_ai_use
+- riskFlags: customer_facing and sensitive_data_possible
+- saferNextStep: a human-reviewed data-handling step before real use
+
+## Safe Use
+
+Use synthetic examples only. Do not paste private customer records, secrets,
+contracts, payment details, or internal policy text into public issues,
+examples, or screenshots.
+
+This is an operations review helper, not legal or compliance advice.

package/examples/prompt-risk-review/run-example.mjs

@@ -0,0 +1,28 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+
+const child = spawn(process.execPath, ['mcp/free-ai-ops-server.mjs'], {
+  stdio: ['pipe', 'pipe', 'inherit']
+});
+
+const request = fs.readFileSync('examples/prompt-risk-review/sample-request.jsonl', 'utf8');
+let stdout = '';
+
+child.stdout.on('data', (chunk) => {
+  stdout += chunk;
+});
+
+child.stdin.write(request.trim() + '\n');
+child.stdin.end();
+
+await new Promise((resolve, reject) => {
+  child.on('error', reject);
+  child.on('close', (code) => {
+    if (code !== 0) reject(new Error('server exited with ' + code));
+    else resolve();
+  });
+});
+
+const response = JSON.parse(stdout.trim());
+const payload = JSON.parse(response.result.content[0].text);
+console.log(JSON.stringify(payload, null, 2));

package/examples/prompt-risk-review/sample-request.jsonl

@@ -0,0 +1 @@
+{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"prompt_risk_review","arguments":{"operation":"support automation","promptSummary":"Draft a customer reply from inquiry details and suggest the next support step.","dataTypes":["customer email","inquiry body","plan name"],"customerFacing":true,"riskLevel":"medium"}}}

package/mcp/free-ai-ops-server.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-const serverInfo = { name: 'miraigent-free-ai-ops-mcp', version: '0.1.6' };
+const serverInfo = { name: 'miraigent-free-ai-ops-mcp', version: '0.1.8' };
 
 const tools = [
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miraigent/free-ai-ops-mcp",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Free MCP server for developers adding human review gates, prompt risk checks, FAQ review, and CRM note safety to AI tools.",
   "homepage": "https://github.com/Miraigent/miraigent-free-ai-ops-mcp",
   "type": "module",
@@ -24,6 +24,7 @@
     "check": "node --check mcp/free-ai-ops-server.mjs && node --check scripts/smoke-test.mjs && node --check scripts/secret-scan.mjs && node scripts/secret-scan.mjs",
     "test": "node scripts/smoke-test.mjs",
     "example:human-review-gate": "node examples/human-review-gate/run-example.mjs",
+    "example:prompt-risk-review": "node examples/prompt-risk-review/run-example.mjs",
     "mcp": "node mcp/free-ai-ops-server.mjs"
   },
   "keywords": [
@@ -43,7 +44,12 @@
     "workflow-automation",
     "review-gate",
     "human-in-the-loop",
-    "developer-tools"
+    "developer-tools",
+    "claude-desktop",
+    "cursor-mcp",
+    "mcp-tools",
+    "ai-agent-tools",
+    "npx"
   ],
   "repository": {
     "type": "git",