Biteship MCP by usefulapi

Compare courier rates, book courier pickups, cancel orders and track parcels in Biteship.

Should I use this

Quality & Safety

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

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,517Tokens (tool definitions)
~2.7 KBTypical response size
Moderate attention impact (1.97% 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": {
    "biteship": {
      "url": "https://biteship.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

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

What it can do

Tool inventory

Tools (8)

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

List the courier services Biteship can book, with courier_code, courier_service_code, service type and cash-on-delivery and proof-of-delivery support. Good first call. Biteship API: GET /v1/couriers.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢biteship_search_areas(input, countries)

Find Biteship area ids by place name, for example 'Pesanggrahan' or 'Jakarta Selatan'. Use the id in biteship_get_rates and biteship_create_order. Each call counts against the Maps quota on live keys. Biteship API: GET /v1/maps/areas.

Input Schema

{
  "type": "object",
  "properties": {
    "input": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "Place name to search for."
    },
    "countries": {
      "description": "ISO country codes, comma separated (default ID, Indonesia).",
      "type": "string",
      "pattern": "^[A-Za-z]{2}(,[A-Za-z]{2})*$"
    }
  },
  "required": [
    "input"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢biteship_get_rates(origin_area_id, destination_area_id, couriers, items)

Quote the price and delivery time of each courier service for one route. Returns quotes only; no order is created. Each quote has company and type values; biteship_create_order takes them as courier_company and courier_type. Each call counts against the Rates quota on live keys. Biteship API: POST /v1/rates/couriers.

Input Schema

{
  "type": "object",
  "properties": {
    "origin_area_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Area id from biteship_search_areas."
    },
    "destination_area_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Area id from biteship_search_areas."
    },
    "couriers": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]+(,[A-Za-z0-9_]+)*$",
      "description": "Courier codes separated by commas, from biteship_list_couriers, for example 'jne,sicepat'."
    },
    "items": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Item name."
          },
          "description": {
            "description": "What the item is.",
            "type": "string",
            "maxLength": 500
          },
          "value": {
            "type": "number",
            "minimum": 0,
            "description": "Declared item value. Biteship prices in IDR."
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991,
            "description": "Number of units."
          },
          "weight": {
            "type": "number",
            "exclusiveMinimum": 0,
            "description": "Weight in grams."
          },
          "length": {
            "description": "Length in centimeters.",
            "type": "number",
            "minimum": 0
          },
          "width": {
            "description": "Width in centimeters.",
            "type": "number",
            "minimum": 0
          },
          "height": {
            "description": "Height in centimeters.",
            "type": "number",
            "minimum": 0
          }
        },
        "required": [
          "name",
          "value",
          "quantity",
          "weight"
        ]
      },
      "description": "Items in the parcel."
    }
  },
  "required": [
    "origin_area_id",
    "destination_area_id",
    "couriers",
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢biteship_get_location(location_id)

Read one saved location (an address in the customer's Biteship address book) by its id. Biteship API: GET /v1/locations/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "location_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$",
      "description": "Location id from the Biteship dashboard."
    }
  },
  "required": [
    "location_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢biteship_get_order(order_id)

Read one order by its id: status, courier, waybill_id, tracking_id and status history. Biteship API: GET /v1/orders/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$",
      "description": "Order id, from biteship_create_order or the Biteship dashboard."
    }
  },
  "required": [
    "order_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢biteship_get_tracking(tracking_id)

Read the tracking status and history of a shipment by its tracking id (courier.tracking_id on the order). Biteship API: GET /v1/trackings/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "tracking_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$",
      "description": "Tracking id, from the order's courier.tracking_id."
    }
  },
  "required": [
    "tracking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴biteship_create_order(confirm_spend, origin_contact_name, origin_contact_phone, origin_address, origin_note, ...)

BOOKS A LIVE SHIPMENT: creates a Biteship order and asks the courier to pick up the parcel. It uses the customer's monthly Orders quota or Biteship balance. Call only when the user asks to book this exact shipment, after a rate check with biteship_get_rates. Set confirm_spend to true only after the user approves the cost. Undo with biteship_cancel_order. Biteship API: POST /v1/orders.

Input Schema

{
  "type": "object",
  "properties": {
    "confirm_spend": {
      "type": "boolean",
      "const": true,
      "description": "Must be true. Set it only after the user approves that this order books a courier and spends balance."
    },
    "origin_contact_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Name of the person at the pickup location."
    },
    "origin_contact_phone": {
      "type": "string",
      "minLength": 5,
      "maxLength": 30,
      "description": "Phone of the person at the pickup location."
    },
    "origin_address": {
      "type": "string",
      "minLength": 5,
      "maxLength": 500,
      "description": "Full pickup address."
    },
    "origin_note": {
      "description": "Pickup note, for example the building colour.",
      "type": "string",
      "maxLength": 500
    },
    "origin_area_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Pickup area id from biteship_search_areas."
    },
    "origin_latitude": {
      "description": "Pickup latitude. Send with origin_longitude. Instant couriers need coordinates.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "origin_longitude": {
      "description": "Pickup longitude. Send with origin_latitude.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "destination_contact_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Name of the receiver."
    },
    "destination_contact_phone": {
      "type": "string",
      "minLength": 5,
      "maxLength": 30,
      "description": "Phone of the receiver."
    },
    "destination_contact_email": {
      "description": "Email of the receiver.",
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "destination_address": {
      "type": "string",
      "minLength": 5,
      "maxLength": 500,
      "description": "Full delivery address."
    },
    "destination_note": {
      "description": "Delivery note.",
      "type": "string",
      "maxLength": 500
    },
    "destination_area_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Delivery area id from biteship_search_areas."
    },
    "destination_latitude": {
      "description": "Delivery latitude. Send with destination_longitude.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "destination_longitude": {
      "description": "Delivery longitude. Send with destination_latitude.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "courier_company": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]+$",
      "description": "Courier code from biteship_get_rates (company), for example 'jne'."
    },
    "courier_type": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Service type from biteship_get_rates (type), for example 'reg'."
    },
    "delivery_type": {
      "type": "string",
      "enum": [
        "now",
        "scheduled"
      ],
      "description": "'now' asks for pickup at once. 'scheduled' also needs delivery_date and delivery_time."
    },
    "delivery_date": {
      "description": "Pickup date, yyyy-mm-dd. Required for scheduled orders.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "delivery_time": {
      "description": "Pickup time, HH:mm (24 hours). Required for scheduled orders.",
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
    },
    "order_note": {
      "description": "Note for the courier.",
      "type": "string",
      "maxLength": 500
    },
    "reference_id": {
      "description": "Your own order id, to match this order later.",
      "type": "string",
      "maxLength": 128
    },
    "items": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Item name."
          },
          "description": {
            "description": "What the item is.",
            "type": "string",
            "maxLength": 500
          },
          "value": {
            "type": "number",
            "minimum": 0,
            "description": "Declared item value. Biteship prices in IDR."
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991,
            "description": "Number of units."
          },
          "weight": {
            "type": "number",
            "exclusiveMinimum": 0,
            "description": "Weight in grams."
          },
          "length": {
            "description": "Length in centimeters.",
            "type": "number",
            "minimum": 0
          },
          "width": {
            "description": "Width in centimeters.",
            "type": "number",
            "minimum": 0
          },
          "height": {
            "description": "Height in centimeters.",
            "type": "number",
            "minimum": 0
          }
        },
        "required": [
          "name",
          "value",
          "quantity",
          "weight"
        ]
      },
      "description": "Items in the parcel."
    }
  },
  "required": [
    "confirm_spend",
    "origin_contact_name",
    "origin_contact_phone",
    "origin_address",
    "origin_area_id",
    "destination_contact_name",
    "destination_contact_phone",
    "destination_address",
    "destination_area_id",
    "courier_company",
    "courier_type",
    "delivery_type",
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴biteship_cancel_order(order_id, cancellation_reason_code, cancellation_reason)

Cancel a live Biteship order by its id. Use only when the user asks to cancel that order. Reason codes in the docs: change_courier, pickup_delay, change_address, others. Biteship API: POST /v1/orders/{id}/cancel.

Input Schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$",
      "description": "Order id to cancel."
    },
    "cancellation_reason_code": {
      "type": "string",
      "enum": [
        "change_courier",
        "pickup_delay",
        "change_address",
        "others"
      ],
      "description": "Reason code from the Biteship docs: change_courier, pickup_delay, change_address or others."
    },
    "cancellation_reason": {
      "description": "Free-text reason, for example when the code is 'others'.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "order_id",
    "cancellation_reason_code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded8 tools