Synchroteam MCP by usefulapi

WRITE: mark a job as completed, optionally with the real start and end times (give actual_start and actual_end together: Synchroteam may refuse the call with only one of them). Completing may trigger the account's 'job completed' notifications (email/SMS/webhook to managers, technicians or the customer), as configured in Synchroteam. Identify the job by exactly one of id, my_id or num. POST /job/complete.

WRITE: create a new customer (name and an address are required). If you pass myId and a customer with that myId already exists, nothing is created and an error is returned (use synchroteam_update_customer). POST /customer/send.

WRITE: create a new piece of equipment under a site or a customer (give exactly one of site or customer; both is refused). If myId already exists nothing is created and an error is returned. POST /equipment/send.

WRITE: create a new job for a customer (status created, not yet scheduled; use synchroteam_schedule_job to assign a technician and time). The customer is required (id, myId or exact name); site, equipment and job type are optional. If myId already exists nothing is created and an error is returned. Synchroteam may send the account's 'job created' notifications (email/SMS/webhook, possibly to the customer), as configured. POST /job/send.

WRITE: create a new site (a location of a customer). Needs a name, an address and the customer (id or myId). If myId already exists nothing is created and an error is returned. POST /site/send.

One customer by id, myId, exact name or e-mail, with address, contact, custom fields and tags. GET /customer/details.

One stock depot by id, with the quantity of each part it holds. GET /depot/details.

One piece of equipment by id, myId or exact name, with its customer and site. GET /equipment/details.

One invoice by id, reference or number, with its lines. GET /invoice/details.

One job by num (the job number shown in the app), id or myId: status, customer/site/equipment, technician(s), schedule, actual times, time entries, parts used, report and custom fields. GET /job/details.

Photo links of a job (url, file name, comment, report iteration). Image bytes are never returned. GET /job/photos.

One part or service by id or reference. GET /part/details.

One quotation by id, reference or number, with its lines. GET /quotation/details.

One site by id, myId or exact name: address, contact, customer, custom fields, tags. GET /site/details.

One user by login or id. GET /user/details.

List time entries and unavailabilities (travel, at work, clock, unavailable) of technicians. start_date and end_date go together and return anything overlapping that range. GET /activity/list.

List service contracts by name, customer, site, period or active flag. GET /contract/list.

List or search customers (name wildcard, e-mail, active flag, change time). Returns name, address, contact, custom fields, tags. GET /customer/list.

List stock depots (warehouses and technician vans). The part quantities of one depot come from synchroteam_get_depot. GET /depot/list.

List or search pieces of equipment (assets) by name, customer, site, active flag, change time. GET /equipment/list.

List invoices (read only): number, status, customer, job, lines, totals. Filter by status, customer, site, job or time. GET /invoice/list.

List jobs (simplified: no report, parts or time entries) filtered by status, schedule window, technician, team, customer, site, equipment, job type or project. Use synchroteam_get_job for the full record. GET /job/list.

List job types (name, default duration, priority, skills, default report). Use their id or name when creating a job. GET /jobtype/list.

List technicians' part requests (urgent, sent, completed, deleted flags). GET /partrequest/list.

List the parts and services catalog (reference, name, price, category, tax, tracked/serialized flags, type). GET /part/list.

List projects (groups of jobs) by customer, site, equipment or project type. GET /project/list.

List quotations (read only): number, status, customer, job, lines, totals. GET /quotation/list.

List or search sites (a customer's locations): by name, customer, active flag, change time. GET /site/list.

List teams with member counts and tags. GET /team/list.

List users: login, name, profile (technician, manager, administrator), teams, skills, last known location. Passwords are never returned. GET /user/list.

WRITE: schedule a job for a technician between two times (also re-schedules a scheduled or paused job). Synchroteam may notify technicians and/or customers (email/SMS/webhook) as configured in the account's notification settings (SMS uses the account's paid credits). Identify the job by exactly one of id, my_id or num. POST /job/schedule.

WRITE: mark a job as started (status started, actual start now). If the job's technician already has another started job, Synchroteam pauses that one. Starting may trigger the account's 'job started' notifications (email/SMS/webhook to managers, technicians or the customer). Identify the job by exactly one of id, my_id or num. POST /job/start.

WRITE: change fields of an existing customer by its numeric id. Only the fields you pass are changed; nothing is cleared. The customer id must exist (an unknown id fails). POST /customer/send.