# GHTK MCP by usefulapi

> GHTK MCP by usefulapi is an MCP server. Quote fees, check addresses and order status, and create or cancel shipping orders in GHTK. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/ghtk/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/ghtk
- **MCP Registry name:** io.usefulapi/ghtk
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://ghtk.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ghtk": {
      "url": "https://ghtk.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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}.

## 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

---
Source: https://ai-powered.com/mcp/ghtk-mcp-by-usefulapi
