GoCanvas MCP by usefulapi

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.

Takes no parameters.

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).

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 report (PDF) definitions attached to a form: id, name, format, whether emailed by default. 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.

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

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

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

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

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

Takes no parameters.

The users in one department with their department role.

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.

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

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

Projects of the Project Management view. Paged.

Sites (job locations) 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.

One reference data set with its rows.

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

Workflows (handoff chains between users) the connected user takes part in, with their handoff states and the count of tasks available to claim. 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.

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.

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.