Transdirect MCP by usefulapi

Get courier quotes, book and pay for shipments, track parcels and cancel bookings in Transdirect.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
80%
Naming quality
78%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'transdirect_list_payment_methods' name length outside 3-30 rangein transdirect_list_payment_methods

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,474Tokens (tool definitions)
~1.9 KBTypical response size
Moderate attention impact (1.93% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "transdirect": {
      "url": "https://transdirect.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://transdirect.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (11)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢transdirect_get_member

Get the Transdirect member account behind the API key: company, credit limit and available credit, charge type, discount factor. Transdirect API: GET /member.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢transdirect_list_payment_methods

List the saved payment methods (credit card or PayPal) on the member account. Use an id as payment_method in transdirect_confirm_booking. Transdirect API: GET /members/payment-methods.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢transdirect_list_couriers

List the couriers Transdirect supports, grouped by carrier, with the courier ids used in quotes and transdirect_confirm_booking. Transdirect API: GET /couriers.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢transdirect_search_locations(q, limit)

Search valid Australian suburbs and postcodes for an address. Use the suburb, state and postcode in quotes. Transdirect API: GET /locations/search.

Input Schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Suburb name or postcode to search for."
    },
    "limit": {
      "description": "Maximum results (default set by Transdirect).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "q"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢transdirect_list_bookings(since, sort)

List the member's bookings, optionally since a value Transdirect accepts for `since`. Each booking has status, courier, connote and cost. Transdirect API: GET /bookings.

Input Schema

{
  "type": "object",
  "properties": {
    "since": {
      "description": "Only bookings changed since this value (format per Transdirect).",
      "type": "string",
      "maxLength": 40
    },
    "sort": {
      "description": "Sort order, as Transdirect accepts it.",
      "type": "string",
      "maxLength": 40
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢transdirect_get_booking(booking_id)

Get one booking: status, is_paid, courier, sender and receiver, items, cost, connote and checks. Transdirect API: GET /bookings/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "pattern": "^\\d{1,18}$",
      "description": "Transdirect booking id."
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢transdirect_get_label_url(booking_id)

Get a signed public URL for the booking's shipping label PDF. The link opens the PDF without a login. Transdirect API: GET /bookings/{id}/public_url.

Input Schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "pattern": "^\\d{1,18}$",
      "description": "Transdirect booking id."
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢transdirect_track_shipment(reference)

Track a shipment by its reference or connote: state (picked_up, in_transit, delivered, attention, ...), headline and per-item events. Transdirect API: GET /tracking/{reference}.

Input Schema

{
  "type": "object",
  "properties": {
    "reference": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Shipment reference or connote."
    }
  },
  "required": [
    "reference"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴transdirect_get_quotes(sender, receiver, items, declared_value, pickup_date, ...)

Create a DRAFT booking for a shipment and return courier quotes (prices and tiers). Nothing is paid or lodged. Quotes can include a demo courier (sandbox only): never confirm a demo quote for a real shipment. Transdirect API: POST /bookings.

Input Schema

{
  "type": "object",
  "properties": {
    "sender": {
      "type": "object",
      "properties": {
        "name": {
          "description": "Contact name.",
          "type": "string",
          "maxLength": 120
        },
        "company_name": {
          "description": "Company name.",
          "type": "string",
          "maxLength": 120
        },
        "address": {
          "description": "Street address line.",
          "type": "string",
          "maxLength": 160
        },
        "address2": {
          "description": "Second address line.",
          "type": "string",
          "maxLength": 160
        },
        "suburb": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "description": "Suburb or locality (resolve with transdirect_search_locations)."
        },
        "state": {
          "type": "string",
          "minLength": 2,
          "maxLength": 3,
          "description": "State code, e.g. NSW, VIC, QLD."
        },
        "postcode": {
          "type": "string",
          "minLength": 3,
          "maxLength": 10,
          "description": "Postcode: 4 digits in Australia, or the destination postcode abroad."
        },
        "country": {
          "description": "2-letter ISO country code. Default AU.",
          "type": "string",
          "minLength": 2,
          "maxLength": 2
        },
        "phone": {
          "description": "Contact phone.",
          "type": "string",
          "maxLength": 40
        },
        "email": {
          "description": "Contact email.",
          "type": "string",
          "maxLength": 160
        },
        "residential": {
          "description": "true for a residential address, false for a business.",
          "type": "boolean"
        },
        "tailgate": {
          "description": "Tailgate (lift) service at this address.",
          "type": "boolean"
        }
      },
      "required": [
        "suburb",
        "state",
        "postcode"
      ],
      "description": "Pickup address."
    },
    "receiver": {
      "type": "object",
      "properties": {
        "name": {
          "description": "Contact name.",
          "type": "string",
          "maxLength": 120
        },
        "company_name": {
          "description": "Company name.",
          "type": "string",
          "maxLength": 120
        },
        "address": {
          "description": "Street address line.",
          "type": "string",
          "maxLength": 160
        },
        "address2": {
          "description": "Second address line.",
          "type": "string",
          "maxLength": 160
        },
        "suburb": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "description": "Suburb or locality (resolve with transdirect_search_locations)."
        },
        "state": {
          "type": "string",
          "minLength": 2,
          "maxLength": 3,
          "description": "State code, e.g. NSW, VIC, QLD."
        },
        "postcode": {
          "type": "string",
          "minLength": 3,
          "maxLength": 10,
          "description": "Postcode: 4 digits in Australia, or the destination postcode abroad."
        },
        "country": {
          "description": "2-letter ISO country code. Default AU.",
          "type": "string",
          "minLength": 2,
          "maxLength": 2
        },
        "phone": {
          "description": "Contact phone.",
          "type": "string",
          "maxLength": 40
        },
        "email": {
          "description": "Contact email.",
          "type": "string",
          "maxLength": 160
        },
        "residential": {
          "description": "true for a residential address, false for a business.",
          "type": "boolean"
        },
        "tailgate": {
          "description": "Tailgate (lift) service at this address.",
          "type": "boolean"
        }
      },
      "required": [
        "suburb",
        "state",
        "postcode"
      ],
      "description": "Delivery address."
    },
    "items": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "description": "Package type or contents, e.g. Carton.",
            "type": "string",
            "maxLength": 80
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 999,
            "description": "Number of identical items."
          },
          "weight": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 1000,
            "description": "Weight of one item in kg."
          },
          "length": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 400,
            "description": "Length of one item in cm."
          },
          "width": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 400,
            "description": "Width of one item in cm."
          },
          "height": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 400,
            "description": "Height of one item in cm."
          }
        },
        "required": [
          "quantity",
          "weight",
          "length",
          "width",
          "height"
        ]
      },
      "description": "Packages. Weight in kg, dimensions in cm."
    },
    "declared_value": {
      "description": "Declared value of the goods in AUD (transit cover). Default 0.",
      "type": "number",
      "minimum": 0
    },
    "pickup_date": {
      "description": "Pickup date yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "goods_description": {
      "description": "Short description of the goods.",
      "type": "string",
      "maxLength": 80
    },
    "customer_reference": {
      "description": "Your own order or consignment reference.",
      "type": "string",
      "maxLength": 80
    },
    "tailgate_pickup": {
      "description": "Tailgate at pickup.",
      "type": "boolean"
    },
    "tailgate_delivery": {
      "description": "Tailgate at delivery.",
      "type": "boolean"
    }
  },
  "required": [
    "sender",
    "receiver",
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴transdirect_confirm_booking(booking_id, courier, tier, payment_method, pickup_date, ...)

PAYS and lodges a draft booking with the chosen courier. Charges the payment method you pass. Call only after the user approves this courier, tier, price and payment method. Demo is refused. Transdirect API: POST /bookings/{id}/confirm.

Input Schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "pattern": "^\\d{1,18}$",
      "description": "Transdirect booking id."
    },
    "courier": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Courier id from transdirect_get_quotes, e.g. couriers_please."
    },
    "tier": {
      "description": "Quote tier number, when the courier offers several.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "payment_method": {
      "type": "string",
      "pattern": "^(credit|nab_\\d{1,15}|paypal_\\d{1,15})$",
      "description": "Payment: 'credit' (member credit account) or a saved method id nab_<id> / paypal_<id>. Demo is refused."
    },
    "pickup_date": {
      "description": "Pickup date yyyy-mm-dd, if the quote asks for one.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "confirm": {
      "type": "boolean",
      "const": true,
      "description": "Must be true: the user explicitly approved paying for and lodging this booking now."
    }
  },
  "required": [
    "booking_id",
    "courier",
    "payment_method",
    "confirm"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴transdirect_cancel_booking(booking_id, reason, confirm)

Cancel a booking. Transdirect applies its own refund, courier cancellation or support escalation. Call only after the user approves the cancellation. Transdirect API: POST /bookings/{id}/cancel.

Input Schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "pattern": "^\\d{1,18}$",
      "description": "Transdirect booking id."
    },
    "reason": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Reason for the cancellation (sent to Transdirect)."
    },
    "confirm": {
      "type": "boolean",
      "const": true,
      "description": "Must be true: the user explicitly approved cancelling this booking now."
    }
  },
  "required": [
    "booking_id",
    "reason",
    "confirm"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded11 tools