@miraigent/free-ai-ops-mcp 0.1.43 → 0.1.44

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.44] - 2026-07-20
+
+### Added
+
+- Added a tools-list-only JSON-RPC session example and smoke-test coverage so
+  MCP client users can confirm the four public tools before sending any sample
+  tool-call input.
+
 ## [0.1.43] - 2026-07-19
 
 ### Changed

package/README.md

@@ -19,6 +19,9 @@ 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 only want to confirm which tools the server exposes before sending any
+sample tool-call input, use examples/tools-list-json-rpc-session/.
+
 If your first concern is whether a customer-facing prompt should be stopped
 before AI use, use examples/prompt-risk-json-rpc-session/ for a copy-ready
 prompt_risk_review session.
@@ -44,6 +47,13 @@ This is the fastest public proof path for npm and GitHub users. If the command
 starts but the returned status is confusing, open a Tried It feedback issue with
 the command, synthetic input shape, and returned status only.
 
+To inspect the public tool list without running any tool call:
+
+    npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp < examples/tools-list-json-rpc-session/sample-session.jsonl
+
+That response should include `human_review_gate`, `faq_candidate_review`,
+`ai_safe_crm_note`, and `prompt_risk_review`.
+
 For maintainers and contributors, `npm test` replays the same public
 `examples/mcp-json-rpc-session/sample-session.jsonl` file and checks the
 returned server name, version, tool count, and review-gate fields.

package/examples/tools-list-json-rpc-session/README.md

@@ -0,0 +1,31 @@
+# Tools List JSON-RPC Session Example
+
+This example lets MCP client users confirm the public tool list before sending
+any sample tool-call input.
+
+Use it when a desktop MCP client starts the server but does not show the tools
+you expected.
+
+## Run
+
+From the repository root:
+
+    npm run mcp < examples/tools-list-json-rpc-session/sample-session.jsonl
+
+From the public npm package:
+
+    npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp < examples/tools-list-json-rpc-session/sample-session.jsonl
+
+You should receive two JSON-RPC response lines. The second response should list:
+
+- human_review_gate
+- faq_candidate_review
+- ai_safe_crm_note
+- prompt_risk_review
+
+If those tools appear in the terminal but not in your desktop MCP client,
+restart the client and re-check the configured command and args before changing
+private workflow data.
+
+Do not include secrets, credentials, private customer records, internal policy
+text, paid product files, or private memory behavior in public issues.

package/examples/tools-list-json-rpc-session/sample-session.jsonl

@@ -0,0 +1,2 @@
+{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}
+{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

package/package.json

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

@@ -190,6 +190,21 @@ assert.equal(sampleToolResult.gateStatus, 'stop');
 assert.equal(sampleToolResult.nextLogRow.gate_status, 'stop');
 assert.equal(sampleToolResult.boundary, 'This tool is a review helper. It does not send messages.');
 
+const toolsListSession = await readFile(
+  new URL('../examples/tools-list-json-rpc-session/sample-session.jsonl', import.meta.url),
+  'utf8'
+);
+const toolsListResponses = await runServerWithRequests(toolsListSession.trim().split('\n'));
+assert.equal(toolsListResponses.length, 2);
+assert.equal(toolsListResponses[0].result.protocolVersion, '2024-11-05');
+assert.equal(toolsListResponses[0].result.serverInfo.name, 'miraigent-free-ai-ops-mcp');
+assert.equal(toolsListResponses[0].result.serverInfo.version, packageJson.version);
+assert.deepEqual(
+  toolsListResponses[1].result.tools.map((tool) => tool.name),
+  ['human_review_gate', 'faq_candidate_review', 'ai_safe_crm_note', 'prompt_risk_review']
+);
+assert.match(rootReadme, /examples\/tools-list-json-rpc-session\/sample-session\.jsonl/);
+
 const promptRiskSession = await readFile(
   new URL('../examples/prompt-risk-json-rpc-session/sample-session.jsonl', import.meta.url),
   'utf8'