@apteva/integrations 0.15.10 → 0.15.11

package/src/apps/sculpteo.json

@@ -1,233 +1,151 @@
 {
   "slug": "sculpteo",
   "name": "Sculpteo",
-  "description": "MCP server for Sculpteo 3D printing services - upload models, get quotes, configure designs, and place orders",
+  "description": "Sculpteo WebAPI for uploading designs, listing public designs/materials, pricing designs, ordering designs, and tracking orders.",
   "logo": "https://www.google.com/s2/favicons?domain=sculpteo.com&sz=128",
-  "categories": [
-    "3d-printing",
-    "sculpteo",
-    "manufacturing",
-    "prototyping",
-    "materials"
-  ],
-  "base_url": "https://api.sculpteo.com/v1",
+  "categories": ["3d-printing", "sculpteo", "manufacturing", "prototyping", "materials"],
+  "base_url": "https://www.sculpteo.com",
   "auth": {
-    "types": [
-      "bearer"
-    ],
+    "types": ["api_key"],
     "headers": {
-      "Authorization": "Bearer {{token}}"
+      "Content-Type": "application/x-www-form-urlencoded"
+    },
+    "body_params": {
+      "login": "{{login}}",
+      "password": "{{password}}"
     },
     "credential_fields": [
       {
-        "name": "token",
-        "label": "Api Key",
-        "description": "Sculpteo API key from your Sculpteo account settings"
+        "name": "login",
+        "label": "Login",
+        "description": "Sculpteo account login/email used by order APIs."
+      },
+      {
+        "name": "password",
+        "label": "Password",
+        "type": "password",
+        "description": "Sculpteo account password used by order APIs."
       }
     ]
   },
   "tools": [
     {
       "name": "list_materials",
-      "description": "Get available materials and their properties from Sculpteo",
+      "description": "List Sculpteo materials in JSON. Material ids are used by price and order calls.",
       "method": "GET",
-      "path": "/list-materials",
+      "path": "/{language}/api/material/list/",
       "input_schema": {
         "type": "object",
         "properties": {
-          "category": {
-            "type": "string",
-            "description": "Filter by material category (plastic, metal, resin)"
-          },
-          "technology": {
-            "type": "string",
-            "description": "Filter by printing technology (SLS, SLA, DMLS, FDM)"
-          }
-        }
+          "language": { "type": "string", "enum": ["en", "fr"], "default": "en" }
+        },
+        "required": ["language"]
       }
     },
     {
-      "name": "upload_and_repair",
-      "description": "Upload 3D model to Sculpteo with automatic repair and optimization",
-      "method": "POST",
-      "path": "/upload-and-repair",
+      "name": "list_designs",
+      "description": "Search or page Sculpteo public designs.",
+      "method": "GET",
+      "path": "/{language}/gallery/x_design_list/",
+      "query_params": ["order_by", "designer", "design_list", "search", "start", "count", "paginate_by", "page"],
       "input_schema": {
         "type": "object",
         "properties": {
-          "file": {
-            "type": "string",
-            "description": "Base64 encoded 3D model file (STL, OBJ, etc.)"
-          },
-          "fileName": {
-            "type": "string",
-            "description": "Name of the file"
-          },
-          "autoRepair": {
-            "type": "boolean",
-            "description": "Automatically repair model issues",
-            "default": true
-          },
-          "optimize": {
-            "type": "boolean",
-            "description": "Optimize model for 3D printing",
-            "default": true
-          }
+          "language": { "type": "string", "enum": ["en", "fr"], "default": "en" },
+          "order_by": { "type": "string", "enum": ["timestamp", "rate"] },
+          "designer": { "type": "string" },
+          "design_list": { "type": "string" },
+          "search": { "type": "string" },
+          "start": { "type": "integer" },
+          "count": { "type": "integer" },
+          "paginate_by": { "type": "integer" },
+          "page": { "type": "integer" }
         },
-        "required": [
-          "file",
-          "fileName"
-        ]
+        "required": ["language"]
       }
     },
     {
-      "name": "configure_design",
-      "description": "Configure 3D design with material, finish, and scaling options",
-      "method": "GET",
-      "path": "/configure-design",
+      "name": "upload_design_base64",
+      "description": "Upload a design using Sculpteo's direct upload endpoint with urlsafe base64 file data. For multipart uploads, use Sculpteo directly because the generic runner does not yet send multipart bodies.",
+      "method": "POST",
+      "path": "/{language}/upload_design/a/3D/",
       "input_schema": {
         "type": "object",
         "properties": {
-          "designId": {
-            "type": "string",
-            "description": "ID of the uploaded design"
-          },
-          "materialId": {
-            "type": "string",
-            "description": "Material ID to use for printing"
-          },
-          "finishId": {
-            "type": "string",
-            "description": "Finish/color ID"
-          },
-          "scale": {
-            "type": "number",
-            "description": "Scale factor for the model",
-            "default": 1
-          },
-          "quantity": {
-            "type": "number",
-            "description": "Number of copies to print",
-            "default": 1
-          }
+          "language": { "type": "string", "enum": ["en", "fr"], "default": "en" },
+          "file": { "type": "string", "description": "URL-safe base64 model data, using - and _ instead of + and /." },
+          "filename": { "type": "string", "description": "Filename with extension." },
+          "name": { "type": "string", "description": "Design name." },
+          "description": { "type": "string" },
+          "keywords": { "type": "string" },
+          "share": { "type": "integer", "enum": [0, 1], "default": 0 },
+          "print_authorization": { "type": "integer", "enum": [0, 1], "default": 1 },
+          "customizable": { "type": "integer", "enum": [0, 1], "default": 0 },
+          "unit": { "type": "string", "enum": ["mm", "cm", "in", "ft", "yd"], "default": "cm" },
+          "scale": { "type": "number", "default": 1 },
+          "materials": { "type": "string", "description": "Comma-separated material ids to allow." }
         },
-        "required": [
-          "designId",
-          "materialId"
-        ]
+        "required": ["language", "file", "filename", "name"]
       }
     },
     {
-      "name": "batch_quote",
-      "description": "Get pricing quotes for multiple designs and material combinations",
+      "name": "get_price_by_uuid",
+      "description": "Get 3D print price for a Sculpteo design UUID, material, scale, quantity, unit, and currency.",
       "method": "GET",
-      "path": "/batch-quote",
+      "path": "/{language}/api/design/3D/price_by_uuid/",
+      "query_params": ["uuid", "quantity", "scale", "unit", "currency", "productname"],
       "input_schema": {
         "type": "object",
         "properties": {
-          "items": {
-            "type": "array",
-            "description": "Array of design configurations to quote",
-            "items": {
-              "type": "object",
-              "properties": {
-                "designId": {
-                  "type": "string"
-                },
-                "materialId": {
-                  "type": "string"
-                },
-                "quantity": {
-                  "type": "number",
-                  "default": 1
-                }
-              },
-              "required": [
-                "designId",
-                "materialId"
-              ]
-            }
-          },
-          "shippingCountry": {
-            "type": "string",
-            "description": "ISO country code for shipping"
-          }
+          "language": { "type": "string", "enum": ["en", "fr"], "default": "en" },
+          "uuid": { "type": "string", "description": "Sculpteo design UUID." },
+          "quantity": { "type": "integer", "default": 1 },
+          "scale": { "type": "number", "default": 1 },
+          "unit": { "type": "string", "enum": ["mm", "cm", "m", "in", "ft", "yd"], "default": "cm" },
+          "currency": { "type": "string", "enum": ["EUR", "USD", "GBP"] },
+          "productname": { "type": "string", "description": "Material id, or comma-separated material ids for multi-material pricing." }
         },
-        "required": [
-          "items"
-        ]
+        "required": ["language", "uuid"]
       }
     },
     {
       "name": "create_order",
-      "description": "Place a 3D printing order with configured designs",
+      "description": "Order Sculpteo designs by UUID. The API uses form keys item[0], item[1], etc. Each item value is '<uuid>:<qty>:<scale>:<unit>:<material>'. Invoice ordering must be enabled by Sculpteo.",
       "method": "POST",
-      "path": "/create-order",
+      "path": "/{language}/api/store/3D/order/",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "language": { "type": "string", "enum": ["en", "fr"], "default": "en" },
+          "item[0]": { "type": "string", "description": "First item as <uuid>:<qty>:<scale>:<unit>:<material>." },
+          "item[1]": { "type": "string", "description": "Optional second item as <uuid>:<qty>:<scale>:<unit>:<material>." },
+          "item[2]": { "type": "string", "description": "Optional third item as <uuid>:<qty>:<scale>:<unit>:<material>." },
+          "ship_addressee": { "type": "string" },
+          "ship_street1": { "type": "string" },
+          "ship_street2": { "type": "string" },
+          "ship_city": { "type": "string" },
+          "ship_state": { "type": "string" },
+          "ship_postal_code": { "type": "string" },
+          "ship_country": { "type": "string", "description": "ISO 3166-1 alpha-2 country code." },
+          "ship_method": { "type": "string", "enum": ["express", "quick"] },
+          "notification_url": { "type": "string", "description": "Optional webhook URL for order status changes." },
+          "fake": { "type": "integer", "enum": [0, 1], "description": "Use 1 for Sculpteo API test orders where supported." },
+          "comment": { "type": "string" }
+        },
+        "required": ["language", "item[0]"]
+      }
+    },
+    {
+      "name": "get_order_tracking",
+      "description": "Open tracking/status information for a Sculpteo order reference returned by create_order.",
+      "method": "GET",
+      "path": "/shop/tracking/reference/{reference}",
       "input_schema": {
         "type": "object",
         "properties": {
-          "items": {
-            "type": "array",
-            "description": "Array of configured designs to order",
-            "items": {
-              "type": "object",
-              "properties": {
-                "designId": {
-                  "type": "string"
-                },
-                "materialId": {
-                  "type": "string"
-                },
-                "finishId": {
-                  "type": "string"
-                },
-                "quantity": {
-                  "type": "number",
-                  "default": 1
-                }
-              },
-              "required": [
-                "designId",
-                "materialId"
-              ]
-            }
-          },
-          "shippingAddress": {
-            "type": "object",
-            "description": "Shipping address details",
-            "properties": {
-              "name": {
-                "type": "string"
-              },
-              "address": {
-                "type": "string"
-              },
-              "city": {
-                "type": "string"
-              },
-              "postalCode": {
-                "type": "string"
-              },
-              "country": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "name",
-              "address",
-              "city",
-              "postalCode",
-              "country"
-            ]
-          },
-          "shippingMethod": {
-            "type": "string",
-            "description": "Shipping method (standard, express)"
-          }
+          "reference": { "type": "string" }
         },
-        "required": [
-          "items",
-          "shippingAddress"
-        ]
+        "required": ["reference"]
       }
     }
   ]

package/src/apps/segpay.json

@@ -0,0 +1,215 @@
+{
+  "slug": "segpay",
+  "name": "Segpay",
+  "description": "Adult-friendly Segpay payment integration for hosted checkout links, SRS reporting/support calls, postback IPs, refunds, cancellations, reactivations, and subsite creation.",
+  "logo": "https://www.google.com/s2/favicons?domain=segpay.com&sz=128",
+  "categories": ["payments", "adult", "high-risk", "subscriptions", "checkout"],
+  "base_url": "https://srs.segpay.com",
+  "auth": {
+    "types": ["api_key", "basic"],
+    "credential_fields": [
+      {
+        "name": "user_id",
+        "label": "SRS User ID",
+        "description": "Segpay Reporting Service User ID.",
+        "required": false,
+        "type": "text"
+      },
+      {
+        "name": "user_access_key",
+        "label": "SRS User Access Key",
+        "description": "Segpay Reporting Service User Access Key.",
+        "required": false
+      },
+      {
+        "name": "basic_auth",
+        "label": "MerchantServices Basic Auth",
+        "description": "Base64-encoded credentials for Segpay MerchantServices APIs. Do not include the 'Basic ' prefix.",
+        "required": false
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "generate_payment_page_url",
+      "description": "Generate a Segpay hosted payment page URL from a package/button-code x-eticketid and optional prefill/tracking parameters.",
+      "method": "GET",
+      "base_url": "https://secure2.segpay.com",
+      "path": "/billing/poset.cgi?x-eticketid={x_eticketid}",
+      "return_request_url": true,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "x_eticketid": { "type": "string", "description": "Segpay package/button-code eticket ID, for example xxxxxx:xxxxx." },
+          "email": { "type": "string" },
+          "username": { "type": "string" },
+          "first_name": { "type": "string" },
+          "last_name": { "type": "string" },
+          "custom1": { "type": "string" },
+          "custom2": { "type": "string" },
+          "custom3": { "type": "string" }
+        },
+        "required": ["x_eticketid"]
+      }
+    },
+    {
+      "name": "validate_user_access",
+      "description": "Validate SRS credentials and return the linked Segpay merchant ID.",
+      "method": "GET",
+      "path": "/adm.asmx/ValidateUserAccess?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": {} }
+    },
+    {
+      "name": "list_transactions",
+      "description": "Run Segpay TransactionsList_V3 for a date range or transaction filters. Dates use mmddyyyy.",
+      "method": "GET",
+      "path": "/MWS.asmx/TransactionsList_V3?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "BegDate": { "type": "string" }, "EndDate": { "type": "string" }, "TransID": { "type": "string" }, "URLID": { "type": "string" } } }
+    },
+    {
+      "name": "get_transaction_by_id",
+      "description": "Get Segpay transaction details by transaction ID.",
+      "method": "GET",
+      "path": "/MWS.asmx/TransactionsByTransID?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "TransID": { "type": "string" } }, "required": ["TransID"] }
+    },
+    {
+      "name": "get_transactions_by_purchase_id",
+      "description": "Get all Segpay transactions associated with a purchase ID, including initial purchases, rebills, refunds, and related events.",
+      "method": "GET",
+      "path": "/MWS.asmx/TransactionByPurchaseID?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "PurchaseID": { "type": "string" } }, "required": ["PurchaseID"] }
+    },
+    {
+      "name": "list_declined_transactions",
+      "description": "Run Segpay TransactionsList_Declined_V2 for declined transactions in a date range. Dates use mmddyyyy.",
+      "method": "GET",
+      "path": "/MWS.asmx/TransactionsList_Declined_V2?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "BegDate": { "type": "string" }, "EndDate": { "type": "string" }, "URLID": { "type": "string" } } }
+    },
+    {
+      "name": "list_purchases_by_url",
+      "description": "Run Segpay TransactionsPurchasesByURL_V5 for purchase and transaction details for a URL.",
+      "method": "GET",
+      "path": "/MWS.asmx/TransactionsPurchasesByURL_V5?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "BegDate": { "type": "string" }, "EndDate": { "type": "string" }, "URLID": { "type": "string" }, "TransID": { "type": "string" } } }
+    },
+    {
+      "name": "revenue_daily_summary",
+      "description": "Get Segpay revenue per transaction over a date range.",
+      "method": "GET",
+      "path": "/MWS.asmx/RevenueDailySummary?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "BegDate": { "type": "string" }, "EndDate": { "type": "string" }, "URLID": { "type": "string" } } }
+    },
+    {
+      "name": "revenue_summary_by_url",
+      "description": "Get Segpay sales, refunds, chargebacks, revokes, declines, and voids by URL for a date range.",
+      "method": "GET",
+      "path": "/MWS.asmx/RevenueSummaryByURL?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "BegDate": { "type": "string" }, "EndDate": { "type": "string" }, "URLID": { "type": "string" } } }
+    },
+    {
+      "name": "list_active_subscriptions",
+      "description": "List active Segpay subscriptions by URL.",
+      "method": "GET",
+      "path": "/MWS.asmx/AssetsActiveSubscriptionsByURL_RebillDate?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "URLID": { "type": "string" } } }
+    },
+    {
+      "name": "list_canceled_subscriptions",
+      "description": "List canceled Segpay subscriptions by URL.",
+      "method": "GET",
+      "path": "/MWS.asmx/CanceledSubscriptionsByURL?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "URLID": { "type": "string" }, "BegDate": { "type": "string" }, "EndDate": { "type": "string" } } }
+    },
+    {
+      "name": "cancel_membership",
+      "description": "Cancel a Segpay consumer subscription while preserving access until the next billing date.",
+      "method": "GET",
+      "path": "/adm.asmx/CancelMembership?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "PurchaseID": { "type": "string" }, "TransID": { "type": "string" }, "Note": { "type": "string" } } }
+    },
+    {
+      "name": "expire_membership",
+      "description": "Expire a Segpay subscription, removing consumer access.",
+      "method": "GET",
+      "path": "/adm.asmx/ExpireMembership?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "PurchaseID": { "type": "string" }, "TransID": { "type": "string" }, "Note": { "type": "string" } } }
+    },
+    {
+      "name": "extend_membership",
+      "description": "Extend a Segpay membership by adding days to the current rebill date.",
+      "method": "GET",
+      "path": "/adm.asmx/ExtendMembership?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "PurchaseID": { "type": "string" }, "TransID": { "type": "string" }, "Days": { "type": "integer" }, "Note": { "type": "string" } } }
+    },
+    {
+      "name": "refund_transaction",
+      "description": "Refund a Segpay transaction.",
+      "method": "GET",
+      "path": "/adm.asmx/RefundTransaction?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "TransID": { "type": "string" }, "Amount": { "type": "number" }, "Note": { "type": "string" } }, "required": ["TransID"] }
+    },
+    {
+      "name": "modify_rebill_amount",
+      "description": "Change the amount a Segpay consumer is charged on the next billing date.",
+      "method": "GET",
+      "path": "/adm.asmx/ModifyRebillAmount?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "PurchaseID": { "type": "string" }, "Amount": { "type": "number" }, "Note": { "type": "string" } } }
+    },
+    {
+      "name": "get_reactivation_link",
+      "description": "Retrieve a reactivation pay page link for a canceled or expired Segpay subscription.",
+      "method": "GET",
+      "path": "/merchantservices/Reactivation?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": { "PurchaseID": { "type": "string" }, "TransID": { "type": "string" } } }
+    },
+    {
+      "name": "get_postback_ip_list",
+      "description": "List Segpay postback IP addresses for firewall allowlisting.",
+      "method": "GET",
+      "path": "/adm.asmx/GetPostbackIPList?UserID={{credential.user_id}}&UserAccessKey={{credential.user_access_key}}",
+      "input_schema": { "type": "object", "properties": {} }
+    },
+    {
+      "name": "create_subsite",
+      "description": "Create a Segpay subsite under an approved parent website using the MerchantServices Subsites API.",
+      "method": "POST",
+      "path": "/MerchantServices/website-sections",
+      "headers": {
+        "Authorization": "Basic {{basic_auth}}",
+        "Content-Type": "application/json",
+        "Accept": "application/json"
+      },
+      "query_params": ["test"],
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "test": { "type": "boolean" },
+          "ParentId": { "type": "integer" },
+          "Type": { "type": "string", "description": "Subdomain or Subdirectory." },
+          "Url": { "type": "string" },
+          "UserName": { "type": "string" },
+          "Password": { "type": "string" },
+          "AccessNotes": { "type": "string" }
+        },
+        "required": ["ParentId", "Type", "Url"]
+      }
+    }
+  ],
+  "webhooks": {
+    "signature_header": "segpay-postback",
+    "events": [
+      { "name": "postback.transaction", "description": "Segpay transaction postback." },
+      { "name": "postback.subscription", "description": "Segpay subscription lifecycle postback." },
+      { "name": "postback.refund", "description": "Segpay refund or reversal postback." }
+    ],
+    "registration": {
+      "method": "POST",
+      "path": "/",
+      "url_field": "url",
+      "manual_setup": "Configure Segpay postbacks on the payment page/package in the Merchant Portal using the Apteva callback URL. Segpay postbacks are not auto-registered by this integration."
+    }
+  },
+  "health_check": { "tool": "validate_user_access" }
+}