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

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [0.1.10] - 2026-06-14
+
+### Changed
+
+- Added a README tool picker so npm/GitHub visitors can choose the first MCP
+  tool by workflow risk before opening issues or integrating the package.
+
+## [0.1.9] - 2026-06-13
+
+### Added
+
+- Added a copy-ready JSON-RPC MCP session example so developers can verify
+  initialize, tools/list, and a human_review_gate call before integrating with a
+  desktop MCP client.
+- Added README guidance for using the session example as a public-safe smoke
+  test when opening GitHub issues.
+
 ## [0.1.8] - 2026-06-12
 
 ### Added

package/README.md

@@ -16,6 +16,9 @@ Run the public MCP server:
 Then send a JSON-RPC tool call such as the copy-ready example in
 examples/human-review-gate/.
 
+For a complete public-safe MCP session that covers initialize, tools/list, and
+one tool call, see examples/mcp-json-rpc-session/.
+
 If you are not a developer and only want the spreadsheet/checklist version
 first, download the free review kit:
 
@@ -51,6 +54,20 @@ Claude Desktop config location:
 - Teams prototyping human-in-the-loop AI workflows before integrating real data.
 - Operators who can run npm/npx and want a small public MCP example.
 
+## Pick Your First Tool
+
+Start with the tool that matches the first unsafe handoff in your workflow:
+
+- AI draft may reach a customer: use `human_review_gate`.
+- Repeated support questions should become a public FAQ: use
+  `faq_candidate_review`.
+- CRM notes mix facts, AI suggestions, and human decisions: use
+  `ai_safe_crm_note`.
+- A prompt may touch customer data or public output: use `prompt_risk_review`.
+
+All examples use synthetic data. Keep private customer records, secrets,
+internal policy text, and paid product files out of public issues and screenshots.
+
 ## What To Do Next
 
 - Try one tool with synthetic data.
@@ -114,6 +131,23 @@ 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.
 
+## Copy-Ready MCP Session
+
+Use this when you want to confirm the package responds like an MCP server before
+connecting it to Claude Desktop, Cursor, or your own MCP client:
+
+    npm run mcp < examples/mcp-json-rpc-session/sample-session.jsonl
+
+The session sends three JSON-RPC messages:
+
+- initialize: confirms protocolVersion, capabilities, and serverInfo.
+- tools/list: confirms the four public alpha tools are visible.
+- tools/call: runs human_review_gate with synthetic support-reply data.
+
+If you open a GitHub issue, copy only synthetic input shapes and returned status
+fields. Do not paste private customer records, secrets, tokens, internal policy
+text, or MIRAI Memory behavior.
+
 ## Check A Prompt Before AI Use
 
 Use prompt_risk_review before a support, CRM, FAQ, or workflow prompt is sent to

package/examples/mcp-json-rpc-session/README.md

@@ -0,0 +1,35 @@
+# MCP JSON-RPC Session Example
+
+This example gives developers a copy-ready MCP session for the public
+@miraigent/free-ai-ops-mcp package.
+
+Use it before wiring the package into Claude Desktop, Cursor, or a custom MCP
+client. It verifies that the server responds to:
+
+- initialize
+- tools/list
+- tools/call for human_review_gate
+
+## Run
+
+From the repository root:
+
+    npm run mcp < examples/mcp-json-rpc-session/sample-session.jsonl
+
+You should receive three JSON-RPC response lines. The final response should
+include a human_review_gate result with:
+
+- gateStatus: stop
+- reviewOwner: support lead
+- boundary: this tool is a review helper and does not send messages
+
+## Public-Safe Feedback
+
+If the output is unclear, open a Tried It feedback issue and include only:
+
+- which command you ran
+- the public-safe input shape
+- the returned status or field that was unclear
+
+Do not include secrets, credentials, private customer records, internal policy
+text, or MIRAI Memory behavior.

package/examples/mcp-json-rpc-session/sample-session.jsonl

@@ -0,0 +1,3 @@
+{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}
+{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}
+{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"human_review_gate","arguments":{"draftType":"customer support reply","audience":"customer","riskFlags":["refund","complaint","personal data"],"reviewOwner":"support lead","sendMode":"manual"}}}

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.8' };
+const serverInfo = { name: 'miraigent-free-ai-ops-mcp', version: '0.1.10' };
 
 const tools = [
   {

package/package.json

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