@miraigent/free-ai-ops-mcp 0.1.18 → 0.1.19

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.19] - 2026-06-19
+
+### Fixed
+
+- Updated README, help output, and MCP client config examples to the verified
+  npm alias command `npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp`,
+  which resolves the scoped package binary consistently in public tests.
+
 ## [0.1.18] - 2026-06-19
 
 ### Fixed

package/README.md

@@ -11,7 +11,7 @@ reaches customers or shared systems.
 
 Run the public MCP server:
 
-    npm exec --yes --package=@miraigent/free-ai-ops-mcp -- free-ai-ops-mcp
+    npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp
 
 Then send a JSON-RPC tool call such as the copy-ready example in
 examples/human-review-gate/.
@@ -24,7 +24,7 @@ one tool call, see examples/mcp-json-rpc-session/.
 Use this when you want to confirm the npm package works before editing a desktop
 MCP client config:
 
-    npm exec --yes --package=@miraigent/free-ai-ops-mcp -- free-ai-ops-mcp < examples/mcp-json-rpc-session/sample-session.jsonl
+    npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp < examples/mcp-json-rpc-session/sample-session.jsonl
 
 The response should include:
 
@@ -39,7 +39,7 @@ the command, synthetic input shape, and returned status only.
 
 If you are checking the package from npm search, run the public help first:
 
-    npm exec --yes --package=@miraigent/free-ai-ops-mcp -- free-ai-ops-mcp --help
+    npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp --help
 
 The help output lists the available MCP tools, the one-command smoke test, and
 the public-safe boundary before you send any JSON-RPC input.
@@ -66,7 +66,7 @@ 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"]
+          "args": ["-y", "free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp"]
         }
       }
     }
@@ -107,7 +107,7 @@ public-safe result shape that shows where the review gate helped or felt unclear
 
 Good public-safe issue body:
 
-    Command: npx @miraigent/free-ai-ops-mcp
+    Command: npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp
     Tool: human_review_gate
     Input shape:
       draftType: customer support reply
@@ -152,7 +152,7 @@ internal policy text, and paid product files out of public issues and screenshot
 ## What To Do Next
 
 - Try one tool with synthetic data.
-- If you ran `npm exec --yes --package=@miraigent/free-ai-ops-mcp -- free-ai-ops-mcp`, paste the public-safe result
+- If you ran `npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp`, paste the public-safe result
   shape into the Tried It feedback issue.
 - Share what happened in the Tried It feedback issue if setup, JSON-RPC input,
   or the returned gate decision was unclear.
@@ -272,7 +272,7 @@ developer-focused distribution route.
 
 Run from npm:
 
-    npx @miraigent/free-ai-ops-mcp
+    npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp
 
 Run checks:
 
@@ -301,7 +301,7 @@ Package name: @miraigent/free-ai-ops-mcp
 
 Command:
 
-    npx @miraigent/free-ai-ops-mcp
+    npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp
 
 ## Public Boundary
 

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.18' };
+const serverInfo = { name: 'miraigent-free-ai-ops-mcp', version: '0.1.19' };
 
 const tools = [
   {
@@ -69,10 +69,10 @@ function printHelp() {
   process.stdout.write(`Miraigent Free AI Ops MCP ${serverInfo.version}
 
 Run the public MCP server:
-  npm exec --yes --package=@miraigent/free-ai-ops-mcp -- free-ai-ops-mcp
+  npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp
 
 Run a copy-ready public smoke test:
-  npm exec --yes --package=@miraigent/free-ai-ops-mcp -- free-ai-ops-mcp < examples/mcp-json-rpc-session/sample-session.jsonl
+  npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp < examples/mcp-json-rpc-session/sample-session.jsonl
 
 Available tools:
   human_review_gate      Stop/review/approve AI drafts before sending

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miraigent/free-ai-ops-mcp",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "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",

package/scripts/smoke-test.mjs

@@ -21,7 +21,7 @@ await new Promise((resolve, reject) => {
   });
 });
 
-assert.match(helpStdout, /npm exec --yes --package=@miraigent\/free-ai-ops-mcp/);
+assert.match(helpStdout, /npx -y free-ai-ops-mcp@npm:@miraigent\/free-ai-ops-mcp/);
 assert.match(helpStdout, /human_review_gate/);
 assert.match(helpStdout, /Do not paste secrets/);