mcp4openapi 0.2.4 → 0.2.6

package/profile-schema.json

@@ -81,15 +81,28 @@
         },
         "operations": {
           "type": "object",
-          "description": "Map action names to OpenAPI operationIds (for simple tools)",
+          "description": "Map action names to OpenAPI operationIds or proxy download operations",
           "additionalProperties": {
-            "type": "string"
+            "oneOf": [
+              {
+                "type": "string",
+                "description": "OpenAPI operation ID"
+              },
+              {
+                "$ref": "#/definitions/ProxyDownloadOperation"
+              }
+            ]
           },
           "examples": [
             {
               "list": "getApiV4ProjectsIdBadges",
               "get": "getApiV4ProjectsIdBadgesBadgeId",
-              "create": "postApiV4ProjectsIdBadges"
+              "create": "postApiV4ProjectsIdBadges",
+              "download_attachment": {
+                "type": "proxy_download",
+                "metadata_endpoint": "getApiV4ProjectsIdMergeRequestsMrIidNotesNoteId",
+                "url_field": "attachment.url"
+              }
             }
           ]
         },
@@ -109,9 +122,14 @@
             }
           ]
         },
+        "send_response_fields_as_param": {
+          "type": "boolean",
+          "description": "If true, send response_fields as 'fields' query parameter (e.g. for YouTrack)",
+          "default": false
+        },
         "steps": {
           "type": "array",
-          "description": "Sequence of API calls to execute (for composite tools)",
+          "description": "Steps for composite tool execution",
           "items": {
             "$ref": "#/definitions/CompositeStep"
           }
@@ -137,7 +155,18 @@
           "required": ["operations"],
           "properties": {
             "operations": {
-              "type": "object"
+              "type": "object",
+              "additionalProperties": {
+                "oneOf": [
+                  {
+                    "type": "string",
+                    "description": "OpenAPI operation ID"
+                  },
+                  {
+                    "$ref": "#/definitions/ProxyDownloadOperation"
+                  }
+                ]
+              }
             }
           }
         },
@@ -198,6 +227,11 @@
             }
           }
         },
+        "properties": {
+          "type": "object",
+          "description": "Properties schema for object parameters (empty {} = free-form object)",
+          "additionalProperties": true
+        },
         "default": {
           "description": "Default value if not provided"
         },
@@ -525,7 +559,57 @@
           "examples": [[429, 502, 503, 504]]
         }
       }
+    },
+    "ProxyDownloadOperation": {
+      "type": "object",
+      "required": ["type", "metadata_endpoint"],
+      "properties": {
+        "type": {
+          "const": "proxy_download",
+          "description": "Must be 'proxy_download'"
+        },
+        "metadata_endpoint": {
+          "type": "string",
+          "description": "OpenAPI operation ID to fetch metadata (e.g., 'get_/issues/{id}/attachments/{attachmentId}')"
+        },
+        "download_endpoint": {
+          "type": "string",
+          "description": "OpenAPI operation ID for direct download endpoint when metadata does not expose a URL"
+        },
+        "url_field": {
+          "type": "string",
+          "description": "JSON path to URL field in metadata response",
+          "default": "url"
+        },
+        "max_size_bytes": {
+          "type": "number",
+          "description": "Maximum file size in bytes",
+          "default": 10485760,
+          "minimum": 1
+        },
+        "max_size_bytes_from_env": {
+          "type": "string",
+          "description": "Environment variable that overrides max_size_bytes when set"
+        },
+        "timeout_ms": {
+          "type": "number",
+          "description": "Timeout for download in milliseconds",
+          "default": 30000,
+          "minimum": 1000
+        },
+        "allowed_mime_types": {
+          "type": "array",
+          "description": "Optional MIME type whitelist (e.g., ['image/*', 'application/pdf'])",
+          "items": {
+            "type": "string"
+          }
+        },
+        "skip_auth": {
+          "type": "boolean",
+          "description": "Skip authentication for download URL (default: false). Set to true for pre-signed URLs.",
+          "default": false
+        }
+      }
     }
   }
 }
-