Skip to content
MCP server

GHTK MCP by usefulapi

Quote fees, check addresses and order status, and create or cancel shipping orders in…

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About GHTK MCP by usefulapi

GHTK MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Quote fees, check addresses and order status, and create or cancel shipping orders in GHTK.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://ghtk.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ghtk": {
      "url": "https://ghtk.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ghtk": {
      "type": "http",
      "url": "https://ghtk.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ghtk": {
      "serverUrl": "https://ghtk.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ghtk": {
      "type": "http",
      "url": "https://ghtk.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (8)

Read directly from the server.

ghtk_list_pickup_addresses
List the pickup addresses saved in the shop, with their ids. Use an id as pick_address_id in ghtk_create_order. Token permission: not named in the GHTK docs; the token needs access to this call. Open API: GET /services/shipment/list_pick_add.
ghtk_find_address
Check a delivery address against GHTK's address data (province, district, ward or street). Use it before ghtk_create_order to get the exact spelling GHTK expects. Token permission: not named in the GHTK docs; the token needs access to this call. Open API: GET /services/address/getAddressLevel4.
ghtk_calculate_shipping_fee
Get the shipping fee and insurance fee for a route and weight, before an order is created. Token permission: Calculate order fees. Open API: GET /services/shipment/fee.
ghtk_search_products
Search the shop's product list by name. Returns product codes you can pass as product_code in ghtk_create_order. Token permission: not named in the GHTK docs; the token needs access to this call. Open API: GET /services/kho-hang/thong-tin-san-pham.
ghtk_list_solutions
List the GHTK solutions (service add-ons) the shop can attach to an order, with their solution_id values. Token permission: not named in the GHTK docs; the token needs access to this call. Open API: GET /open/api/v1/shop/solution/list.
ghtk_get_order_status
Get the status, fees, pickup and delivery dates, and COD amount of one order. Pass the GHTK label (for example S1.A1.17373471) or your own order code. Token permission: Get order status. Open API: GET /services/shipment/v2/{TRACKING_ORDER}.
ghtk_create_order
Create a real GHTK shipping order: GHTK schedules a pickup and charges the shipping fee. Re-sending the same order_id is refused by GHTK, so it does not create a second order. Give street or hamlet (use "Other" for hamlet when neither applies). Token permission: Create order. Open API: POST /services/shipment/order (JSON).
ghtk_cancel_order
Cancel an order that GHTK has not picked up yet. GHTK refuses a cancel after pickup. Pass the GHTK label, or set id_type to partner_order_id to pass your own order code. Token permission: not named in the GHTK docs; the token needs access to order cancellation. Open API: POST /services/shipment/cancel/{TRACKING_ORDER}.

GHTK MCP by usefulapi FAQ

How do I add GHTK MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http ghtk https://ghtk.usefulapi.io/mcp