Fix OpenAPI provider generation and doc retrieval (v1.6.1)

Fixes based on decompiling wm.server.openapi:generateProvider:
- Both sourceUri AND openapiUrl are required (not just one)
- For inline specs: set both to "inline" and pass openapiContent
- IS cannot fetch remote URLs reliably -- recommend downloading
  the spec externally and passing content inline
- Supports both JSON and YAML OpenAPI 3.0 specs (both tested E2E)
- Fixed getOpenAPIDoc to include openapi.json format parameter

Updated tool descriptions with correct usage guidance.
Full E2E: create folder -> generate from inline JSON spec ->
retrieve OpenAPI doc -> cleanup.

151/151 E2E tests passing.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: cpoder

mcp-server-rs/Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "wm-mcp-server"
-version = "1.6.0"
+version = "1.6.1"
 edition = "2024"
 description = "MCP server for managing webMethods Integration Server via pure HTTP API"
 license = "MIT"

mcp-server-rs/Cargo.toml

@@ -27,7 +27,7 @@ impl super::ISClient {
     pub async fn openapi_doc_get(&self, rad_name: &str) -> Result<Value, String> {
         self.invoke_post(
             "wm.server.openapi:getOpenAPIDoc",
-            &json!({"radName": rad_name}),
+            &json!({"radName": rad_name, "openapi.json": "true"}),
         )
         .await
     }

mcp-server-rs/src/client/webservices.rs

@@ -2358,7 +2358,9 @@ impl WmServer {
         }
     }
 
-    #[tool(description = "Get the OpenAPI document (JSON/YAML) for a REST API descriptor.")]
+    #[tool(
+        description = "Get the OpenAPI document for a REST API descriptor.\n\nReturns the full OpenAPI 3.0 spec in JSON format."
+    )]
     async fn openapi_doc_get(
         &self,
         Parameters(p): Parameters<OpenApiDocParam>,
@@ -2371,7 +2373,7 @@ impl WmServer {
     }
 
     #[tool(
-        description = "Generate IS provider services from an OpenAPI specification.\n\nRequired settings: packageName, folderName, radName (output descriptor name).\nProvide either sourceUri (URL) or openapiContent (inline spec).\nOptional: isGroupByTag (true/false)."
+        description = "Generate IS provider services from an OpenAPI specification.\n\nRequired settings: packageName, folderName (must exist -- use folder_create first), radName (descriptor name).\nRequired: sourceUri and openapiUrl (set both to 'inline' when providing openapiContent).\n\nRECOMMENDED APPROACH: Pass the spec content directly in openapiContent (JSON or YAML string). Set sourceUri and openapiUrl to 'inline'. IS may not be able to fetch remote URLs.\n\nTo use a remote spec: download it yourself first, then pass the content in openapiContent.\n\nOptional: isGroupByTag (default true).\n\nCreates a REST API descriptor + auto-generated service stubs and resource definitions."
     )]
     async fn openapi_generate_provider(
         &self,

mcp-server-rs/src/server.rs

@@ -457,8 +457,17 @@ check "ws_consumer_endpoint_list" "$out" "endpoints"
 out=$(mcp_call 2 "rest_resource_list" '{}')
 check "rest_resource_list" "$out" "restV2Resources"
 
-# OpenAPI generation tested manually (requires network access from IS).
-# The list/get tools are verified above.
+# Full OpenAPI generation E2E: create folder -> generate from inline spec -> get doc -> cleanup
+mcp_call 2 "folder_create" '{"package":"E2ETestPkg","folder_path":"e2etest.restapi"}' > /dev/null 2>&1
+OASETTINGS='{"folderName":"e2etest.restapi","packageName":"E2ETestPkg","radName":"e2eApi","sourceUri":"inline","openapiUrl":"inline","openapiContent":"{\"openapi\":\"3.0.0\",\"info\":{\"title\":\"Test\",\"version\":\"1.0\"},\"paths\":{\"/test\":{\"get\":{\"operationId\":\"getTest\",\"responses\":{\"200\":{\"description\":\"OK\"}}}}}}"}'
+out=$(mcp_call 2 "openapi_generate_provider" "{\"settings\":$(echo "$OASETTINGS" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read().strip()))')}")
+check "openapi_generate_provider" "$out" "e2eApi\|radName\|folderName"
+
+out=$(mcp_call 2 "openapi_doc_get" '{"rad_name":"e2etest.restapi:e2eApi"}')
+check "openapi_doc_get" "$out" "openapi\|3.0\|paths"
+
+# Cleanup
+mcp_call 2 "node_delete" '{"name":"e2etest.restapi:e2eApi"}' > /dev/null 2>&1
 
 # ── Security & Keystore ───────────────────────────────────────
 echo "--- Security ---"