io.usefulapi/ghn · v1.0.1 · ecommerce
GHN MCP by usefulapi is healthy: it completed an MCP handshake in 379 ms and exposes 9 tools.
Quote shipping fees, track orders, and create or cancel shipping orders in GHN.
Endpoint: https://ghn.usefulapi.io/mcp (streamable-http)
Repository · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 9 |
| Latency | 379 ms |
| Last checked (UTC) | 2026-11-07T21:50:26.209Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-11-07T21:50:26.209Z | Healthy | 379 |
ghn_list_provinces | List all provinces and cities with their ProvinceID. Use the ProvinceID with ghn_list_districts. Uses the district address model. GHN: GET /master-data/province. |
ghn_list_districts | List the districts of one province with DistrictID and service support (SupportType: 0 locked, 1 pickup only, 2 delivery only, 3 both). GHN: GET /master-data/district?province_id=. |
ghn_list_wards | List the wards of one district. Use WardCode (a string) for ghn_calculate_fee and ghn_create_order ward fields. GHN: GET /master-data/ward?district_id=. |
ghn_list_services | List the delivery services GHN offers on a route for this shop. Returns service_type_id (2 = under 20 kg, 5 = 20 kg or more or multi-parcel). Call it before ghn_calculate_fee. GHN: POST /v2/shipping-order/available-services. |
ghn_calculate_fee | Quote the shipping fee for a parcel to a ward, before creating an order. Quote only: no order is created. GHN: POST /v2/shipping-order/fee. |
ghn_get_order | Get the full details of one shipping order by its GHN tracking code: status, parties, COD, fees and items. GHN: GET /v2/shipping-order/detail?order_code=. |
ghn_get_order_by_client_code | Get the full details of one shipping order by your own client_order_code instead of the GHN tracking code. GHN: GET /v2/shipping-order/detail-by-client-code?client_order_code=. |
ghn_create_order | CREATES A REAL SHIPPING ORDER: GHN picks up and delivers the parcel and can charge the shop or collect cash on delivery (COD) from the recipient. Call only after the user explicitly confirms the recipient, the parcel and the fee in this chat (use ghn_calculate_fee first). client_order_code is requir |
ghn_cancel_orders | CANCELS REAL SHIPPING ORDERS. The batch is all-or-nothing: one unknown or foreign order code cancels nothing. Call only after the user explicitly confirms the order codes. An order that can no longer be cancelled returns result false. GHN: POST /v2/switch-status/cancel. |