Machship MCP

Groups and consolidates consignments in a single operation (combines grouping + performing). Args: - options (object): Consolidation options (companyId, carrierId, grouping rules, etc.)

Automatically groups consignments into consolidation groups based on options (carrier, route, etc.). Returns groups without actually consolidating — preview step before consolidation. Args: - options (object): Consolidation grouping options (companyId, carrierId, etc.)

Groups a specific set of consignments into manifest groups (preview before manifesting). Args: - consignmentIds (number[]): Consignment IDs to group

Groups consignments for batch label printing and returns print groups. Args: - consignmentIds (number[]): Consignment IDs to group for printing

Assign companies and roles to identities to give them access to the system. Requires administrator access. Args: - links (array): Array of identity-company link objects, each with identityId, companyId, and roles

Books/manifests consignments with the carrier — creates the pickup booking and generates tracking numbers. This is the final step in the consignment workflow before physical pickup. Args: - manifests (array): Array of booked manifest objects with consignment IDs and carrier booking details

Consolidates a set of consignments into consolidated shipments. This merges multiple consignments into fewer shipment units for carrier efficiency. Args: - request (object): Consolidation request with consignment IDs and consolidation parameters

Determines the current user's login status and retrieves session properties from Machship. Use this to verify authentication is working and to get the current user/company context. Returns: session info including user details, company ID, and permissions.

Rebooks the carrier pickup for an existing manifest (e.g. missed pickup or changed schedule). Args: - rebooking (object): Rebooking details including manifestId and new pickup datetime

Re-enable previously disabled identities, restoring login access. Args: - ids (number[]): Array of identity IDs to re-enable

Removes an existing link between two organisations. This action is irreversible. Args: - request (object): Unlink request with organisationLinkId to remove

Resets the public key for an organisation (generates new key). Does NOT affect existing links. Args: - id (number, optional): Organisation ID (defaults to current org)

Get the public keys of the supplied identities. These keys can be used by a linked organisation to grant those identities access to companies in their organisation. Requires administrator access. Args: - ids (number[]): Array of identity IDs to retrieve public keys for

Returns item labels as a zip for up to 40 consignments (POST variant — use this when passing a body payload is preferred over query string). Returns { fileBase64, contentType, sizeBytes }. contentType comes from the response header. Args: - consignmentIds (number[]): Consignment IDs (max 40) - printA4 (boolean, optional): Print in A4 format

Searches consignments by reference numbers (Reference 1, Reference 2, or carrier IDs). Args: - references (string[]): Array of reference strings to search for

Returns up to 10 Machship locations matching a suburb or postcode search string. Use this to look up valid delivery/pickup locationIds before creating consignments. Args: - s (string): Search string — suburb name, postcode, or both (e.g. "Melbourne 3000") - response_format ('json' | 'markdown'): Output format (default: 'json') Returns: Array of location objects: { "id": number, "suburb": string, "postcode": string, "state": string, "country": string } Examples: - Use when: "What location ID is for Sydney 2000?" -> search "Sydney 2000", pick from results - Use when: Validating a delivery address before creating a consignment

Sends labels directly to a configured printer in Machship. Args: - requests (array): Array of print requests, each with consignmentId, printerId, labelType, etc.

Remove company access from identities. Each entry specifies an identity and the company to revoke access from. Args: - unlinks (array): Array of objects with identityId and companyId to unlink

Manually updates tracking statuses for consignments (e.g. mark as delivered). Args: - statuses (array): Array of manual tracking status objects, each with consignmentId, status, and datetime

Updates an existing custom schema by its DotNet class ID. Args: - id (string): DotNet class ID of the schema to update - schema (object): Updated JSON schema definition

Updates despatch dates and estimated time of arrival (ETA) for a set of consignments. Args: - updates (array): Array of objects with consignmentId and new despatch date/ETA

Updates properties on an identity. All fields except password are required; omitted fields are set to null. Args: - id (number): Identity ID (required) - givenName (string): First name (required) - familyName (string): Last name (required) - displayName (string): Display name (required) - emailAddress (string): Email address (required) - owningCompanyId (number): Owning company ID (required) - password (string, optional): New password - phone / businessPhone / mobile / position / notes (optional)

Updates consignment items on a carrier invoice entry and triggers repricing. Use for reconciling carrier invoice discrepancies. Args: - body (object): Repricing request payload (consignmentId, items, etc.)

Uploads one or more attachments to Machship. Args: - attachments (array): Array of attachment objects. Each object should contain: - consignmentId (number): Consignment to attach to - fileName (string): File name with extension - fileBase64 (string): Base64-encoded file content - attachmentTypeId (number, optional): Type of attachment

Uploads one or more commercial invoice files for a consignment (for international shipments). Files are provided as base64-encoded content. Args: - consignmentId (number): The consignment to attach the invoice to - files (array): Array of files, each with fileName and fileBase64 content