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
Findings (1)
- LOWin transdirect_list_payment_methods
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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-httpWhat it can do
Tool inventory
Tools (11)
🟢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
Evidence