GoCanvas MCP by usefulapi

WRITE: creates a dispatch, a job that appears on the assignee's mobile device (immediate_dispatch is sent at once, with a push notification when send_notification is true; scheduled_dispatch needs scheduled_at and scheduled_end). Responses pre-fill the assignee's form (entry ids from gocanvas_get_form). Without assignee_id the dispatch stays unassigned. Not idempotent: calling twice creates two dispatches. Media fields cannot be pre-filled.

One dispatch by id with its pre-filled responses, schedule and status.

One form definition, including its screens and entries (field ids and labels). Use format 'flat' for the simplest list of fields (what you need to read submissions or create a dispatch), 'nested' (default) for the full structure, 'metadata' or 'minimal' for less.

The user who owns the connected OAuth application: id, login, company id and name, default department and role. Use it to learn the default department id.

One reference data set with its rows.

One submission with all its responses (entry id, label, type, value). Accepts the numeric submission id or the client GUID.

One user by id: name, login, contact data, default department and role.

Customers (contacts of the Project Management view): individuals or businesses, optionally tied to a site. Paged.

The users in one department with their department role.

Departments of the company: id, name, description. The pseudo department -1 'All' is included.

Dispatches (jobs sent to field workers): id, form, assignee, status, schedule. At least one of user_id, department_id or form_id is required. Dates are ISO-8601. Paged.

The report (PDF) definitions attached to a form: id, name, format, whether emailed by default. Paged.

Forms (mobile form definitions) the connected user can see: id, name, status, version, department. Paged, 100 per page. Use gocanvas_get_form for a form's fields (entries).

User groups: id, name, and the forms and users assigned. Paged.

GPS location events of field users (needs the tracker feature). start_date and end_date are required and may span at most 7 days. Omit user_id for all users of the company. Paged.

Projects of the Project Management view. Paged.

Reference data (lookup tables used by forms): id, name, columns, version. Without department_id the user's default department is used.

Sites (job locations) of the Project Management view. Paged.

The revision history of a submission (who changed it and when). Paged.

Completed forms (submissions): id, form, number, created time, department, user, status. At least one of form_id, user_id or user_email is required (user_id and user_email cannot be combined). Default status is completed. Dates filter created_at. Paged, 100 per page. Use gocanvas_get_submission for the answers.

Users of the company: id, name, email, enabled. Paged, 100 per page.

Workflows (handoff chains between users) the connected user takes part in, with their handoff states and the count of tasks available to claim. Paged.

WRITE: acknowledges a dispatch (status becomes received). Only works for a dispatch in the assigned state that is assigned to the connected user; repeating it is refused by GoCanvas.