@apteva/integrations 0.3.62 → 0.15.4

package/src/apps/cloudinary.json

@@ -1,163 +1,185 @@
 {
   "slug": "cloudinary",
   "name": "Cloudinary",
-  "description": "MCP server for Cloudinary media management - upload, transform, deliver",
+  "description": "Cloud media management — upload images and video, apply transformations (resize, transcode, trim, crop, extract frame, audio extract, concat), and deliver via CDN. Account-scoped: every account has its own cloud_name that becomes part of the URL path.",
   "logo": "https://www.google.com/s2/favicons?domain=cloudinary.com&sz=128",
-  "categories": [
-    "media",
-    "images",
-    "videos",
-    "cdn"
-  ],
-  "base_url": "https://api.cloudinary.com/v1_1",
+  "categories": ["media", "images", "videos", "cdn", "transcoding"],
+  "base_url": "https://api.cloudinary.com",
   "auth": {
-    "types": [
-      "bearer"
-    ],
+    "types": ["basic"],
     "headers": {
-      "Authorization": "Bearer {{token}}"
+      "Authorization": "Basic {{basic_auth}}"
     },
     "credential_fields": [
       {
-        "name": "token",
-        "label": "API Key"
+        "name": "cloud_name",
+        "label": "Cloud Name",
+        "description": "Your Cloudinary account's cloud name — visible at the top of https://console.cloudinary.com. Used as a URL path segment, not a credential.",
+        "required": true,
+        "type": "text"
+      },
+      {
+        "name": "api_key",
+        "label": "API Key",
+        "description": "Found at https://console.cloudinary.com/settings/api-keys.",
+        "required": true,
+        "type": "text"
+      },
+      {
+        "name": "api_secret",
+        "label": "API Secret",
+        "description": "Paired with API Key for HTTP Basic auth.",
+        "required": true,
+        "type": "password"
       }
     ]
   },
   "tools": [
     {
-      "name": "upload_image",
-      "description": "Upload an image to Cloudinary",
+      "name": "upload",
+      "description": "Upload bytes or a URL to Cloudinary. Accepts a remote URL, a data URI, or an S3/GCS-style path. Returns the asset's public_id, secure_url, format, dimensions. Use this for ingesting source media before applying transformations via `explicit`.",
       "method": "POST",
-      "path": "/upload-image",
+      "path": "/v1_1/{{cloud_name}}/{resource_type}/upload",
       "input_schema": {
         "type": "object",
         "properties": {
+          "resource_type": {
+            "type": "string",
+            "enum": ["image", "video", "raw", "auto"],
+            "default": "auto",
+            "description": "Path segment. `auto` lets Cloudinary detect from the file. Required because the path interpolates this value."
+          },
           "file": {
             "type": "string",
-            "description": "File URL or base64"
+            "description": "Source: HTTPS URL, data: URI, or S3 URL (s3://bucket/key) when account has S3 fetch enabled."
           },
           "public_id": {
-            "type": "string"
+            "type": "string",
+            "description": "Stable identifier the asset will be addressable by. Optional; auto-generated when omitted."
           },
           "folder": {
-            "type": "string"
+            "type": "string",
+            "description": "Asset folder (e.g. \"agents/inbox\"). Distinct from public_id; the folder is metadata, the public_id is the address."
           },
           "tags": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          }
-        },
-        "required": [
-          "file"
-        ]
-      }
-    },
-    {
-      "name": "generate_delivery_url",
-      "description": "Generate a delivery URL with transformations",
-      "method": "GET",
-      "path": "/generate-delivery-url",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "public_id": {
-            "type": "string"
+            "type": "string",
+            "description": "Comma-separated tags."
           },
-          "transformations": {
-            "type": "object"
+          "eager": {
+            "type": "string",
+            "description": "Pipe-separated transformation chain to apply eagerly (e.g. \"c_fill,w_300,h_200\"). Useful for pre-baking thumbnails."
           },
-          "format": {
-            "type": "string"
+          "context": {
+            "type": "string",
+            "description": "Pipe-separated key=value pairs for contextual metadata."
+          },
+          "upload_preset": {
+            "type": "string",
+            "description": "Pre-configured preset name. With Basic auth + API secret you can omit this; required only for unsigned uploads."
           }
         },
-        "required": [
-          "public_id"
-        ]
+        "required": ["file", "resource_type"]
       }
     },
     {
-      "name": "get_image_analysis",
-      "description": "Get AI analysis of an image",
-      "method": "GET",
-      "path": "/get-image-analysis",
+      "name": "explicit",
+      "description": "Apply transformations to an already-uploaded asset and (optionally) eagerly produce derived versions. Use this for post-upload trim/resize/transcode/crop/concat. The `eager` parameter is the heavy hitter: pass an array of transformation strings and Cloudinary produces each derivative + returns the URLs in the response.",
+      "method": "POST",
+      "path": "/v1_1/{{cloud_name}}/{resource_type}/explicit",
       "input_schema": {
         "type": "object",
         "properties": {
+          "resource_type": {
+            "type": "string",
+            "enum": ["image", "video", "raw"],
+            "description": "Path segment. Use `image` for stills, `video` for clips/audio."
+          },
           "public_id": {
+            "type": "string",
+            "description": "Identifier of the asset to transform."
+          },
+          "type": {
+            "type": "string",
+            "enum": ["upload", "private", "authenticated", "fetch"],
+            "default": "upload"
+          },
+          "eager": {
+            "type": "string",
+            "description": "Pipe-separated list of transformation strings, each one is `<param>,<param>,...`. Cheat-sheet for the 7 ffmpeg-equivalents:\n  - trim:           so_<startSec>,du_<durationSec>\n  - resize:         c_scale,w_<W>,h_<H>          (or c_limit / c_fill)\n  - transcode:      f_<format>                    (e.g. f_mp4, f_webm)\n  - crop:           c_crop,w_<W>,h_<H>,x_<X>,y_<Y>\n  - extract_frame:  so_<sec>,f_jpg                 (image:explicit on a video)\n  - audio_extract:  af_<format>                    (e.g. af_mp3) + f_<format>\n  - concat:         fl_splice,l_video:<other_id>   (overlay-style splice)\nMultiple transformation chains: pipe-separate them."
+          },
+          "eager_async": {
+            "type": "boolean",
+            "description": "When true, derivatives are produced async and you'll be notified via eager_notification_url. Default false (sync, response includes finished URLs)."
+          },
+          "eager_notification_url": {
             "type": "string"
-          }
-        },
-        "required": [
-          "public_id"
-        ]
-      }
-    },
-    {
-      "name": "ai_background_removal",
-      "description": "Remove image background using AI",
-      "method": "GET",
-      "path": "/ai-background-removal",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "public_id": {
+          },
+          "tags": {
             "type": "string"
+          },
+          "invalidate": {
+            "type": "boolean",
+            "description": "Invalidate CDN cache for the asset + its derivatives."
           }
         },
-        "required": [
-          "public_id"
-        ]
+        "required": ["resource_type", "public_id", "type"]
       }
     },
     {
-      "name": "explicit_transformation",
-      "description": "Apply transformations to an image",
-      "method": "GET",
-      "path": "/explicit-transformation",
+      "name": "destroy",
+      "description": "Delete an uploaded asset and its CDN cache. Permanent.",
+      "method": "POST",
+      "path": "/v1_1/{{cloud_name}}/{resource_type}/destroy",
       "input_schema": {
         "type": "object",
         "properties": {
-          "public_id": {
-            "type": "string"
+          "resource_type": {
+            "type": "string",
+            "enum": ["image", "video", "raw"]
           },
-          "type": {
+          "public_id": {
             "type": "string"
           },
-          "eager": {
-            "type": "array"
+          "invalidate": {
+            "type": "boolean",
+            "description": "Invalidate CDN cache. Recommended when re-uploading under the same public_id."
           }
         },
-        "required": [
-          "public_id"
-        ]
+        "required": ["resource_type", "public_id"]
       }
     },
     {
-      "name": "destroy_resource",
-      "description": "Delete a resource",
+      "name": "list_resources",
+      "description": "Admin API: list assets in this account, optionally filtered by prefix / tag / context. Returns metadata (no bytes) for browsing or sync.",
       "method": "GET",
-      "path": "/destroy-resource",
+      "path": "/v1_1/{{cloud_name}}/resources/{resource_type}",
       "input_schema": {
         "type": "object",
         "properties": {
-          "public_id": {
-            "type": "string"
-          },
           "resource_type": {
             "type": "string",
-            "enum": [
-              "image",
-              "video",
-              "raw"
-            ]
+            "enum": ["image", "video", "raw"]
+          },
+          "prefix": {
+            "type": "string",
+            "description": "Filter to public_ids starting with this prefix. Cheap way to scope to a folder."
+          },
+          "tags": {
+            "type": "boolean",
+            "description": "Include tags in the response. Default false."
+          },
+          "context": {
+            "type": "boolean"
+          },
+          "max_results": {
+            "type": "integer",
+            "default": 50
+          },
+          "next_cursor": {
+            "type": "string"
           }
         },
-        "required": [
-          "public_id"
-        ]
+        "required": ["resource_type"]
       }
     }
   ]

package/src/apps/coconut.json

@@ -0,0 +1,94 @@
+{
+  "slug": "coconut",
+  "name": "Coconut",
+  "description": "Coconut.co — managed video transcoding API. One POST creates a job that fetches a source URL, encodes to multiple output specs, and pushes results to your storage (S3, GCS, DigitalOcean Spaces, FTP, or HTTP webhook). Simpler scope than MediaConvert/Mux: no live streaming, no playback infrastructure — just transcode + delivery. Good fit as a lightweight render executor.",
+  "logo": "https://www.google.com/s2/favicons?domain=coconut.co&sz=128",
+  "categories": ["video", "transcoding", "media", "encoding"],
+  "base_url": "https://api.coconut.co",
+  "auth": {
+    "types": ["basic"],
+    "headers": {
+      "Authorization": "Basic {{basic_auth}}"
+    },
+    "credential_fields": [
+      {
+        "name": "username",
+        "label": "API Key",
+        "description": "API key from https://app.coconut.co/api-keys. Sent as the username in HTTP Basic auth (with an empty password).",
+        "required": true,
+        "type": "password"
+      },
+      {
+        "name": "password",
+        "label": "Empty",
+        "description": "Coconut uses Basic auth with an empty password. Leave this blank — the runtime will still build a valid Basic header (api_key:'').",
+        "required": false,
+        "type": "password"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "create_job",
+      "description": "Submit a transcoding job. The body declares one input source, one storage destination, an optional notification webhook, and one or more outputs (each output is a key like \"mp4:720p\" or \"jpg:200x\" mapped to an object with `path` + per-format options). Returns 201 with the job id; status starts at job.queued and progresses to job.completed | job.failed. Either poll get_job or rely on the notification webhook.",
+      "method": "POST",
+      "path": "/v2/jobs",
+      "timeout_ms": 60000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "input": {
+            "type": "object",
+            "description": "Source descriptor. {url: \"https://...\"} for HTTPS, or a service+credentials object for S3/etc. Must be reachable by Coconut.",
+            "properties": {
+              "url": { "type": "string" }
+            }
+          },
+          "storage": {
+            "type": "object",
+            "description": "Where outputs land. Common shapes:\n  {service: \"s3\", region, bucket, credentials: {access_key_id, secret_access_key}}\n  {service: \"gcs\", bucket, credentials: {...}}\n  {service: \"do\" | \"backblaze\" | \"rackspace\" | \"linode\" | \"upcloud\" | \"wasabi\" | ...}\n  {service: \"ftp\", host, user, password}\nBy default Coconut uploads to your own storage; without a storage block, files stay in Coconut for ~24h."
+          },
+          "notification": {
+            "type": "object",
+            "description": "Optional webhook callback. {type: \"http\", url: \"https://your-app/coconut-webhook\", events: true | [\"job.completed\", \"output.completed\"], metadata: {render_id: ...}}. The metadata round-trips back so you can match the callback to the originating render."
+          },
+          "outputs": {
+            "type": "object",
+            "description": "Map of <format-key>: <output-spec>. Format keys: `mp4`, `mp4:hls`, `jpg`, `jpg:gif`, `webp`, `webm`, `ogg`, `mp3`, etc — optionally suffixed with a preset like `:720p` or dimensions like `:1280x720`. Each value is at minimum {path: \"/output/file.mp4\"} relative to the storage root, plus per-format tuning fields (video_bitrate, audio_bitrate, fps, watermark, etc). For our 7 ops:\n  - trim → output spec with `start: \"00:00:01.500\"` + `end: \"00:00:03.500\"`\n  - resize → `width` + `height`\n  - transcode → switch the format key\n  - extract_frame → `jpg:200x` with `offset: \"00:00:02.500\"`\n  - audio_extract → `mp3` (no width/height)\n  - crop → `vfilter: \"crop=W:H:X:Y\"`\n  - concat → multi-input via `input.urls: [...]` + `vfilter: \"concat\"`."
+          },
+          "metadata": {
+            "type": "object",
+            "description": "Free-form key/values echoed back in the job + notification."
+          }
+        },
+        "required": ["input", "outputs"]
+      }
+    },
+    {
+      "name": "get_job",
+      "description": "Fetch one job's status + per-output progress. Status enum: job.queued, job.starting, job.transcoding, job.completed, job.failed. Each output also has its own progress percent; the overall job's `progress` is the rolled-up min.",
+      "method": "GET",
+      "path": "/v2/jobs/{JOB_ID}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "JOB_ID": { "type": "string" }
+        },
+        "required": ["JOB_ID"]
+      }
+    },
+    {
+      "name": "get_job_metadata",
+      "description": "Fetch source-file probe data Coconut collects on ingest — duration, dimensions, codecs, bitrate. Useful before deciding output specs (e.g. don't upscale).",
+      "method": "GET",
+      "path": "/v2/metadata/jobs/{JOB_ID}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "JOB_ID": { "type": "string" }
+        },
+        "required": ["JOB_ID"]
+      }
+    }
+  ]
+}

package/src/apps/contentful.json

@@ -0,0 +1,157 @@
+{
+  "slug": "contentful",
+  "name": "Contentful",
+  "description": "MCP server for Contentful - headless CMS entries, assets, content types, environments",
+  "logo": "https://www.google.com/s2/favicons?domain=contentful.com&sz=128",
+  "categories": ["cms", "headless", "content", "publishing"],
+  "base_url": "https://api.contentful.com",
+  "auth": {
+    "types": ["bearer"],
+    "headers": { "Authorization": "Bearer {{token}}" },
+    "credential_fields": [
+      { "name": "token", "label": "Management API Token" },
+      { "name": "spaceId", "label": "Space ID" },
+      { "name": "environmentId", "label": "Environment", "description": "Default: master" },
+      { "name": "deliveryToken", "label": "Content Delivery API Token" }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_entries",
+      "description": "List entries in an environment",
+      "method": "GET",
+      "path": "/spaces/{space_id}/environments/{environment_id}/entries",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "space_id": { "type": "string" },
+          "environment_id": { "type": "string" },
+          "content_type": { "type": "string" },
+          "limit": { "type": "number" },
+          "skip": { "type": "number" }
+        },
+        "required": ["space_id", "environment_id"]
+      }
+    },
+    {
+      "name": "get_entry",
+      "description": "Get an entry",
+      "method": "GET",
+      "path": "/spaces/{space_id}/environments/{environment_id}/entries/{entry_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "space_id": { "type": "string" },
+          "environment_id": { "type": "string" },
+          "entry_id": { "type": "string" }
+        },
+        "required": ["space_id", "environment_id", "entry_id"]
+      }
+    },
+    {
+      "name": "create_entry",
+      "description": "Create an entry of a content type",
+      "method": "POST",
+      "path": "/spaces/{space_id}/environments/{environment_id}/entries",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "space_id": { "type": "string" },
+          "environment_id": { "type": "string" },
+          "content_type": { "type": "string" },
+          "fields": { "type": "object" }
+        },
+        "required": ["space_id", "environment_id", "content_type", "fields"]
+      }
+    },
+    {
+      "name": "update_entry",
+      "description": "Update an entry (requires X-Contentful-Version header)",
+      "method": "PUT",
+      "path": "/spaces/{space_id}/environments/{environment_id}/entries/{entry_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "space_id": { "type": "string" },
+          "environment_id": { "type": "string" },
+          "entry_id": { "type": "string" },
+          "fields": { "type": "object" }
+        },
+        "required": ["space_id", "environment_id", "entry_id", "fields"]
+      }
+    },
+    {
+      "name": "publish_entry",
+      "description": "Publish an entry",
+      "method": "PUT",
+      "path": "/spaces/{space_id}/environments/{environment_id}/entries/{entry_id}/published",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "space_id": { "type": "string" },
+          "environment_id": { "type": "string" },
+          "entry_id": { "type": "string" }
+        },
+        "required": ["space_id", "environment_id", "entry_id"]
+      }
+    },
+    {
+      "name": "unpublish_entry",
+      "description": "Unpublish an entry",
+      "method": "DELETE",
+      "path": "/spaces/{space_id}/environments/{environment_id}/entries/{entry_id}/published",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "space_id": { "type": "string" },
+          "environment_id": { "type": "string" },
+          "entry_id": { "type": "string" }
+        },
+        "required": ["space_id", "environment_id", "entry_id"]
+      }
+    },
+    {
+      "name": "delete_entry",
+      "description": "Delete an entry",
+      "method": "DELETE",
+      "path": "/spaces/{space_id}/environments/{environment_id}/entries/{entry_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "space_id": { "type": "string" },
+          "environment_id": { "type": "string" },
+          "entry_id": { "type": "string" }
+        },
+        "required": ["space_id", "environment_id", "entry_id"]
+      }
+    },
+    {
+      "name": "list_assets",
+      "description": "List assets",
+      "method": "GET",
+      "path": "/spaces/{space_id}/environments/{environment_id}/assets",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "space_id": { "type": "string" },
+          "environment_id": { "type": "string" }
+        },
+        "required": ["space_id", "environment_id"]
+      }
+    },
+    {
+      "name": "list_content_types",
+      "description": "List content types",
+      "method": "GET",
+      "path": "/spaces/{space_id}/environments/{environment_id}/content_types",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "space_id": { "type": "string" },
+          "environment_id": { "type": "string" }
+        },
+        "required": ["space_id", "environment_id"]
+      }
+    }
+  ]
+}