@apteva/integrations 0.3.61 → 0.15.3

package/src/apps/bamboohr.json

@@ -0,0 +1,303 @@
+{
+  "slug": "bamboohr",
+  "name": "BambooHR",
+  "description": "BambooHR HRIS platform. Manage employee records, the company directory, time-off requests, and reports via the BambooHR REST API.",
+  "logo": "https://www.google.com/s2/favicons?domain=bamboohr.com&sz=128",
+  "categories": [
+    "hr",
+    "hris",
+    "employees",
+    "payroll",
+    "time-off",
+    "people"
+  ],
+  "base_url": "https://api.bamboohr.com/api/gateway.php/{{subdomain}}/v1",
+  "auth": {
+    "types": [
+      "basic"
+    ],
+    "headers": {
+      "Authorization": "Basic {{basic}}",
+      "Accept": "application/json"
+    },
+    "credential_fields": [
+      {
+        "name": "apiKey",
+        "label": "API Key",
+        "description": "BambooHR API key (generate from your profile menu > API Keys in BambooHR)."
+      },
+      {
+        "name": "password",
+        "label": "Password",
+        "description": "BambooHR ignores the basic-auth password — enter the literal value 'x'."
+      },
+      {
+        "name": "subdomain",
+        "label": "Subdomain",
+        "description": "Your BambooHR subdomain (e.g. 'mycompany' from mycompany.bamboohr.com)."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "get_employee_directory",
+      "description": "Retrieve the company employee directory: every active employee's display name, job title, department, work email, and contact info. Note: the directory must be enabled for your account.",
+      "method": "GET",
+      "path": "/employees/directory",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "get_employee",
+      "description": "Retrieve a single employee record by ID. Specify which fields to return via the 'fields' query parameter (comma-separated).",
+      "method": "GET",
+      "path": "/employees/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Employee ID, or 'me' for the authenticated user."
+          },
+          "fields": {
+            "type": "string",
+            "description": "Comma-separated field aliases to return (e.g. 'firstName,lastName,workEmail,department,hireDate'). Required by BambooHR."
+          }
+        },
+        "required": [
+          "id",
+          "fields"
+        ]
+      }
+    },
+    {
+      "name": "create_employee",
+      "description": "Create a new employee. Returns 201 Created with the new employee's ID in the Location header. firstName and lastName are required.",
+      "method": "POST",
+      "path": "/employees",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "firstName": {
+            "type": "string"
+          },
+          "lastName": {
+            "type": "string"
+          },
+          "workEmail": {
+            "type": "string"
+          },
+          "jobTitle": {
+            "type": "string"
+          },
+          "department": {
+            "type": "string"
+          },
+          "hireDate": {
+            "type": "string",
+            "description": "Hire date in YYYY-MM-DD format."
+          },
+          "employmentHistoryStatus": {
+            "type": "string",
+            "description": "e.g. 'Full-Time', 'Part-Time', 'Contractor'."
+          },
+          "location": {
+            "type": "string"
+          },
+          "supervisorEmail": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "firstName",
+          "lastName"
+        ]
+      }
+    },
+    {
+      "name": "update_employee",
+      "description": "Update an existing employee record. Only the fields supplied in the body are changed.",
+      "method": "POST",
+      "path": "/employees/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Employee ID."
+          },
+          "firstName": {
+            "type": "string"
+          },
+          "lastName": {
+            "type": "string"
+          },
+          "workEmail": {
+            "type": "string"
+          },
+          "jobTitle": {
+            "type": "string"
+          },
+          "department": {
+            "type": "string"
+          },
+          "supervisorEmail": {
+            "type": "string"
+          },
+          "employmentHistoryStatus": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id"
+        ]
+      }
+    },
+    {
+      "name": "list_time_off_requests",
+      "description": "List time-off requests, optionally filtered by date range, employee, type, status, or action.",
+      "method": "GET",
+      "path": "/time_off/requests",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "start": {
+            "type": "string",
+            "description": "Start date filter (YYYY-MM-DD)."
+          },
+          "end": {
+            "type": "string",
+            "description": "End date filter (YYYY-MM-DD)."
+          },
+          "employeeId": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "description": "Time-off type ID."
+          },
+          "status": {
+            "type": "string",
+            "description": "Filter by status: 'approved', 'denied', 'superceded', 'requested', 'canceled'."
+          },
+          "action": {
+            "type": "string",
+            "description": "Filter by pending action: 'view', 'approve'."
+          }
+        }
+      }
+    },
+    {
+      "name": "create_time_off_request",
+      "description": "Create a new time-off request on behalf of an employee.",
+      "method": "PUT",
+      "path": "/employees/{employeeId}/time_off/request",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "employeeId": {
+            "type": "string",
+            "description": "Employee ID making the request."
+          },
+          "status": {
+            "type": "string",
+            "description": "Initial status: typically 'requested' or 'approved'."
+          },
+          "start": {
+            "type": "string",
+            "description": "Start date (YYYY-MM-DD)."
+          },
+          "end": {
+            "type": "string",
+            "description": "End date (YYYY-MM-DD)."
+          },
+          "timeOffTypeId": {
+            "type": "integer",
+            "description": "Time-off type ID (look up with list_time_off_types)."
+          },
+          "amount": {
+            "type": "number",
+            "description": "Amount of time off (in the type's units, e.g. days or hours)."
+          },
+          "notes": {
+            "type": "object",
+            "description": "Free-form notes (e.g. { employee: 'Vacation', manager: 'Approved' })."
+          }
+        },
+        "required": [
+          "employeeId",
+          "start",
+          "end",
+          "timeOffTypeId"
+        ]
+      }
+    },
+    {
+      "name": "list_time_off_types",
+      "description": "List the time-off types configured for the company (e.g. Vacation, Sick, Personal) including their IDs needed to create requests.",
+      "method": "GET",
+      "path": "/meta/time_off/types",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "list_who_is_out",
+      "description": "Return the list of employees scheduled to be out (time off or holidays) within a given date range. Defaults to today through 14 days out if no range is given.",
+      "method": "GET",
+      "path": "/time_off/whos_out",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "start": {
+            "type": "string",
+            "description": "Start date (YYYY-MM-DD)."
+          },
+          "end": {
+            "type": "string",
+            "description": "End date (YYYY-MM-DD)."
+          }
+        }
+      }
+    },
+    {
+      "name": "list_fields",
+      "description": "List every field defined on the employee record, including standard and custom fields, with their aliases needed for get_employee/update_employee.",
+      "method": "GET",
+      "path": "/meta/fields",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "get_company_report",
+      "description": "Run a saved company report by ID and return the result. Set format to 'JSON' for structured output.",
+      "method": "GET",
+      "path": "/reports/{reportId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "reportId": {
+            "type": "integer",
+            "description": "ID of the saved report."
+          },
+          "format": {
+            "type": "string",
+            "description": "Output format: 'JSON', 'CSV', 'XLS', 'PDF'. Defaults to 'JSON' for API access."
+          },
+          "fd": {
+            "type": "string",
+            "description": "Set to 'no' to suppress field-display headers in tabular output."
+          }
+        },
+        "required": [
+          "reportId"
+        ]
+      }
+    }
+  ]
+}

package/src/apps/basiq.json

@@ -0,0 +1,308 @@
+{
+  "slug": "basiq",
+  "name": "Basiq",
+  "description": "MCP server for Basiq open banking - connect Australian bank accounts, fetch accounts, balances, transactions, and account-holder identity. Self-serve dashboard signup with a free tier.",
+  "logo": "https://www.google.com/s2/favicons?domain=basiq.io&sz=128",
+  "categories": [
+    "banking",
+    "open-banking",
+    "cdr",
+    "transactions",
+    "accounts",
+    "australia",
+    "basiq"
+  ],
+  "base_url": "https://au-api.basiq.io",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}",
+      "Accept": "application/json",
+      "basiq-version": "3.0"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "Access Token",
+        "description": "Basiq server access_token obtained from the get_access_token tool. Tokens expire after 60 minutes; re-run get_access_token to renew.",
+        "required": true,
+        "type": "password"
+      },
+      {
+        "name": "api_key",
+        "label": "API Key",
+        "description": "Base64-encoded Basiq API key from the dashboard (dashboard.basiq.io). Used by get_access_token to mint short-lived access tokens.",
+        "required": false,
+        "type": "password"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "get_access_token",
+      "description": "Mint a short-lived (60 min) server access_token from your Basiq API key. NOTE: this endpoint authenticates with 'Authorization: Basic <api_key>', not the bearer header used by every other tool — pass the api_key explicitly and treat the returned access_token as the 'token' credential for subsequent calls.",
+      "method": "POST",
+      "path": "/token",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "scope": {
+            "type": "string",
+            "description": "Token scope: SERVER_ACCESS (full server-side access) or CLIENT_ACCESS (browser-scoped)",
+            "default": "SERVER_ACCESS"
+          }
+        }
+      }
+    },
+    {
+      "name": "create_user",
+      "description": "Create a Basiq user record. A user represents one end customer whose bank accounts you will connect. Returns a userId.",
+      "method": "POST",
+      "path": "/users",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "email": {
+            "type": "string",
+            "description": "End user's email address"
+          },
+          "mobile": {
+            "type": "string",
+            "description": "End user's mobile number in E.164 format (e.g. +61410888666)"
+          },
+          "firstName": {
+            "type": "string",
+            "description": "End user's first name"
+          },
+          "lastName": {
+            "type": "string",
+            "description": "End user's last name"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_user",
+      "description": "Get a Basiq user record by userId, including linked connections.",
+      "method": "GET",
+      "path": "/users/{userId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "The Basiq user ID"
+          }
+        },
+        "required": [
+          "userId"
+        ]
+      }
+    },
+    {
+      "name": "delete_user",
+      "description": "Delete a Basiq user and all of their connections and data.",
+      "method": "DELETE",
+      "path": "/users/{userId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "The Basiq user ID"
+          }
+        },
+        "required": [
+          "userId"
+        ]
+      }
+    },
+    {
+      "name": "create_auth_link",
+      "description": "Create an auth_link (hosted consent UI URL) for a user to securely connect their bank. Returns a URL to redirect the user to.",
+      "method": "POST",
+      "path": "/users/{userId}/auth_link",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "The Basiq user ID"
+          },
+          "mobile": {
+            "type": "string",
+            "description": "Optional mobile number to pre-fill the consent flow"
+          }
+        },
+        "required": [
+          "userId"
+        ]
+      }
+    },
+    {
+      "name": "list_institutions",
+      "description": "List all supported financial institutions (banks) with IDs, names, logos, and supported features.",
+      "method": "GET",
+      "path": "/institutions",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "get_institution",
+      "description": "Get details about a specific financial institution by ID.",
+      "method": "GET",
+      "path": "/institutions/{institutionId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "institutionId": {
+            "type": "string",
+            "description": "The Basiq institution ID"
+          }
+        },
+        "required": [
+          "institutionId"
+        ]
+      }
+    },
+    {
+      "name": "list_connections",
+      "description": "List a user's bank connections with their status and last-refresh time.",
+      "method": "GET",
+      "path": "/users/{userId}/connections",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "The Basiq user ID"
+          }
+        },
+        "required": [
+          "userId"
+        ]
+      }
+    },
+    {
+      "name": "refresh_connection",
+      "description": "Trigger a refresh of a bank connection to pull the latest accounts and transactions.",
+      "method": "POST",
+      "path": "/users/{userId}/connections/{connectionId}/refresh",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "The Basiq user ID"
+          },
+          "connectionId": {
+            "type": "string",
+            "description": "The connection ID from list_connections"
+          }
+        },
+        "required": [
+          "userId",
+          "connectionId"
+        ]
+      }
+    },
+    {
+      "name": "list_accounts",
+      "description": "List all bank accounts for a user across all connections. Returns accountId, name, type, balance, available funds, and account number.",
+      "method": "GET",
+      "path": "/users/{userId}/accounts",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "The Basiq user ID"
+          }
+        },
+        "required": [
+          "userId"
+        ]
+      }
+    },
+    {
+      "name": "get_account",
+      "description": "Get a single bank account for a user by accountId, including current balance and available funds.",
+      "method": "GET",
+      "path": "/users/{userId}/accounts/{accountId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "The Basiq user ID"
+          },
+          "accountId": {
+            "type": "string",
+            "description": "The account ID from list_accounts"
+          }
+        },
+        "required": [
+          "userId",
+          "accountId"
+        ]
+      }
+    },
+    {
+      "name": "list_transactions",
+      "description": "List a user's transactions across all accounts. Use the filter param to scope by account, date, or status. Returns amount, description, postDate, direction, and enriched merchant/category data.",
+      "method": "GET",
+      "path": "/users/{userId}/transactions",
+      "query_params": [
+        "filter",
+        "limit"
+      ],
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "The Basiq user ID"
+          },
+          "filter": {
+            "type": "string",
+            "description": "Basiq filter expression, e.g. account.id.eq('<accountId>'),transaction.postDate.gt('2026-01-01')"
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Number of transactions per page (max 500)"
+          }
+        },
+        "required": [
+          "userId"
+        ]
+      }
+    },
+    {
+      "name": "get_transaction",
+      "description": "Get a single transaction for a user by transactionId.",
+      "method": "GET",
+      "path": "/users/{userId}/transactions/{transactionId}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "string",
+            "description": "The Basiq user ID"
+          },
+          "transactionId": {
+            "type": "string",
+            "description": "The transaction ID"
+          }
+        },
+        "required": [
+          "userId",
+          "transactionId"
+        ]
+      }
+    }
+  ]
+}