MCP server
GHTK MCP by usefulapi
Quote fees, check addresses and order status, and create or cancel shipping orders in…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://ghtk.usefulapi.io/mcpInstall 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