io.usefulapi/ghn

up checked 2026-11-10T23:37:55.881Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

GHN MCP by usefulapi

Publisher-provided description

Quote shipping fees, track orders, and create or cancel shipping orders in GHN.

Summary by lookupd

Quotes shipping fees, looks up GHN orders and master data, and creates or cancels real shipping orders for delivery and cash on delivery.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http ghn https://ghn.usefulapi.io/mcp

Codex, remote (streamable-http)

codex mcp add ghn --url https://ghn.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "ghn": {
      "url": "https://ghn.usefulapi.io/mcp"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (9 tools)

Publisher-provided text

• 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/di
• 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
• 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?cli
• 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 afte
• 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 o

Details

• Version: 1.1.3
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 409 ms
• First indexed: 2026-11-07T20:17:14.247Z
• Last seen in registry: 2026-11-11T00:17:26.565Z
• Repository: https://github.com/m190/usefulapi-mcp
• Website: https://usefulapi.io/ghn/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/ghn.svg)](https://lookupd.com/servers/io.usefulapi/ghn)

• 62071 servers
• Last crawl: 2026-11-11T16:39:06.253Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp