@apteva/integrations 0.2.3 → 0.3.1

package/src/apps/chargebee.json

@@ -0,0 +1,226 @@
+{
+  "slug": "chargebee",
+  "name": "Chargebee",
+  "description": "Subscription billing and revenue management platform. Manage subscriptions, customers, invoices, and billing operations via the Chargebee API.",
+  "logo": "https://www.google.com/s2/favicons?domain=chargebee.com&sz=128",
+  "categories": [
+    "billing",
+    "subscriptions",
+    "payments",
+    "invoices",
+    "customers",
+    "saas",
+    "revenue"
+  ],
+  "base_url": "",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "Api Key",
+        "description": "Chargebee API key (find at Settings > Configure Chargebee > API Keys)"
+      },
+      {
+        "name": "site",
+        "label": "Site",
+        "description": "Chargebee site name (the subdomain, e.g. 'mycompany' from mycompany.chargebee.com)"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_subscriptions",
+      "description": "List all subscriptions with optional filtering by status, customer, plan, and date ranges. Supports pagination via offset parameter. Returns subscription details including plan, billing info, and current status.",
+      "method": "GET",
+      "path": "/list-subscriptions",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "description": "Number of subscriptions to return per page (max 100, default 10).",
+            "default": 10
+          },
+          "offset": {
+            "type": "string",
+            "description": "Pagination offset from previous response's next_offset value."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "active",
+              "cancelled",
+              "non_renewing",
+              "future",
+              "in_trial",
+              "paused"
+            ],
+            "description": "Filter by subscription status."
+          }
+        }
+      }
+    },
+    {
+      "name": "get_subscription",
+      "description": "Retrieve details of a specific subscription by its ID. Returns the full subscription object including plan, addons, billing cycles, and current status.",
+      "method": "GET",
+      "path": "/get-subscription",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "subscription_id": {
+            "type": "string",
+            "description": "The unique identifier of the subscription to retrieve."
+          }
+        },
+        "required": [
+          "subscription_id"
+        ]
+      }
+    },
+    {
+      "name": "list_customers",
+      "description": "List all customers with optional filtering by email, name, and date ranges. Supports pagination via offset parameter. Returns customer details including billing address and payment info.",
+      "method": "GET",
+      "path": "/list-customers",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "description": "Number of customers to return per page (max 100, default 10).",
+            "default": 10
+          },
+          "offset": {
+            "type": "string",
+            "description": "Pagination offset from previous response's next_offset value."
+          },
+          "email": {
+            "type": "string",
+            "description": "Filter customers by exact email address."
+          }
+        }
+      }
+    },
+    {
+      "name": "get_customer",
+      "description": "Retrieve details of a specific customer by their ID. Returns the full customer object including contact info, billing address, payment methods, and associated subscriptions.",
+      "method": "GET",
+      "path": "/get-customer",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "customer_id": {
+            "type": "string",
+            "description": "The unique identifier of the customer to retrieve."
+          }
+        },
+        "required": [
+          "customer_id"
+        ]
+      }
+    },
+    {
+      "name": "list_invoices",
+      "description": "List all invoices with optional filtering by status, customer, subscription, and date ranges. Supports pagination via offset parameter. Returns invoice details including line items, amounts, and payment status.",
+      "method": "GET",
+      "path": "/list-invoices",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "description": "Number of invoices to return per page (max 100, default 10).",
+            "default": 10
+          },
+          "offset": {
+            "type": "string",
+            "description": "Pagination offset from previous response's next_offset value."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "paid",
+              "posted",
+              "payment_due",
+              "not_paid",
+              "voided",
+              "pending"
+            ],
+            "description": "Filter by invoice status."
+          },
+          "customer_id": {
+            "type": "string",
+            "description": "Filter invoices by customer ID."
+          }
+        }
+      }
+    },
+    {
+      "name": "create_subscription",
+      "description": "Create a new subscription for a customer. Specify the plan, customer details, and billing configuration. Chargebee uses POST for all write operations with form-encoded parameters.",
+      "method": "POST",
+      "path": "/create-subscription",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "plan_id": {
+            "type": "string",
+            "description": "The ID of the plan to subscribe to (required)."
+          },
+          "customer[id]": {
+            "type": "string",
+            "description": "Existing customer ID to create the subscription for."
+          },
+          "customer[email]": {
+            "type": "string",
+            "description": "Email of a new customer to create along with the subscription."
+          },
+          "customer[first_name]": {
+            "type": "string",
+            "description": "First name of the new customer."
+          },
+          "customer[last_name]": {
+            "type": "string",
+            "description": "Last name of the new customer."
+          },
+          "plan_quantity": {
+            "type": "integer",
+            "description": "Quantity of the plan (default 1).",
+            "default": 1
+          },
+          "trial_end": {
+            "type": "integer",
+            "description": "Unix timestamp for when the trial should end. Set to 0 for no trial."
+          },
+          "billing_cycles": {
+            "type": "integer",
+            "description": "Number of billing cycles for the subscription. Leave empty for infinite."
+          },
+          "auto_collection": {
+            "type": "string",
+            "enum": [
+              "on",
+              "off"
+            ],
+            "description": "Whether to automatically collect charges. Defaults to the site setting.",
+            "default": "on"
+          },
+          "coupon_ids[]": {
+            "type": "string",
+            "description": "Coupon ID to apply to the subscription."
+          }
+        },
+        "required": [
+          "plan_id"
+        ]
+      }
+    }
+  ]
+}

package/src/apps/cleanster.json

@@ -0,0 +1,359 @@
+{
+  "slug": "cleanster",
+  "name": "Cleanster",
+  "description": "MCP server for Cleanster - vacation rental cleaning management, task scheduling, and cleaner coordination",
+  "logo": "https://www.google.com/s2/favicons?domain=cleanster.com&sz=128",
+  "categories": [
+    "vacation-rental",
+    "cleaning",
+    "property-management",
+    "airbnb",
+    "scheduling",
+    "housekeeping"
+  ],
+  "base_url": "https://api.cleanster.com/v1",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "Api_key",
+        "description": "Your Cleanster API Key (get from Cleanster dashboard > Integrations)"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "properties_list",
+      "description": "List all properties in your account",
+      "method": "GET",
+      "path": "/properties-list",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "page": {
+            "type": "number",
+            "description": "Page number for pagination"
+          },
+          "per_page": {
+            "type": "number",
+            "description": "Number of results per page"
+          }
+        }
+      }
+    },
+    {
+      "name": "property_get",
+      "description": "Get details for a specific property",
+      "method": "GET",
+      "path": "/property-get",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "property_id": {
+            "type": "string",
+            "description": "The property ID"
+          }
+        },
+        "required": [
+          "property_id"
+        ]
+      }
+    },
+    {
+      "name": "property_create",
+      "description": "Create a new property",
+      "method": "GET",
+      "path": "/property-create",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Property name"
+          },
+          "address": {
+            "type": "string",
+            "description": "Street address"
+          },
+          "city": {
+            "type": "string",
+            "description": "City"
+          },
+          "state": {
+            "type": "string",
+            "description": "State/Province"
+          },
+          "zip_code": {
+            "type": "string",
+            "description": "ZIP/Postal code"
+          },
+          "country": {
+            "type": "string",
+            "description": "Country"
+          },
+          "bedrooms": {
+            "type": "number",
+            "description": "Number of bedrooms"
+          },
+          "bathrooms": {
+            "type": "number",
+            "description": "Number of bathrooms"
+          },
+          "square_feet": {
+            "type": "number",
+            "description": "Property size in square feet"
+          },
+          "property_type": {
+            "type": "string",
+            "description": "Type of property (house, apartment, condo, etc.)"
+          },
+          "notes": {
+            "type": "string",
+            "description": "Additional notes for cleaners"
+          }
+        },
+        "required": [
+          "name",
+          "address"
+        ]
+      }
+    },
+    {
+      "name": "cleaners_nearby",
+      "description": "Find available cleaners near a property (within 50km)",
+      "method": "GET",
+      "path": "/cleaners-nearby",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "property_id": {
+            "type": "string",
+            "description": "Property ID to find cleaners near"
+          },
+          "latitude": {
+            "type": "number",
+            "description": "Latitude coordinate"
+          },
+          "longitude": {
+            "type": "number",
+            "description": "Longitude coordinate"
+          },
+          "radius_km": {
+            "type": "number",
+            "description": "Search radius in kilometers (default 50)"
+          }
+        }
+      }
+    },
+    {
+      "name": "cleaner_assign",
+      "description": "Assign a cleaner to a property as primary or backup",
+      "method": "GET",
+      "path": "/cleaner-assign",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "property_id": {
+            "type": "string",
+            "description": "The property ID"
+          },
+          "cleaner_id": {
+            "type": "string",
+            "description": "The cleaner ID"
+          },
+          "role": {
+            "type": "string",
+            "description": "Role: 'primary' or 'backup'",
+            "enum": [
+              "primary",
+              "backup"
+            ]
+          }
+        },
+        "required": [
+          "property_id",
+          "cleaner_id"
+        ]
+      }
+    },
+    {
+      "name": "tasks_list",
+      "description": "List cleaning tasks/jobs",
+      "method": "GET",
+      "path": "/tasks-list",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "property_id": {
+            "type": "string",
+            "description": "Filter by property ID"
+          },
+          "status": {
+            "type": "string",
+            "description": "Filter by status (scheduled, in_progress, completed, cancelled)"
+          },
+          "date_from": {
+            "type": "string",
+            "description": "Filter from date (YYYY-MM-DD)"
+          },
+          "date_to": {
+            "type": "string",
+            "description": "Filter to date (YYYY-MM-DD)"
+          },
+          "page": {
+            "type": "number",
+            "description": "Page number"
+          },
+          "per_page": {
+            "type": "number",
+            "description": "Results per page"
+          }
+        }
+      }
+    },
+    {
+      "name": "task_get",
+      "description": "Get details for a specific cleaning task",
+      "method": "GET",
+      "path": "/task-get",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "task_id": {
+            "type": "string",
+            "description": "The task ID"
+          }
+        },
+        "required": [
+          "task_id"
+        ]
+      }
+    },
+    {
+      "name": "task_create",
+      "description": "Create a new cleaning task/job",
+      "method": "GET",
+      "path": "/task-create",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "property_id": {
+            "type": "string",
+            "description": "The property ID"
+          },
+          "cleaner_id": {
+            "type": "string",
+            "description": "Assigned cleaner ID (optional)"
+          },
+          "scheduled_date": {
+            "type": "string",
+            "description": "Scheduled date (YYYY-MM-DD)"
+          },
+          "scheduled_time": {
+            "type": "string",
+            "description": "Scheduled time (HH:MM)"
+          },
+          "task_type": {
+            "type": "string",
+            "description": "Type of cleaning (checkout_cleaning, checkin_prep, deep_clean, etc.)"
+          },
+          "duration_hours": {
+            "type": "number",
+            "description": "Estimated duration in hours"
+          },
+          "notes": {
+            "type": "string",
+            "description": "Special instructions"
+          },
+          "checklist_id": {
+            "type": "string",
+            "description": "Cleaning checklist ID"
+          },
+          "reservation_id": {
+            "type": "string",
+            "description": "Associated reservation ID"
+          }
+        },
+        "required": [
+          "property_id",
+          "scheduled_date"
+        ]
+      }
+    },
+    {
+      "name": "task_update",
+      "description": "Update a cleaning task status or details",
+      "method": "GET",
+      "path": "/task-update",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "task_id": {
+            "type": "string",
+            "description": "The task ID"
+          },
+          "status": {
+            "type": "string",
+            "description": "New status (scheduled, in_progress, completed, cancelled)"
+          },
+          "cleaner_id": {
+            "type": "string",
+            "description": "Reassign to different cleaner"
+          },
+          "scheduled_date": {
+            "type": "string",
+            "description": "New scheduled date (YYYY-MM-DD)"
+          },
+          "scheduled_time": {
+            "type": "string",
+            "description": "New scheduled time (HH:MM)"
+          },
+          "notes": {
+            "type": "string",
+            "description": "Updated notes"
+          }
+        },
+        "required": [
+          "task_id"
+        ]
+      }
+    },
+    {
+      "name": "hours_calculate",
+      "description": "Calculate required cleaning hours by project cost for auto-booking",
+      "method": "GET",
+      "path": "/hours-calculate",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "project_cost": {
+            "type": "number",
+            "description": "Project cost to calculate hours for"
+          },
+          "property_id": {
+            "type": "string",
+            "description": "Property ID for size-based calculation"
+          },
+          "bedrooms": {
+            "type": "number",
+            "description": "Number of bedrooms"
+          },
+          "bathrooms": {
+            "type": "number",
+            "description": "Number of bathrooms"
+          },
+          "square_feet": {
+            "type": "number",
+            "description": "Property size in square feet"
+          }
+        }
+      }
+    }
+  ]
+}