Indonesia Logistics (Biteship: courier rates / cek ongkir, create orders, track waybills)

Official4 toolsLive

by junter1989k-ai · JavaScript

Indonesia shipping for AI agents via Biteship: courier rates, create orders, track waybills.

Topics

ai-agentbiteshipclaudefirsindonesialogisticsmcpmcp-servershippingwishpool

Captured live from the server via tools/list.

check_rates

Indonesia shipping courier rates — THE tool to call FIRST. Given an origin and a destination (each by 5-digit Indonesian postal code OR a Biteship area_id), the parcel items (name, value IDR, weight in GRAMS, quantity), and optionally which couriers to compare, it returns every available courier service (JNE, J&T, SiCepat, AnterAja, Gojek, Grab, Ninja, Pos Indonesia, Lion Parcel and more) with its shipping fee (IDR), estimated duration and service type, plus which one is cheapest — the Indonesia killer feature (cek ongkir). Read-only: quotes only, creates nothing and spends nothing. Bring your own Biteship API key via header x-biteship-key.

Parameters6

origin_postal_code	string	optional	Origin 5-digit Indonesian postal code the parcel ships FROM. Provide this OR origin_area_id.
origin_area_id	string	optional	Biteship area_id for the origin (from the Maps/Areas lookup). Alternative to origin_postal_code.
destination_postal_code	string	optional	Destination 5-digit Indonesian postal code the parcel ships TO. Provide this OR destination_area_id.
destination_area_id	string	optional	Biteship area_id for the destination. Alternative to destination_postal_code.
couriers	string	optional	Comma-separated courier codes to compare, e.g. "jne,jnt,sicepat,anteraja,gojek,grab". Optional — defaults to a broad set of popular Indonesian couriers.
items	array	required	Parcel line items. At least one. Each: { name (required), value (required, IDR), weight (required, GRAMS), quantity (required int), length?/width?/height? (cm) }.

Raw schema

{
  "type": "object",
  "properties": {
    "origin_postal_code": {
      "type": "string",
      "description": "Origin 5-digit Indonesian postal code the parcel ships FROM. Provide this OR origin_area_id."
    },
    "origin_area_id": {
      "type": "string",
      "description": "Biteship area_id for the origin (from the Maps/Areas lookup). Alternative to origin_postal_code."
    },
    "destination_postal_code": {
      "type": "string",
      "description": "Destination 5-digit Indonesian postal code the parcel ships TO. Provide this OR destination_area_id."
    },
    "destination_area_id": {
      "type": "string",
      "description": "Biteship area_id for the destination. Alternative to destination_postal_code."
    },
    "couriers": {
      "type": "string",
      "description": "Comma-separated courier codes to compare, e.g. \"jne,jnt,sicepat,anteraja,gojek,grab\". Optional — defaults to a broad set of popular Indonesian couriers."
    },
    "items": {
      "type": "array",
      "description": "Parcel line items. At least one. Each: { name (required), value (required, IDR), weight (required, GRAMS), quantity (required int), length?/width?/height? (cm) }.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Product name."
          },
          "value": {
            "type": "number",
            "description": "Item value in IDR (used for insurance / COD)."
          },
          "weight": {
            "type": "number",
            "description": "Item weight in GRAMS (g). e.g. 1000 = 1 kg. Required."
          },
          "quantity": {
            "type": "number",
            "description": "Quantity (integer >= 1)."
          },
          "length": {
            "type": "number",
            "description": "Item length in CENTIMETRES (cm). Optional."
          },
          "width": {
            "type": "number",
            "description": "Item width in CENTIMETRES (cm). Optional."
          },
          "height": {
            "type": "number",
            "description": "Item height in CENTIMETRES (cm). Optional."
          }
        },
        "required": [
          "name",
          "value",
          "weight",
          "quantity"
        ]
      }
    }
  },
  "required": [
    "items"
  ]
}

create_shipment

Create an Indonesia shipping order in Biteship — pass the origin (pickup) contact + address, the destination (recipient) contact + address, the parcel items, and the chosen courier_company + courier_type (from check_rates courier_code + courier_service_code). Each location needs a postal_code OR area_id. Returns the Biteship order id, the courier waybill_id (once allocated) and the price (IDR). delivery_type defaults to "now" (immediate pickup). Bring your own Biteship API key via header x-biteship-key — a biteship_live_ key ships real parcels and debits your Biteship balance; a biteship_test_ key stays in the sandbox. Owner policy headers gate the order value (IDR) before creation.

Parameters24

shipper_contact_name	string	optional	Business/shipper name shown to the courier. Optional — defaults to the origin contact name.
origin_contact_name	string	required	Pickup contact person name. Required.
origin_contact_phone	string	required	Pickup contact phone (Indonesian number). Required.
origin_address	string	required	Full pickup street address. Required.
origin_note	string	optional	Note for the courier at pickup. Optional.
origin_postal_code	string	optional	Pickup 5-digit postal code. Provide this OR origin_area_id.
origin_area_id	string	optional	Biteship area_id for the pickup location. Alternative to origin_postal_code.
destination_contact_name	string	required	Recipient name. Required.
destination_contact_phone	string	required	Recipient phone (Indonesian number). Required.
destination_contact_email	string	optional	Recipient email. Optional.
destination_address	string	required	Full recipient street address. Required.
destination_note	string	optional	Delivery note for the courier. Optional.
destination_postal_code	string	optional	Recipient 5-digit postal code. Provide this OR destination_area_id.
destination_area_id	string	optional	Biteship area_id for the recipient. Alternative to destination_postal_code.
courier_company	string	required	Courier code from check_rates (courier_code), e.g. "jne", "jnt", "sicepat", "anteraja", "gojek", "grab". Required.
courier_type	string	required	Courier service type from check_rates (courier_service_code), e.g. "reg", "yes", "instant", "same_day". Required.
delivery_type	string	optional	"now" (immediate pickup, default) or "scheduled" (with delivery_date + delivery_time).
delivery_date	string	optional	Scheduled pickup date "YYYY-MM-DD" (only when delivery_type=scheduled).
delivery_time	string	optional	Scheduled pickup time "HH:mm" (only when delivery_type=scheduled).
order_note	string	optional	Free-text note for the whole order. Optional.
reference_id	string	optional	Your own order reference (any unique string). Optional.
destination_cash_on_delivery	number	optional	COD amount to collect in IDR. Optional — omit for prepaid.
courier_insurance	number	optional	Declared insurance amount in IDR. Optional.
items	array	required	Parcel line items. At least one. Each: { name (required), value (required, IDR), weight (required, GRAMS), quantity (required int), description?, sku?, length?/width?/height? (cm) }.

Raw schema

{
  "type": "object",
  "properties": {
    "shipper_contact_name": {
      "type": "string",
      "description": "Business/shipper name shown to the courier. Optional — defaults to the origin contact name."
    },
    "origin_contact_name": {
      "type": "string",
      "description": "Pickup contact person name. Required."
    },
    "origin_contact_phone": {
      "type": "string",
      "description": "Pickup contact phone (Indonesian number). Required."
    },
    "origin_address": {
      "type": "string",
      "description": "Full pickup street address. Required."
    },
    "origin_note": {
      "type": "string",
      "description": "Note for the courier at pickup. Optional."
    },
    "origin_postal_code": {
      "type": "string",
      "description": "Pickup 5-digit postal code. Provide this OR origin_area_id."
    },
    "origin_area_id": {
      "type": "string",
      "description": "Biteship area_id for the pickup location. Alternative to origin_postal_code."
    },
    "destination_contact_name": {
      "type": "string",
      "description": "Recipient name. Required."
    },
    "destination_contact_phone": {
      "type": "string",
      "description": "Recipient phone (Indonesian number). Required."
    },
    "destination_contact_email": {
      "type": "string",
      "description": "Recipient email. Optional."
    },
    "destination_address": {
      "type": "string",
      "description": "Full recipient street address. Required."
    },
    "destination_note": {
      "type": "string",
      "description": "Delivery note for the courier. Optional."
    },
    "destination_postal_code": {
      "type": "string",
      "description": "Recipient 5-digit postal code. Provide this OR destination_area_id."
    },
    "destination_area_id": {
      "type": "string",
      "description": "Biteship area_id for the recipient. Alternative to destination_postal_code."
    },
    "courier_company": {
      "type": "string",
      "description": "Courier code from check_rates (courier_code), e.g. \"jne\", \"jnt\", \"sicepat\", \"anteraja\", \"gojek\", \"grab\". Required."
    },
    "courier_type": {
      "type": "string",
      "description": "Courier service type from check_rates (courier_service_code), e.g. \"reg\", \"yes\", \"instant\", \"same_day\". Required."
    },
    "delivery_type": {
      "type": "string",
      "description": "\"now\" (immediate pickup, default) or \"scheduled\" (with delivery_date + delivery_time)."
    },
    "delivery_date": {
      "type": "string",
      "description": "Scheduled pickup date \"YYYY-MM-DD\" (only when delivery_type=scheduled)."
    },
    "delivery_time": {
      "type": "string",
      "description": "Scheduled pickup time \"HH:mm\" (only when delivery_type=scheduled)."
    },
    "order_note": {
      "type": "string",
      "description": "Free-text note for the whole order. Optional."
    },
    "reference_id": {
      "type": "string",
      "description": "Your own order reference (any unique string). Optional."
    },
    "destination_cash_on_delivery": {
      "type": "number",
      "description": "COD amount to collect in IDR. Optional — omit for prepaid."
    },
    "courier_insurance": {
      "type": "number",
      "description": "Declared insurance amount in IDR. Optional."
    },
    "items": {
      "type": "array",
      "description": "Parcel line items. At least one. Each: { name (required), value (required, IDR), weight (required, GRAMS), quantity (required int), description?, sku?, length?/width?/height? (cm) }.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Product name."
          },
          "description": {
            "type": "string",
            "description": "Item description. Optional."
          },
          "sku": {
            "type": "string",
            "description": "Stock keeping unit / product code. Optional."
          },
          "value": {
            "type": "number",
            "description": "Item value in IDR. Required (used for insurance/COD and the owner policy gate)."
          },
          "weight": {
            "type": "number",
            "description": "Item weight in GRAMS (g). Required."
          },
          "quantity": {
            "type": "number",
            "description": "Quantity (integer >= 1). Required."
          },
          "length": {
            "type": "number",
            "description": "Item length in CENTIMETRES (cm). Optional."
          },
          "width": {
            "type": "number",
            "description": "Item width in CENTIMETRES (cm). Optional."
          },
          "height": {
            "type": "number",
            "description": "Item height in CENTIMETRES (cm). Optional."
          }
        },
        "required": [
          "name",
          "value",
          "weight",
          "quantity"
        ]
      }
    }
  },
  "required": [
    "origin_contact_name",
    "origin_contact_phone",
    "origin_address",
    "destination_contact_name",
    "destination_contact_phone",
    "destination_address",
    "courier_company",
    "courier_type",
    "items"
  ]
}

query_tracking

Track an Indonesia shipment. Provide the Biteship tracking_id (returned by create_shipment) OR the Biteship order_id OR a public waybill + courier_code pair. Returns the current status plus a plain-English hint. Common Biteship statuses: confirmed, scheduled, allocated, picking_up, picked, dropping_off, delivered, on_hold, courier_not_found, return_in_transit, returned, rejected, disposed, cancelled. The raw response (history scans, courier, link) is always included. Non-terminal statuses carry next_steps. Safe to call anytime. NOTE: a brand-new order may show "confirmed" with no waybill until a courier is allocated.

Parameters4

tracking_id	string	optional	The Biteship tracking_id returned by create_shipment (preferred).
order_id	string	optional	Alternative: the Biteship order id (looks up the order and its current status).
waybill_id	string	optional	Alternative (public tracking): the courier AWB / waybill number. Requires courier_code too.
courier_code	string	optional	Courier code for public waybill tracking, e.g. "jne", "jnt", "sicepat". Required when using waybill_id.

Raw schema

{
  "type": "object",
  "properties": {
    "tracking_id": {
      "type": "string",
      "description": "The Biteship tracking_id returned by create_shipment (preferred)."
    },
    "order_id": {
      "type": "string",
      "description": "Alternative: the Biteship order id (looks up the order and its current status)."
    },
    "waybill_id": {
      "type": "string",
      "description": "Alternative (public tracking): the courier AWB / waybill number. Requires courier_code too."
    },
    "courier_code": {
      "type": "string",
      "description": "Courier code for public waybill tracking, e.g. \"jne\", \"jnt\", \"sicepat\". Required when using waybill_id."
    }
  }
}

cancel_shipment

Cancel an Indonesia Biteship order by its Biteship order id, with a cancellation reason. Cancellation is only possible before the parcel is picked up / in transit — an already-picked-up order cannot be cancelled here. Returns the cancellation result reported by Biteship.

Parameters2

order_id	string	required	The Biteship order id to cancel (the id create_shipment returned). Required.
cancellation_reason	string	optional	Why the order is being cancelled (free text). Optional — a default reason is used if omitted.

Raw schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "The Biteship order id to cancel (the id create_shipment returned). Required."
    },
    "cancellation_reason": {
      "type": "string",
      "description": "Why the order is being cancelled (free text). Optional — a default reason is used if omitted."
    }
  },
  "required": [
    "order_id"
  ]
}

README.md6 KBView on GitHub

Indonesia Logistics MCP 🇮🇩 — How can my AI agent ship a parcel across Indonesia (JNE / J&T / SiCepat via Biteship)?

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "indonesia-logistics": {
      "type": "http",
      "url": "https://logi-id.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/indonesia-logistics-mcp && cd indonesia-logistics-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Remote MCP server that lets any AI agent ship parcels across Indonesia — over JNE, J&T, SiCepat, AnterAja, Ninja, Pos Indonesia, Lion Parcel, Gojek and Grab — through the Biteship shipping API. Compare courier rates by postal code (cek ongkir), create shipping orders, track parcels by waybill, and cancel orders. Stateless, bring-your-own Biteship API key, never stores anything.

Live endpoint: https://logi-id.wishpool.app/mcp · Registry: app.wishpool/indonesia-logistics-mcp

Quick start

json

{
  "mcpServers": {
    "indonesia-logistics": {
      "type": "http",
      "url": "https://logi-id.wishpool.app/mcp",
      "headers": {
        "x-biteship-key": "biteship_live_your_api_key"
      }
    }
  }
}

No shared demo — use your own Biteship account. Get an API key in the Biteship dashboard at dashboard.biteship.com (Settings → API Key) and send it in the header above. The server is stateless: on every call it sends the key as the Authorization header directly to api.biteship.com and stores nothing. A biteship_test_ key runs in the sandbox; a biteship_live_ key ships real parcels and debits your Biteship balance.

Tools

Tool	What it does
`check_rates`	Call this first (cek ongkir). Given `items` (`name`/`value` IDR/`weight` grams/`quantity`) plus an origin (`origin_postal_code` or `origin_area_id`) and a destination, returns every available courier service (JNE, J&T, SiCepat, AnterAja, Gojek, Grab…) with its `price` (IDR), `duration` and service type, and flags the cheapest. Read-only — quotes only, spends nothing.
`create_shipment`	Create a Biteship order. Origin (pickup) + destination (recipient) contact/address + one location id each, `items`, and `courier_company` (`courier_code`) + `courier_type` (`courier_service_code`) from `check_rates`. Returns `order_id`, `status`, `tracking_id`, `waybill_id`, `price` (IDR). `delivery_type` defaults to `now`. A `biteship_live_` key debits your Biteship balance.
`query_tracking`	Track by `tracking_id` (preferred), `order_id`, or `waybill_id` + `courier_code`. Returns `status` from the Biteship set — `confirmed` / `allocated` / `picking_up` / `picked` / `dropping_off` / `delivered` / `on_hold` / `returned` / `cancelled` — plus a plain-English hint; non-terminal statuses carry `next_steps`. Raw response always included.
`cancel_shipment`	Cancel a Biteship order by its `order_id` (+ `cancellation_reason`). Only works before pickup.

Owner policy guardrails ride optional headers (x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools) — set by the human owner in client config; the agent cannot relax them. The order value (IDR) is gated before the order is created: approval-above returns an unsigned draft with no order created.

Units

Weight in grams (g), parcel dimensions in centimetres (cm), money in IDR.

Develop

bash

node test/serve.js   # local server on :3251 (/mcp)
node test/e2e.js     # protocol + validation + policy/biteship units + fake-key live probe to api.biteship.com (expects native Biteship auth error)

How it talks to Biteship

Every tool call is a single server-to-server request with Authorization: <your key> (no login step — Biteship is single-key). check_rates is POST /v1/rates/couriers. create_shipment is POST /v1/orders. query_tracking is GET /v1/trackings/{tracking_id} (or GET /v1/orders/{order_id}, or public GET /v1/trackings/{waybill_id}/couriers/{courier_code}). cancel_shipment is POST /v1/orders/{order_id}/cancel. Base URL https://api.biteship.com/v1.

Safety

Pure stateless translation layer. Orders, labels and tracking are held by Biteship and the couriers; the API key travels per-request in a header, is forwarded as the Authorization header, and nothing is stored. Parcels flow sender ↔ courier ↔ recipient directly. Privacy policy.

Sister servers

India labels (Delhivery/Bluedart/Ekart) via Shiprocket live in india-logistics-mcp; USA labels (USPS/UPS/FedEx) via EasyPost in usa-logistics-mcp; Taiwan CVS pickup + home delivery in taiwan-logistics-mcp. One family of stateless BYO local-commerce MCP servers: local payments in 81 countries at mcp.wishpool.app, plus electronic-invoice servers across nine countries including India GST, Mexico CFDI, Brazil NF-e, Chile DTE and Peru CPE.

MIT licensed.

Install

Tools (4)

check_ratescreate_shipmentquery_trackingcancel_shipment

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://logi-id.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "indonesia-logistics-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://logi-id.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.