@apteva/integrations 0.15.9 → 0.15.11

package/src/apps/paddle.json

@@ -1,16 +1,19 @@
 {
   "slug": "paddle",
   "name": "Paddle",
-  "description": "MCP server for Paddle Billing - products, prices, subscriptions, customers, transactions",
+  "description": "Paddle Billing merchant-of-record API for products, prices, customers, subscriptions, transactions, refunds/adjustments, and checkout-style payment links. Paddle does not host uploaded audio files directly; use it to sell access to products delivered by your app or storage layer.",
   "logo": "https://www.google.com/s2/favicons?domain=paddle.com&sz=128",
   "categories": ["payments", "billing", "subscriptions", "merchant-of-record"],
   "base_url": "https://api.paddle.com",
   "auth": {
     "types": ["bearer"],
-    "headers": { "Authorization": "Bearer {{token}}" },
+    "headers": {
+      "Authorization": "Bearer {{token}}",
+      "Content-Type": "application/json"
+    },
     "credential_fields": [
       { "name": "token", "label": "API Key", "description": "Paddle API key (pdl_live_... or pdl_sdbx_...)" },
-      { "name": "webhookSecret", "label": "Webhook Secret" }
+      { "name": "webhookSecret", "label": "Webhook Secret", "required": false, "description": "Optional Paddle webhook signing secret used only for verifying incoming webhooks." }
     ]
   },
   "tools": [
@@ -23,13 +26,25 @@
         "type": "object",
         "properties": {
           "status": { "type": "string" },
+          "ids": { "type": "array", "items": { "type": "string" } },
           "per_page": { "type": "number" }
         }
       }
     },
+    {
+      "name": "get_product",
+      "description": "Retrieve one Paddle product.",
+      "method": "GET",
+      "path": "/products/{product_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "product_id": { "type": "string" } },
+        "required": ["product_id"]
+      }
+    },
     {
       "name": "create_product",
-      "description": "Create a product",
+      "description": "Create a product in Paddle. For digital audio, this creates the sellable catalog product/access item; Paddle does not upload or store the audio file itself.",
       "method": "POST",
       "path": "/products",
       "input_schema": {
@@ -42,6 +57,23 @@
         "required": ["name", "tax_category"]
       }
     },
+    {
+      "name": "update_product",
+      "description": "Update a Paddle product.",
+      "method": "PATCH",
+      "path": "/products/{product_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "product_id": { "type": "string" },
+          "name": { "type": "string" },
+          "tax_category": { "type": "string" },
+          "description": { "type": "string" },
+          "status": { "type": "string" }
+        },
+        "required": ["product_id"]
+      }
+    },
     {
       "name": "list_prices",
       "description": "List prices",
@@ -51,10 +83,23 @@
         "type": "object",
         "properties": {
           "product_id": { "type": "array" },
-          "status": { "type": "string" }
+          "status": { "type": "string" },
+          "ids": { "type": "array", "items": { "type": "string" } },
+          "per_page": { "type": "number" }
         }
       }
     },
+    {
+      "name": "get_price",
+      "description": "Retrieve one Paddle price.",
+      "method": "GET",
+      "path": "/prices/{price_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "price_id": { "type": "string" } },
+        "required": ["price_id"]
+      }
+    },
     {
       "name": "create_price",
       "description": "Create a price for a product",
@@ -71,6 +116,25 @@
         "required": ["product_id", "description", "unit_price"]
       }
     },
+    {
+      "name": "update_price",
+      "description": "Update a Paddle price, for example description, status, billing_cycle, trial_period, unit_price, or custom_data.",
+      "method": "PATCH",
+      "path": "/prices/{price_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "price_id": { "type": "string" },
+          "description": { "type": "string" },
+          "unit_price": { "type": "object" },
+          "billing_cycle": { "type": "object" },
+          "trial_period": { "type": "object" },
+          "status": { "type": "string" },
+          "custom_data": { "type": "object" }
+        },
+        "required": ["price_id"]
+      }
+    },
     {
       "name": "list_customers",
       "description": "List customers",
@@ -80,10 +144,23 @@
         "type": "object",
         "properties": {
           "email": { "type": "array" },
-          "status": { "type": "string" }
+          "status": { "type": "string" },
+          "ids": { "type": "array", "items": { "type": "string" } },
+          "per_page": { "type": "number" }
         }
       }
     },
+    {
+      "name": "get_customer",
+      "description": "Retrieve one Paddle customer.",
+      "method": "GET",
+      "path": "/customers/{customer_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "customer_id": { "type": "string" } },
+        "required": ["customer_id"]
+      }
+    },
     {
       "name": "create_customer",
       "description": "Create a customer",
@@ -99,6 +176,24 @@
         "required": ["email"]
       }
     },
+    {
+      "name": "update_customer",
+      "description": "Update a Paddle customer.",
+      "method": "PATCH",
+      "path": "/customers/{customer_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "customer_id": { "type": "string" },
+          "email": { "type": "string" },
+          "name": { "type": "string" },
+          "locale": { "type": "string" },
+          "status": { "type": "string" },
+          "custom_data": { "type": "object" }
+        },
+        "required": ["customer_id"]
+      }
+    },
     {
       "name": "list_subscriptions",
       "description": "List subscriptions",
@@ -108,7 +203,10 @@
         "type": "object",
         "properties": {
           "customer_id": { "type": "array" },
-          "status": { "type": "array" }
+          "status": { "type": "array" },
+          "product_id": { "type": "array", "items": { "type": "string" } },
+          "price_id": { "type": "array", "items": { "type": "string" } },
+          "per_page": { "type": "number" }
         }
       }
     },
@@ -123,6 +221,23 @@
         "required": ["subscription_id"]
       }
     },
+    {
+      "name": "update_subscription",
+      "description": "Update a Paddle subscription. Use for changing items, scheduled_change, proration_billing_mode, custom_data, collection_mode, or billing details according to Paddle's Billing API.",
+      "method": "PATCH",
+      "path": "/subscriptions/{subscription_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "subscription_id": { "type": "string" },
+          "items": { "type": "array" },
+          "scheduled_change": { "type": "object" },
+          "proration_billing_mode": { "type": "string" },
+          "custom_data": { "type": "object" }
+        },
+        "required": ["subscription_id"]
+      }
+    },
     {
       "name": "cancel_subscription",
       "description": "Cancel a subscription",
@@ -146,10 +261,23 @@
         "type": "object",
         "properties": {
           "customer_id": { "type": "array" },
-          "status": { "type": "array" }
+          "status": { "type": "array" },
+          "subscription_id": { "type": "array", "items": { "type": "string" } },
+          "per_page": { "type": "number" }
         }
       }
     },
+    {
+      "name": "get_transaction",
+      "description": "Retrieve one Paddle transaction. A completed/ready transaction may include checkout/payment link fields depending on creation parameters and Paddle response shape.",
+      "method": "GET",
+      "path": "/transactions/{transaction_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "transaction_id": { "type": "string" } },
+        "required": ["transaction_id"]
+      }
+    },
     {
       "name": "create_transaction",
       "description": "Create a transaction (e.g. for one-time charge)",
@@ -165,6 +293,68 @@
         },
         "required": ["items"]
       }
+    },
+    {
+      "name": "update_transaction",
+      "description": "Update a draft Paddle transaction before it is billed.",
+      "method": "PATCH",
+      "path": "/transactions/{transaction_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "transaction_id": { "type": "string" },
+          "items": { "type": "array" },
+          "customer_id": { "type": "string" },
+          "currency_code": { "type": "string" },
+          "collection_mode": { "type": "string" },
+          "billing_details": { "type": "object" },
+          "custom_data": { "type": "object" }
+        },
+        "required": ["transaction_id"]
+      }
+    },
+    {
+      "name": "list_adjustments",
+      "description": "List Paddle adjustments such as refunds and credits.",
+      "method": "GET",
+      "path": "/adjustments",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "action": { "type": "array", "items": { "type": "string" } },
+          "status": { "type": "array", "items": { "type": "string" } },
+          "transaction_id": { "type": "array", "items": { "type": "string" } },
+          "per_page": { "type": "number" }
+        }
+      }
+    },
+    {
+      "name": "create_adjustment",
+      "description": "Create a Paddle adjustment, commonly a refund or credit. Body fields depend on action/type and Paddle's adjustment API.",
+      "method": "POST",
+      "path": "/adjustments",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "action": { "type": "string" },
+          "transaction_id": { "type": "string" },
+          "reason": { "type": "string" },
+          "items": { "type": "array" }
+        },
+        "required": ["action", "transaction_id"]
+      }
+    },
+    {
+      "name": "get_adjustment",
+      "description": "Retrieve one Paddle adjustment.",
+      "method": "GET",
+      "path": "/adjustments/{adjustment_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "adjustment_id": { "type": "string" } },
+        "required": ["adjustment_id"]
+      }
     }
-  ]
+  ],
+  "health_check": { "tool": "list_products" }
 }

package/src/apps/payhip.json

@@ -0,0 +1,162 @@
+{
+  "slug": "payhip",
+  "name": "Payhip",
+  "description": "Payhip creator-commerce API for coupons and license-key management. Payhip is useful for selling digital products through its hosted storefront, but its public API does not create products or upload downloadable audio files.",
+  "logo": "https://www.google.com/s2/favicons?domain=payhip.com&sz=128",
+  "categories": ["payments", "commerce", "creator-economy", "digital-products", "coupons", "licenses"],
+  "base_url": "https://payhip.com",
+  "auth": {
+    "types": ["api_key"],
+    "headers": {
+      "payhip-api-key": "{{apiKey}}",
+      "Content-Type": "application/x-www-form-urlencoded"
+    },
+    "credential_fields": [
+      {
+        "name": "apiKey",
+        "label": "API Key",
+        "description": "Payhip API key from your Payhip account settings."
+      },
+      {
+        "name": "productSecretKey",
+        "label": "Product Secret Key",
+        "required": false,
+        "description": "Optional product secret key used by Payhip's license-key endpoints."
+      }
+    ]
+  },
+  "health_check": {
+    "tool": "list_coupons"
+  },
+  "tools": [
+    {
+      "name": "create_coupon",
+      "description": "Create a Payhip coupon. Use coupon_type='single' with product_key for one product, 'collection' with collection_id, or 'all' for all products.",
+      "method": "POST",
+      "path": "/api/v2/coupons",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "code": { "type": "string" },
+          "coupon_type": { "type": "string", "enum": ["single", "all", "collection"] },
+          "percent_off": { "type": "number" },
+          "amount_off": { "type": "number" },
+          "product_key": { "type": "string" },
+          "collection_id": { "type": "string" },
+          "start_date": { "type": "string", "description": "Start date accepted by Payhip, for example YYYY-MM-DD." },
+          "end_date": { "type": "string", "description": "End date accepted by Payhip, for example YYYY-MM-DD." },
+          "minimum_purchase_amount": { "type": "number" },
+          "number_of_uses": { "type": "integer" },
+          "note": { "type": "string" }
+        },
+        "required": ["code", "coupon_type"]
+      }
+    },
+    {
+      "name": "list_coupons",
+      "description": "List Payhip coupons.",
+      "method": "GET",
+      "path": "/api/v2/coupons",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": { "type": "integer" },
+          "offset": { "type": "integer" }
+        }
+      }
+    },
+    {
+      "name": "get_coupon",
+      "description": "Retrieve one Payhip coupon.",
+      "method": "GET",
+      "path": "/api/v2/coupons/{coupon_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "coupon_id": { "type": "string" }
+        },
+        "required": ["coupon_id"]
+      }
+    },
+    {
+      "name": "verify_license",
+      "description": "Verify a Payhip product license key. Requires the Product Secret Key credential.",
+      "method": "GET",
+      "path": "/api/v2/license/verify",
+      "headers": {
+        "product-secret-key": "{{productSecretKey}}"
+      },
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "license_key": { "type": "string" }
+        },
+        "required": ["license_key"]
+      }
+    },
+    {
+      "name": "disable_license",
+      "description": "Disable a Payhip license key. Requires the Product Secret Key credential.",
+      "method": "PUT",
+      "path": "/api/v2/license/disable",
+      "headers": {
+        "product-secret-key": "{{productSecretKey}}"
+      },
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "license_key": { "type": "string" }
+        },
+        "required": ["license_key"]
+      }
+    },
+    {
+      "name": "enable_license",
+      "description": "Enable a Payhip license key. Requires the Product Secret Key credential.",
+      "method": "PUT",
+      "path": "/api/v2/license/enable",
+      "headers": {
+        "product-secret-key": "{{productSecretKey}}"
+      },
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "license_key": { "type": "string" }
+        },
+        "required": ["license_key"]
+      }
+    },
+    {
+      "name": "increase_license_usage",
+      "description": "Increase or record usage for a Payhip license key. Requires the Product Secret Key credential.",
+      "method": "PUT",
+      "path": "/api/v2/license/usage",
+      "headers": {
+        "product-secret-key": "{{productSecretKey}}"
+      },
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "license_key": { "type": "string" }
+        },
+        "required": ["license_key"]
+      }
+    },
+    {
+      "name": "decrease_license_usage",
+      "description": "Decrease usage for a Payhip license key. Requires the Product Secret Key credential.",
+      "method": "PUT",
+      "path": "/api/v2/license/decrease",
+      "headers": {
+        "product-secret-key": "{{productSecretKey}}"
+      },
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "license_key": { "type": "string" }
+        },
+        "required": ["license_key"]
+      }
+    }
+  ]
+}