@apteva/integrations 0.3.61 → 0.15.3

package/src/apps/aws-sns.json

@@ -1,233 +1,255 @@
 {
   "slug": "aws-sns",
   "name": "AWS SNS",
-  "description": "MCP server for Amazon SNS - topics, subscriptions, notifications",
+  "description": "Amazon Simple Notification Service — pub/sub topics, HTTP/Email/SQS subscriptions, message publishing. Authenticates via AWS Signature V4. Speaks the AWS Query API on https://sns.{region}.amazonaws.com/?Action=... — every tool here is a thin wrapper over one Query action.",
   "logo": "https://www.google.com/s2/favicons?domain=aws.amazon.com&sz=128",
   "categories": [
     "aws",
-    "sns",
-    "notifications",
     "messaging",
-    "pubsub"
+    "notifications",
+    "pubsub",
+    "infrastructure"
   ],
-  "base_url": "https://sns.{region}.amazonaws.com",
+  "base_url": "https://sns.{{region}}.amazonaws.com",
   "auth": {
     "types": [
-      "bearer"
+      "aws_sigv4"
     ],
-    "headers": {
-      "Authorization": "Bearer {{token}}"
+    "aws_sigv4": {
+      "service": "sns"
     },
     "credential_fields": [
       {
         "name": "access_key_id",
-        "label": "Access_key_id",
-        "description": "Your AWS Access Key ID"
+        "label": "AWS Access Key ID",
+        "description": "IAM access key with sns:* permissions on the topics this app will create / manage. Bootstrap setup needs CreateTopic, Subscribe, ConfirmSubscription, SetTopicAttributes; runtime publish only needs sns:Publish.",
+        "required": true,
+        "type": "text"
       },
       {
         "name": "secret_access_key",
-        "label": "Secret_access_key",
-        "description": "Your AWS Secret Access Key"
+        "label": "AWS Secret Access Key",
+        "required": true,
+        "type": "password"
       },
       {
         "name": "region",
-        "label": "Region",
-        "description": "AWS Region (e.g., us-east-1)"
+        "label": "AWS Region",
+        "description": "Region the SNS topics live in. Must match the region where SES (or any other producer) publishes to them — cross-region SNS is not supported as an SES destination.",
+        "required": true,
+        "type": "text"
       },
       {
         "name": "session_token",
-        "label": "Session_token",
-        "description": "Temporary session token (for temporary credentials)"
+        "label": "AWS Session Token",
+        "description": "Only required when using temporary credentials issued by STS (assume-role, federated identities). Leave blank for long-lived IAM user keys.",
+        "required": false,
+        "type": "password"
       }
     ]
   },
   "tools": [
     {
       "name": "create_topic",
-      "description": "Create an SNS topic",
-      "method": "POST",
-      "path": "/create-topic",
+      "description": "Create a new SNS topic (idempotent — calling with the same Name returns the existing topic's ARN unchanged). Response XML contains CreateTopicResponse.CreateTopicResult.TopicArn.",
+      "method": "GET",
+      "path": "/?Action=CreateTopic",
       "input_schema": {
         "type": "object",
         "properties": {
-          "name": {
-            "type": "string"
+          "Name": {
+            "type": "string",
+            "description": "Topic name (1–256 alphanumeric / hyphen / underscore chars). Must be unique within the AWS account + region."
+          },
+          "Attributes.entry.1.key": {
+            "type": "string",
+            "description": "Optional. First attribute key (e.g. 'Policy', 'DisplayName'). Use the .entry.N.key/.value pattern for additional attributes."
           },
-          "attributes": {
-            "type": "object"
+          "Attributes.entry.1.value": {
+            "type": "string"
           }
         },
-        "required": [
-          "name"
-        ]
+        "required": ["Name"],
+        "additionalProperties": true
       }
     },
     {
-      "name": "subscribe_webhook",
-      "description": "Subscribe webhook to topic",
+      "name": "delete_topic",
+      "description": "Permanently delete a topic and all of its subscriptions. Idempotent — deleting a non-existent topic returns success. Use with care; subscribers receive no further messages.",
       "method": "GET",
-      "path": "/subscribe-webhook",
+      "path": "/?Action=DeleteTopic",
       "input_schema": {
         "type": "object",
         "properties": {
-          "topic_arn": {
-            "type": "string"
-          },
-          "endpoint": {
-            "type": "string"
-          },
-          "protocol": {
+          "TopicArn": {
             "type": "string"
           }
         },
-        "required": [
-          "topic_arn",
-          "endpoint"
-        ]
+        "required": ["TopicArn"]
       }
     },
     {
-      "name": "confirm_subscription",
-      "description": "Confirm SNS subscription",
+      "name": "list_topics",
+      "description": "List all topics in the account + region. Paginated via NextToken. Response XML root: ListTopicsResponse.ListTopicsResult.Topics.member[].",
       "method": "GET",
-      "path": "/confirm-subscription",
+      "path": "/?Action=ListTopics",
       "input_schema": {
         "type": "object",
         "properties": {
-          "topic_arn": {
+          "NextToken": {
             "type": "string"
           }
-        },
-        "required": [
-          "topic_arn"
-        ]
+        }
       }
     },
     {
-      "name": "list_subscriptions",
-      "description": "List SNS subscriptions",
+      "name": "get_topic_attributes",
+      "description": "Fetch a topic's attributes (Owner, Policy, DisplayName, SubscriptionsConfirmed, SubscriptionsPending, etc.). Useful for idempotent bootstrap — read the current Policy before deciding whether to overwrite via set_topic_attributes.",
       "method": "GET",
-      "path": "/list-subscriptions",
+      "path": "/?Action=GetTopicAttributes",
       "input_schema": {
         "type": "object",
         "properties": {
-          "topic_arn": {
+          "TopicArn": {
             "type": "string"
           }
-        }
+        },
+        "required": ["TopicArn"]
       }
     },
     {
-      "name": "unsubscribe",
-      "description": "Unsubscribe from topic",
+      "name": "set_topic_attributes",
+      "description": "Set a single topic attribute. The most common use is `AttributeName=Policy` with `AttributeValue` as the access-policy JSON string — e.g. allowing ses.amazonaws.com to publish to the topic so SES inbound notifications can land there. Other supported attributes: DisplayName, DeliveryPolicy, KmsMasterKeyId, ContentBasedDeduplication.",
       "method": "GET",
-      "path": "/unsubscribe",
+      "path": "/?Action=SetTopicAttributes",
       "input_schema": {
         "type": "object",
         "properties": {
-          "subscription_arn": {
+          "TopicArn": {
             "type": "string"
+          },
+          "AttributeName": {
+            "type": "string",
+            "description": "One of: Policy, DisplayName, DeliveryPolicy, KmsMasterKeyId, ContentBasedDeduplication."
+          },
+          "AttributeValue": {
+            "type": "string",
+            "description": "Stringified attribute value. For Policy, this is the JSON access-policy doc."
           }
         },
-        "required": [
-          "subscription_arn"
-        ]
+        "required": ["TopicArn", "AttributeName", "AttributeValue"]
       }
     },
     {
-      "name": "set_notification_topics",
-      "description": "Configure SES notification topics",
+      "name": "subscribe",
+      "description": "Create a subscription on a topic. For HTTPS subscribers (Apteva webhooks) AWS sends a SubscriptionConfirmation message to the endpoint first; the endpoint must POST a confirm_subscription. Pass ReturnSubscriptionArn=true so the response includes a real ARN immediately even when confirmation is still pending.",
       "method": "GET",
-      "path": "/set-notification-topics",
+      "path": "/?Action=Subscribe",
       "input_schema": {
         "type": "object",
         "properties": {
-          "identity": {
+          "TopicArn": {
             "type": "string"
           },
-          "bounce_topic": {
-            "type": "string"
+          "Protocol": {
+            "type": "string",
+            "description": "One of: http, https, email, email-json, sms, sqs, application, lambda, firehose."
           },
-          "complaint_topic": {
-            "type": "string"
+          "Endpoint": {
+            "type": "string",
+            "description": "URL / phone / email / ARN appropriate to Protocol."
           },
-          "delivery_topic": {
-            "type": "string"
+          "ReturnSubscriptionArn": {
+            "type": "string",
+            "description": "Pass 'true' to get the SubscriptionArn back immediately (otherwise PendingConfirmation until the endpoint confirms).",
+            "default": "true"
           }
         },
-        "required": [
-          "identity"
-        ]
+        "required": ["TopicArn", "Protocol", "Endpoint"]
       }
     },
     {
-      "name": "configure_event_publishing",
-      "description": "Configure SES event publishing to SNS",
+      "name": "confirm_subscription",
+      "description": "Confirm a pending subscription. Used when the platform is acting on the subscriber's behalf (rare — normally the subscriber endpoint does this itself when AWS POSTs the SubscriptionConfirmation message to it). Token comes from the SubscriptionConfirmation payload.",
       "method": "GET",
-      "path": "/configure-event-publishing",
+      "path": "/?Action=ConfirmSubscription",
       "input_schema": {
         "type": "object",
         "properties": {
-          "config_set_name": {
+          "TopicArn": {
             "type": "string"
           },
-          "event_destination_name": {
+          "Token": {
             "type": "string"
           },
-          "sns_topic_arn": {
-            "type": "string"
-          },
-          "matching_event_types": {
-            "type": "array"
+          "AuthenticateOnUnsubscribe": {
+            "type": "string",
+            "description": "Pass 'true' to require AWS auth for unsubscription. Defaults to false."
           }
         },
-        "required": [
-          "config_set_name",
-          "event_destination_name",
-          "sns_topic_arn"
-        ]
+        "required": ["TopicArn", "Token"]
       }
     },
     {
-      "name": "configure_tracking",
-      "description": "Configure SES tracking",
+      "name": "list_subscriptions_by_topic",
+      "description": "List subscriptions on a topic. Paginated via NextToken. Response XML root: ListSubscriptionsByTopicResponse.ListSubscriptionsByTopicResult.Subscriptions.member[].",
       "method": "GET",
-      "path": "/configure-tracking",
+      "path": "/?Action=ListSubscriptionsByTopic",
       "input_schema": {
         "type": "object",
         "properties": {
-          "config_set_name": {
+          "TopicArn": {
             "type": "string"
           },
-          "custom_redirect_domain": {
+          "NextToken": {
             "type": "string"
           }
         },
-        "required": [
-          "config_set_name"
-        ]
+        "required": ["TopicArn"]
       }
     },
     {
-      "name": "verify_event_destination",
-      "description": "Verify event destination configuration",
+      "name": "unsubscribe",
+      "description": "Cancel a subscription. Idempotent. Pass the SubscriptionArn returned from subscribe / list_subscriptions_by_topic.",
       "method": "GET",
-      "path": "/verify-event-destination",
+      "path": "/?Action=Unsubscribe",
       "input_schema": {
         "type": "object",
         "properties": {
-          "config_set_name": {
+          "SubscriptionArn": {
+            "type": "string"
+          }
+        },
+        "required": ["SubscriptionArn"]
+      }
+    },
+    {
+      "name": "publish",
+      "description": "Publish a message to a topic (or directly to a phone number / endpoint). Useful for fanout patterns and for one-off test notifications.",
+      "method": "GET",
+      "path": "/?Action=Publish",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "TopicArn": {
             "type": "string"
           },
-          "event_destination_name": {
+          "Message": {
             "type": "string"
+          },
+          "Subject": {
+            "type": "string"
+          },
+          "MessageStructure": {
+            "type": "string",
+            "description": "Pass 'json' when Message is itself a JSON object keyed by protocol (default, http, email, sms, sqs)."
           }
         },
-        "required": [
-          "config_set_name",
-          "event_destination_name"
-        ]
+        "required": ["Message"]
       }
     }
-  ]
+  ],
+  "health_check": {
+    "tool": "list_topics"
+  }
 }

package/src/apps/azure-container-apps.json

@@ -0,0 +1,116 @@
+{
+  "slug": "azure-container-apps",
+  "name": "Azure Container Apps",
+  "description": "Microsoft's serverless container platform — Consumption plan bills per-second on vCPU + GB allocated. Useful as a pay-per-use builder or runtime when already on Azure. Authenticates against the Azure Resource Manager (ARM) with a bearer token from Azure AD (service principal client_credentials grant or managed identity).",
+  "logo": "https://www.google.com/s2/favicons?domain=azure.microsoft.com&sz=128",
+  "categories": ["azure", "containers", "serverless", "compute", "build"],
+  "base_url": "https://management.azure.com",
+  "auth": {
+    "types": ["bearer"],
+    "headers": { "Authorization": "Bearer {{access_token}}" },
+    "credential_fields": [
+      { "name": "access_token", "label": "ARM Access Token", "description": "Azure AD access token with audience=https://management.azure.com/. Get with: az account get-access-token --resource https://management.azure.com/ --query accessToken -o tsv", "required": true, "type": "password" },
+      { "name": "subscription_id", "label": "Subscription ID", "description": "Azure subscription UUID", "required": true, "type": "text" },
+      { "name": "resource_group", "label": "Resource Group", "description": "Default resource group for container app operations", "required": true, "type": "text" }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_environments",
+      "description": "List Container App Environments in the resource group.",
+      "method": "GET",
+      "path": "/subscriptions/{{subscription_id}}/resourceGroups/{{resource_group}}/providers/Microsoft.App/managedEnvironments?api-version=2024-03-01",
+      "input_schema": { "type": "object", "properties": {} }
+    },
+    {
+      "name": "list_apps",
+      "description": "List container apps in the resource group.",
+      "method": "GET",
+      "path": "/subscriptions/{{subscription_id}}/resourceGroups/{{resource_group}}/providers/Microsoft.App/containerApps?api-version=2024-03-01",
+      "input_schema": { "type": "object", "properties": {} }
+    },
+    {
+      "name": "create_app",
+      "description": "Create or update a container app (Consumption plan). Args: app_name, location, environment_id (full ARM id), image, cpu? (0.25..2 cores), memory? (0.5Gi..4Gi), env? (array of {name, value}), ingress_target_port?.",
+      "method": "PUT",
+      "path": "/subscriptions/{{subscription_id}}/resourceGroups/{{resource_group}}/providers/Microsoft.App/containerApps/{app_name}?api-version=2024-03-01",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "app_name": { "type": "string" },
+          "location": { "type": "string" },
+          "environment_id": { "type": "string" },
+          "image": { "type": "string" },
+          "cpu": { "type": "number" },
+          "memory": { "type": "string" },
+          "env": { "type": "array", "items": { "type": "object" } },
+          "ingress_target_port": { "type": "integer" }
+        },
+        "required": ["app_name", "location", "environment_id", "image"]
+      }
+    },
+    {
+      "name": "get_app",
+      "description": "Get a container app. Args: app_name.",
+      "method": "GET",
+      "path": "/subscriptions/{{subscription_id}}/resourceGroups/{{resource_group}}/providers/Microsoft.App/containerApps/{app_name}?api-version=2024-03-01",
+      "input_schema": {
+        "type": "object",
+        "properties": { "app_name": { "type": "string" } },
+        "required": ["app_name"]
+      }
+    },
+    {
+      "name": "delete_app",
+      "description": "Delete a container app. Args: app_name.",
+      "method": "DELETE",
+      "path": "/subscriptions/{{subscription_id}}/resourceGroups/{{resource_group}}/providers/Microsoft.App/containerApps/{app_name}?api-version=2024-03-01",
+      "input_schema": {
+        "type": "object",
+        "properties": { "app_name": { "type": "string" } },
+        "required": ["app_name"]
+      }
+    },
+    {
+      "name": "list_revisions",
+      "description": "List revisions for a container app (each PUT creates a new revision). Args: app_name.",
+      "method": "GET",
+      "path": "/subscriptions/{{subscription_id}}/resourceGroups/{{resource_group}}/providers/Microsoft.App/containerApps/{app_name}/revisions?api-version=2024-03-01",
+      "input_schema": {
+        "type": "object",
+        "properties": { "app_name": { "type": "string" } },
+        "required": ["app_name"]
+      }
+    },
+    {
+      "name": "create_job",
+      "description": "Create a one-shot Container Apps Job (per-second billed, terminates on exit). Useful for builds. Args: job_name, location, environment_id, image, command? (array), cpu?, memory?.",
+      "method": "PUT",
+      "path": "/subscriptions/{{subscription_id}}/resourceGroups/{{resource_group}}/providers/Microsoft.App/jobs/{job_name}?api-version=2024-03-01",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "job_name": { "type": "string" },
+          "location": { "type": "string" },
+          "environment_id": { "type": "string" },
+          "image": { "type": "string" },
+          "command": { "type": "array", "items": { "type": "string" } },
+          "cpu": { "type": "number" },
+          "memory": { "type": "string" }
+        },
+        "required": ["job_name", "location", "environment_id", "image"]
+      }
+    },
+    {
+      "name": "start_job",
+      "description": "Start a job execution. Args: job_name.",
+      "method": "POST",
+      "path": "/subscriptions/{{subscription_id}}/resourceGroups/{{resource_group}}/providers/Microsoft.App/jobs/{job_name}/start?api-version=2024-03-01",
+      "input_schema": {
+        "type": "object",
+        "properties": { "job_name": { "type": "string" } },
+        "required": ["job_name"]
+      }
+    }
+  ]
+}

package/src/apps/backblaze-b2.json

@@ -0,0 +1,175 @@
+{
+  "slug": "backblaze-b2",
+  "name": "Backblaze B2",
+  "description": "Backblaze B2 \u2014 S3-compatible object storage at $6/TB/month storage, $10/TB egress (free if pulled through the Cloudflare Bandwidth Alliance). Bucket-scoped REST endpoints with AWS SigV4 against s3.{region}.backblazeb2.com. Region examples: us-west-001, us-west-002, us-west-004, us-east-005, eu-central-003. Generate an Application Key at backblaze.com \u2192 App Keys; the keyID + applicationKey pair maps to access_key_id + secret_access_key here.",
+  "logo": "https://www.google.com/s2/favicons?domain=backblaze.com&sz=128",
+  "categories": [
+    "storage",
+    "backblaze",
+    "cloud",
+    "infrastructure",
+    "s3-compatible",
+    "cold-storage"
+  ],
+  "base_url": "https://s3.{{region}}.backblazeb2.com",
+  "auth": {
+    "types": [
+      "aws_sigv4"
+    ],
+    "aws_sigv4": {
+      "service": "s3"
+    },
+    "credential_fields": [
+      {
+        "name": "region",
+        "label": "Region",
+        "description": "B2 region of your bucket \u2014 e.g. us-west-001, us-west-002, us-west-004, us-east-005, eu-central-003. Find it in the bucket's endpoint URL in the B2 dashboard.",
+        "required": true,
+        "type": "text",
+        "default": "us-west-004"
+      },
+      {
+        "name": "access_key_id",
+        "label": "B2 Application Key ID",
+        "description": "Application keyID from backblaze.com \u2192 App Keys. Master Application Key works but a bucket-scoped key is safer.",
+        "required": true,
+        "type": "text"
+      },
+      {
+        "name": "secret_access_key",
+        "label": "B2 Application Key",
+        "description": "applicationKey returned alongside the keyID at creation. Shown once \u2014 regenerate if lost.",
+        "required": true,
+        "type": "password"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_objects",
+      "description": "List objects in a bucket (S3-compatible ListObjectsV2). Returns XML; parse Contents[].Key / Size / LastModified, plus IsTruncated + NextContinuationToken for pagination.",
+      "method": "GET",
+      "path": "/{bucket}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "bucket": {
+            "type": "string",
+            "description": "B2 bucket name."
+          },
+          "prefix": {
+            "type": "string",
+            "description": "Filter to keys starting with this prefix."
+          },
+          "continuation-token": {
+            "type": "string",
+            "description": "Pagination cursor from a prior IsTruncated response."
+          },
+          "max-keys": {
+            "type": "integer",
+            "description": "Page size (max 1000)."
+          },
+          "list-type": {
+            "type": "integer",
+            "default": 2
+          }
+        },
+        "required": [
+          "bucket"
+        ]
+      },
+      "query_params": [
+        "prefix",
+        "continuation-token",
+        "max-keys",
+        "list-type"
+      ]
+    },
+    {
+      "name": "put_object",
+      "description": "Upload an object. Pass content as 'body'; the runner sends it verbatim with SigV4-signed integrity hash. B2's S3 API supports objects up to 5GB single-PUT; for larger objects use multipart upload (not yet exposed here).",
+      "method": "PUT",
+      "path": "/{bucket}/{key}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "bucket": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string",
+            "description": "Object key (path inside the bucket)."
+          },
+          "body": {
+            "type": "string",
+            "description": "Object content. Bytes welcome \u2014 the runner sends them verbatim."
+          }
+        },
+        "required": [
+          "bucket",
+          "key",
+          "body"
+        ]
+      },
+      "body_input": "body"
+    },
+    {
+      "name": "get_object",
+      "description": "Download an object. Response body is the raw object bytes (response cap 200MB).",
+      "method": "GET",
+      "path": "/{bucket}/{key}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "bucket": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "bucket",
+          "key"
+        ]
+      }
+    },
+    {
+      "name": "delete_object",
+      "description": "Delete a single object. Returns 204 on success. Note: B2 buckets with file-version retention will keep prior versions \u2014 this only deletes the latest.",
+      "method": "DELETE",
+      "path": "/{bucket}/{key}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "bucket": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "bucket",
+          "key"
+        ]
+      }
+    },
+    {
+      "name": "list_buckets",
+      "description": "List all B2 buckets visible to the application key. Returns XML; ListAllMyBucketsResult.Buckets.Bucket[] has the names + creation dates.",
+      "method": "GET",
+      "path": "/",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    }
+  ],
+  "health_check": {
+    "tool": "list_buckets",
+    "auth_ok_when_body_contains": [
+      "AccessDenied"
+    ]
+  }
+}