Biteship MCP by usefulapi
Compare courier rates, book courier pickups, cancel orders and track parcels in Biteship.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"biteship": {
"url": "https://biteship.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://biteship.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (8)
🟢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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia