activate_asset
ChatGPTActivate a GoCodes asset tag in the authenticated user's own account: claim an existing, unclaimed printed code (the ID on the QR/barcode label, e.g. 'ABCD-1234') and create a new company-owned asset for it, optionally with an initial type, serial number, model, reward and description. Fails with a clear message if the code doesn't exist, is already activated in this account, or is activated by another account (which must delete it first to release the code). Other fields can be set afterwards with update_asset. Requires the Administrator, GroupAdministrator, or AssetManager role. The caller's own authorized account data.
assign_task
ChatGPTAssign a task in the authenticated user's own GoCodes account to a user, by the task's numeric ID and the assignee's email. IMPORTANT: omitting 'customerEmail' (or passing an empty string) UNASSIGNS the task — pass an email to assign it. This changes only the assignee; no other task field is touched. Requires the Tasks feature and a role that permits assigning (Administrator, GroupAdministrator, AssetManager, or AssetAssigner). The caller's own authorized account data.
create_task
ChatGPTCreate a new task on a company-owned asset in the authenticated user's own GoCodes account. Only 'assetId' and 'name' are required; every other field is optional and is left unset when omitted. If 'taskStatusId' is omitted the task starts in the account's initial status (see list_task_statuses). Set 'customerEmail' to assign the task to a user at creation time. Requires the Tasks feature and a role that permits creating tasks (Administrator, GroupAdministrator, or AssetManager). Returns the new task's numeric ID. The caller's own authorized account data.
delete_asset
ChatGPTPermanently delete a company-owned asset from the authenticated user's own GoCodes account and release its tag code so it can be activated again (the GoCodes app labels this action 'Deactivate'). It is not a reversible disable. Re-activating the same code with activate_asset creates a NEW, blank asset — the deleted asset's fields are not restored, and undo_asset_changes cannot bring it back. The audit history keyed by the code survives. To take an asset out of service while keeping its data, set its status with update_asset instead. As a safeguard, confirmAssetId must repeat assetId exactly; confirm with the user before calling. On success the result includes a snapshot of the asset's details, read immediately before the delete request. Requires the Administrator, GroupAdministrator, or AssetManager role, and only works on the caller's own company's assets — including for Administrators, who can view other companies' assets but cannot delete them. The caller's own authorized account data.
get_asset_assignment_history
ChatGPTGet the check-out / assignment history for a company-owned asset in the authenticated user's own GoCodes account: who had it, when, the return date, and how long it was checked out. Authorized account data.
get_asset_change_history
ChatGPTGet the full audit/change log for a company-owned asset in the authenticated user's own GoCodes account: every recorded change with the date, the user who made it, and a description of what changed. Authorized account data.
get_asset_details
ChatGPTGet the full detail record for a single company-owned asset in the authenticated user's own GoCodes account, by its GoCodes asset ID (the code on the QR/barcode label, e.g. 'ABCD-1234'). Authorized account data.
get_asset_location
ChatGPTGet the last recorded location of a company-owned asset (equipment) in the authenticated user's own GoCodes account, by its GoCodes asset ID. Returns the asset's last known GPS coordinates and the date recorded. This is equipment-location data the caller is authorized to access; it does not track people.
get_asset_picture
ChatGPTFetch the photo for a company-owned asset in the authenticated user's own GoCodes account, by its GoCodes asset ID. Returns the image so it can be displayed inline. Returns a text message if the asset has no picture on file. Authorized account data.
get_assets_batch
ChatGPTGet full detail records for multiple company-owned assets in the authenticated user's own GoCodes account, by their GoCodes asset IDs. More efficient than calling get_asset_details repeatedly. Authorized account data.
get_company_settings
ChatGPTGet a GoCodes company account's name and feature toggles (inventory, inventory alerts, assignment reminders, service notifications, public documentation URL, offline mode, advanced permissions, Tasks, Kits, Attachments, Teletrac GPS), plus checkOutVisibility: which of the company's custom fields are shown on the check-out form, keyed customField1..10 (the same shape get_custom_field_schema returns for the caller's own account). Whether the account itself is enabled is a separate tool, get_company_status. Requires targetCustomerGroupId — use list_company_accounts to discover a company's id. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.
get_company_status
ChatGPTCheck whether a GoCodes company account itself is enabled (a disabled account locks out every user in it). Requires targetCustomerGroupId — use list_company_accounts to discover a company's id. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.
get_custom_field_schema
ChatGPTGet the authenticated user's own GoCodes account custom-field configuration: the display names assigned to each field (including the custom1–custom10 slots), the allowed/picklist values configured for them, and which custom fields are shown on the check-out form. Use this to interpret the customValue1..10 and renamed fields on assets. Authorized account data.
get_kit_contents
ChatGPTList the company-owned assets contained inside a kit in the authenticated user's own GoCodes account, identified by the kit-parent asset's GoCodes asset ID. Requires the Kits feature to be enabled. Authorized account data.
get_task_details
ChatGPTGet the full detail record for a single task in the authenticated user's own GoCodes account, by its numeric task ID, including name, description, due date, status, assignee, and attachment metadata. Authorized account data.
get_tasks_for_asset
ChatGPTGet all tasks assigned to a specific company-owned asset in the authenticated user's own GoCodes account, by its GoCodes asset ID. Authorized account data.
get_user_profile
ChatGPTGet a GoCodes personal profile: name, alternate emails, and work/mobile phone numbers. Omit targetEmail to view the caller's own profile; supply it to view a DIFFERENT person's profile instead. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.
list_asset_attachments
ChatGPTList the attachment metadata (filename, size, upload date, uploader) on a company-owned asset in the authenticated user's own GoCodes account. Requires the Attachments feature to be enabled on the account. Authorized account data.
list_asset_types
ChatGPTList the asset types defined for the authenticated user's own GoCodes account (id and name) — the taxonomy used to categorize the caller's company assets. Authorized account data.
list_assets_by_location
ChatGPTList the authenticated user's own company-owned assets at a given home location (case-insensitive substring match). If 'location' is omitted or empty, instead returns the distinct locations with an asset count for each. Equipment locations within the caller's authorized GoCodes account, not people tracking.
list_assignees
ChatGPTList the assignees configured in the authenticated user's own GoCodes account (name and email) — the people the caller's assets can be checked out to and tasks assigned to (GoCodes calls them 'customers'). This is the caller's own account roster, which they are authorized to access.
list_checked_out_assets
ChatGPTList the authenticated user's own company-owned assets that are currently checked out (assigned to someone/somewhere), including who they are assigned to and their expected return date. Authorized account data.
list_company_accounts
ChatGPTList GoCodes company accounts (CustomerGroup): id, name, membership level, and whether the account is disabled. This is how an Administrator discovers a company's targetCustomerGroupId for use with the Account tools below (get_company_settings, update_company_settings, get_company_status, set_company_enabled), each of which requires that id. Omit searchText to list every company account in the system; supply it to filter to names containing that text (case-insensitive substring match). Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.
list_kits
ChatGPTList all kit-parent assets in the authenticated user's own GoCodes account (assets that group other assets together). Requires the Kits feature to be enabled. Authorized account data.
list_my_tasks
ChatGPTList the tasks assigned to the current authenticated user (the caller) in their own GoCodes account, including due dates, status, and the asset each task is on. Authorized account data.
list_overdue_assets
ChatGPTList the authenticated user's own checked-out company assets whose expected return date has passed (overdue), most overdue first, with the number of days overdue. Authorized account data.
list_service_due_assets
ChatGPTList the authenticated user's own company assets whose next scheduled service date is due. By default returns assets due on or before today; pass 'withinDays' to also include service coming up within that many days. Negative 'daysUntilDue' means already overdue. Authorized account data.
list_task_attachments
ChatGPTList the attachment metadata (filename, size, upload date, uploader) on a task in the authenticated user's own GoCodes account. Requires the Tasks and Attachments features to be enabled on the account. Authorized account data.
list_task_statuses
ChatGPTList the task statuses defined for the authenticated user's own GoCodes account (id and name), e.g. for interpreting the taskStatusId on a task. Authorized account data.
list_tasks
ChatGPTList all tasks in the authenticated user's own GoCodes account, including task details, due dates, assigned assets, and customer information. Returns up to 'limit' tasks. Authorized account data.
list_upcoming_due_dates
ChatGPTList upcoming due dates in the authenticated user's own GoCodes account for a date range: asset return dates, scheduled service dates, asset end-of-life dates, and task due dates. Dates are yyyy-MM-dd. Defaults to the next 30 days from today. Authorized account data.
search_assets
ChatGPTSearch the authenticated user's own GoCodes account inventory of company-owned assets, with free-text keyword search, structured field filters, sorting and paging (the same search the GoCodes web app's asset list uses). 'keyword' matches asset ID, type, serial number, model, description, group, location, assigned-to, status, custom fields, etc.; several space-separated words must ALL match, and a list of 8-character asset IDs returns exactly those assets. 'filters' narrow by specific fields, e.g. [{field:'status',operator:'eq',value:'Active'}, {field:'nextServiceDate',operator:'lte',value:'2024-12-31'}]. Filterable/sortable fields: assetId, otherAssetId, assetTagType, assetTypeId, assetTypeName, assetTypeDisplay, otherType, serialNumber, model, reward, description, subType, group, purchaseDate, originalCost, salvageValue, lifespanInYears, currentValue, warrantyTerms, lastServiceDate, lastServiceNote, nextServiceDate, homeLocation, assignedTo, checkedOut, returnDate, status, quantity, quantityMinimum, documentationUrl, hasPicture, locationDate, latitude, longitude, lastUpdated, customValue1..customValue10 (use get_custom_field_schema for their labels), lastChangedBy, kit, kitAssetId. Fields hidden from the caller by the account's per-user field permissions cannot be used to filter or sort. Text comparisons are case-insensitive. Results are paged: the response includes 'total' (all matches), 'hasMore' and 'nextPage' — request the next page to continue. All results are account data the caller is authorized to access.
set_company_enabled
ChatGPTEnable or disable a GoCodes company account. CAUTION: setting this to false locks every user in that company out of GoCodes until it is re-enabled — confirm this is really intended before calling; recommend calling get_company_status with the same id first to confirm you've resolved the intended company. Requires targetCustomerGroupId — use list_company_accounts to discover a company's id. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.
summarize_inventory
ChatGPTSummarize the authenticated user's own GoCodes account inventory. With no 'assignee', gives an account-wide summary (totals, value, breakdowns by type/status/location, and top assignees). With an 'assignee' (matches the asset's assigned-to value, case-insensitive substring), summarizes just the assets assigned to that person. Authorized account data.
undo_asset_changes
ChatGPTUndo the caller's own recent field edits to company-owned assets, rolling them back to their state before those changes, using the change log written by update_asset. It cannot bring back an asset removed with delete_asset. By default (apply=false) it only PREVIEWS what would be undone and writes nothing; call again with apply=true to actually perform the undo. With no dates it targets today's changes in UTC — the 'current session'; pass fromDate/toDate (ISO 8601, treated as UTC; a bare date covers the whole UTC day) to target a date range. Optionally restrict to one assetId. Each asset is rolled back to its earliest recorded state within the window (undoing every change in that window). Only changes made by the current user are considered. Undos are themselves logged, so they can be undone too. The caller's own authorized account data.
update_asset
ChatGPTUpdate the editable fields of a single company-owned asset in the authenticated user's own GoCodes account, identified by its GoCodes asset ID. Only the parameters you supply are changed; every other field is preserved. Each value you provide REPLACES that field wholesale — text fields are never appended to the existing value, so to add to a note you must pass the full new text yourself; omit a field to leave it unchanged. Internally the tool re-reads the asset's current values and re-submits the COMPLETE record with your changes merged in, because the GoCodes update API is a full replacement — any field left out of the request would be wiped. To clear a text field pass an empty string. Numeric/date fields you omit keep their current value. Changing 'checkedOut'/'assignedTo' records a check-out/check-in in the assignment history. Requires an account role that permits editing (Administrator, Customer, GroupAdministrator, AssetManager, or AssetAssigner); the caller's own authorized account data.
update_company_settings
ChatGPTUpdate a GoCodes company account's name, feature toggles, and/or which custom fields are shown on the check-out form (showCustomField1..10OnCheckOut, the writable counterpart of the checkOutVisibility that get_company_settings reports). Only the parameters you supply are changed — each is a single independent update, so omitted settings are never touched (unlike update_asset, there is no full-record replacement risk here). Enabling inventory alerts also enables inventory (a server-side rule, not replicated here). Whether the account itself is enabled is a separate tool, set_company_enabled. CAUTION: toggling enableAdvancedPermissions changes the permission model for every user in the company, not just the caller. Disabling enableTasks/enableKits/enableAttachments/enableTeletrac also disables the corresponding task/kit/attachment/location MCP tools for this account. Requires targetCustomerGroupId — use list_company_accounts to discover a company's id, and recommend calling get_company_settings with the same id first to confirm you've resolved the intended company. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.
update_task
ChatGPTUpdate an existing task in the authenticated user's own GoCodes account, by its numeric task ID. Only the parameters you supply are changed; every other field is preserved. Each value you provide REPLACES that field wholesale — text fields are never appended to the existing value; pass an empty string to clear a text field, or omit a field to leave it unchanged. Internally the tool re-reads the task's current values and re-submits the COMPLETE record with your changes merged in, because the GoCodes update API is a full replacement — any field left out of the request would be wiped. To change ONLY the status use update_task_status, and to change ONLY the assignee use assign_task. Requires the Tasks feature and a role that permits editing tasks (Administrator, GroupAdministrator, or AssetManager). The caller's own authorized account data.
update_task_status
ChatGPTChange only the status of a task in the authenticated user's own GoCodes account, by its numeric task ID. Use list_task_statuses to get the valid status IDs for the account. This is the preferred way to change a task's status: it touches only the status field, so no other task data can be affected. Requires the Tasks feature and a role that permits updating tasks (Administrator, GroupAdministrator, AssetManager, or AssetAssigner). The caller's own authorized account data.
update_user_profile
ChatGPTUpdate fields of a GoCodes personal profile. Only the parameters you supply are changed; every other field is preserved (internally the tool re-reads the current profile and re-submits it with your changes merged in). Empty string clears a text field; omit a field to leave it unchanged. Omit targetEmail to update the caller's own profile; supply it to update a DIFFERENT person's profile instead — recommend calling get_user_profile with the same targetEmail first to confirm you've resolved the intended person. Restricted to callers whose GoCodes account has the Administrator (GoCodes staff) role — regular account users, including a company's own GroupAdministrator, cannot use this tool.