# Indonesia Logistics MCP

> A remote MCP server that lets any AI agent ship parcels across Indonesia — via Biteship, over JNE, J&T, SiCepat, AnterAja, Ninja, Pos Indonesia, Lion Parcel, Gojek and Grab. 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.

- MCP endpoint (Streamable HTTP): https://logi-id.wishpool.app/mcp
- Credential header: x-biteship-key (your Biteship API key — get one at https://dashboard.biteship.com : Settings -> API Key). No shared demo key. Stateless: every call sends the key as the Authorization header directly to https://api.biteship.com/v1, then stores nothing. A biteship_test_ key runs in the sandbox; a biteship_live_ key ships real parcels and debits your Biteship balance.
- Units: weight in GRAMS (g), parcel dimensions in CENTIMETRES (cm), money in IDR.
- Flow: check_rates (origin + destination by postal_code or area_id + items -> available couriers with fees + duration, cheapest flagged) -> create_shipment (origin/destination contact + address + items + courier_company + courier_type -> order id + waybill_id) -> query_tracking (by tracking_id / order_id / waybill+courier). cancel_shipment cancels an order before pickup.

## Tools

- check_rates: THE tool to call first (cek ongkir). Required: items (array of { name, value IDR, weight GRAMS, quantity }) plus an origin (origin_postal_code OR origin_area_id) and a destination (destination_postal_code OR destination_area_id). Optional: couriers (comma-separated courier codes). Returns every available courier service (courier_code, courier_name, courier_service_code, courier_service_name, price IDR, duration), the cheapest, and serviceable=true/false. Read-only, spends nothing.
- create_shipment: Create a Biteship order. Required: origin_contact_name, origin_contact_phone, origin_address, an origin location (postal_code OR area_id); destination_contact_name, destination_contact_phone, destination_address, a destination location; courier_company (courier_code) + courier_type (courier_service_code); items (array of { name, value IDR, weight GRAMS, quantity }). Optional: shipper_contact_name, notes, delivery_type (now|scheduled) + delivery_date/time, reference_id, destination_cash_on_delivery (IDR), courier_insurance (IDR). Returns order id, status, tracking_id, waybill_id, price (IDR). A biteship_live_ key debits your Biteship balance.
- query_tracking: Track by tracking_id (preferred), order_id, or waybill_id + courier_code. Status enum (Biteship): confirmed, scheduled, allocated, picking_up, picked, dropping_off, delivered, on_hold, courier_not_found, return_in_transit, returned, rejected, disposed, cancelled — each with a plain-English hint; non-terminal statuses include next_steps. Raw response (history scans, courier, link) always included. A brand-new order may show confirmed with no waybill until a courier is allocated.
- cancel_shipment: Cancel a Biteship order by its order_id, with a cancellation_reason. Only works before pickup; an already-picked-up order cannot be cancelled here.
- Owner policy guardrails: x-agentpay-max-amount (hard cap on order value IDR), x-agentpay-approval-above (returns an unsigned draft for human review — no order is created), x-agentpay-allowed-tools (tool allow-list) — set by the human owner in the MCP client config; the agent cannot relax them. The order value (sum of item value x quantity, IDR) is gated before creation.

## Safety

Stateless translation layer. The Biteship API key travels per-request in a header, is forwarded to Biteship as the Authorization header, and is never stored; orders, labels and tracking are held by Biteship and the couriers, never here. Parcels flow sender <-> courier <-> recipient directly. Privacy policy: https://logi-id.wishpool.app/privacy

## Sister servers

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