GHTK MCP by usefulapi is an MCP server published by io.usefulapi, hosted at ghtk.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 8 tools, including ghtk_list_pickup_addresses, ghtk_find_address, ghtk_calculate_shipping_fee, ghtk_search_products, ghtk_list_solutions.
Quote fees, check addresses and order status, and create or cancel shipping orders in GHTK.
4,099 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
No parameters.
{
"name": "ghtk_list_pickup_addresses",
"title": "List pickup addresses",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List pickup addresses",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
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.
| Parameter | Type | Description |
|---|---|---|
| address | string | Full level-4 address text, for example "Đội Cấn". |
| district * | string | District name, for example "Ba Đình". |
| province * | string | Province or city name, for example "Hà Nội". |
| ward_street * | string | Ward or street name. |
{
"name": "ghtk_find_address",
"title": "Look up a level-4 address",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"province",
"district",
"ward_street"
],
"properties": {
"address": {
"type": "string",
"description": "Full level-4 address text, for example \"Đội Cấn\"."
},
"district": {
"type": "string",
"minLength": 1,
"description": "District name, for example \"Ba Đình\"."
},
"province": {
"type": "string",
"minLength": 1,
"description": "Province or city name, for example \"Hà Nội\"."
},
"ward_street": {
"type": "string",
"minLength": 1,
"description": "Ward or street name."
}
}
},
"annotations": {
"title": "Look up a level-4 address",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| ward | string | Delivery ward. |
| value | integer | Declared value in VND, the base for the insurance fee. |
| address | string | Delivery address text. |
| district * | string | Delivery district. |
| province * | string | Delivery province or city. |
| pick_ward | string | Pickup ward. |
| transport | string | Shipping method: road (by land) or fly (by air). If omitted, GHTK uses its default. |
| pick_address | string | Short pickup address. |
| weight_grams * | integer | Total weight of all items in grams (not kilograms). |
| pick_district * | string | Pickup district. |
| pick_province * | string | Pickup province or city. |
{
"name": "ghtk_calculate_shipping_fee",
"title": "Calculate a shipping fee",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"pick_province",
"pick_district",
"province",
"district",
"weight_grams"
],
"properties": {
"ward": {
"type": "string",
"description": "Delivery ward."
},
"value": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Declared value in VND, the base for the insurance fee."
},
"address": {
"type": "string",
"description": "Delivery address text."
},
"district": {
"type": "string",
"minLength": 1,
"description": "Delivery district."
},
"province": {
"type": "string",
"minLength": 1,
"description": "Delivery province or city."
},
"pick_ward": {
"type": "string",
"description": "Pickup ward."
},
"transport": {
"enum": [
"road",
"fly"
],
"type": "string",
"description": "Shipping method: road (by land) or fly (by air). If omitted, GHTK uses its default."
},
"pick_address": {
"type": "string",
"description": "Short pickup address."
},
"weight_grams": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Total weight of all items in grams (not kilograms).",
"exclusiveMinimum": 0
},
"pick_district": {
"type": "string",
"minLength": 1,
"description": "Pickup district."
},
"pick_province": {
"type": "string",
"minLength": 1,
"description": "Pickup province or city."
}
}
},
"annotations": {
"title": "Calculate a shipping fee",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| term * | string | Product name or keyword, for example "laptop". |
{
"name": "ghtk_search_products",
"title": "Search warehouse products",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"term"
],
"properties": {
"term": {
"type": "string",
"minLength": 1,
"description": "Product name or keyword, for example \"laptop\"."
}
}
},
"annotations": {
"title": "Search warehouse products",
"readOnlyHint": true
}
}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.
No parameters.
{
"name": "ghtk_list_solutions",
"title": "List GHTK solutions",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List GHTK solutions",
"readOnlyHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | The GHTK label or your own order code (order_id sent at creation). |
{
"name": "ghtk_get_order_status",
"title": "Get order status",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"description": "The GHTK label or your own order code (order_id sent at creation)."
}
}
},
"annotations": {
"title": "Get order status",
"readOnlyHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| tel * | string | Recipient phone number. |
| name * | string | Recipient full name. |
| note | string | Order note, up to 120 characters. |
| ward * | string | Recipient ward. |
| string | Recipient email address. | |
| value * | integer | Declared value in VND. The base for the insurance fee and compensation. |
| hamlet | string | Recipient hamlet, village or cluster. Give this or street; "Other" if neither applies. |
| street | string | Recipient street. Give this or hamlet. |
| address * | string | Recipient detailed address. |
| district * | string | Recipient district. |
| order_id * | string | Your own order code. GHTK refuses an order_id it already has. |
| pick_tel * | string | Pickup contact phone number. |
| products * | array | Items in the order. Weights are in kilograms. |
| province * | string | Recipient province or city. |
| pick_name * | string | Pickup contact name. |
| pick_ward | string | Pickup ward. |
| transport | string | Shipping method: road (by land) or fly (by air). If omitted, GHTK uses its default. |
| pick_money * | integer | Cash on delivery (COD) amount the courier collects, in VND. 0 = no COD. |
| is_freeship | any | 1 = recipient pays only the COD amount; 0 = recipient pays COD plus the shipping fee (default 0). |
| pick_address * | string | Short pickup address (house number, street). |
| pick_district * | string | Pickup district. |
| pick_province * | string | Pickup province or city. |
| pick_address_id | string | Pickup address id from ghtk_list_pickup_addresses. If set, GHTK uses it before the pickup fields. |
{
"name": "ghtk_create_order",
"title": "Create a shipping order",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"products",
"pick_name",
"pick_address",
"pick_province",
"pick_district",
"pick_tel",
"name",
"address",
"province",
"district",
"ward",
"tel",
"pick_money",
"value"
],
"properties": {
"tel": {
"type": "string",
"minLength": 1,
"description": "Recipient phone number."
},
"name": {
"type": "string",
"minLength": 1,
"description": "Recipient full name."
},
"note": {
"type": "string",
"maxLength": 120,
"description": "Order note, up to 120 characters."
},
"ward": {
"type": "string",
"minLength": 1,
"description": "Recipient ward."
},
"email": {
"type": "string",
"description": "Recipient email address."
},
"value": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Declared value in VND. The base for the insurance fee and compensation."
},
"hamlet": {
"type": "string",
"description": "Recipient hamlet, village or cluster. Give this or street; \"Other\" if neither applies."
},
"street": {
"type": "string",
"description": "Recipient street. Give this or hamlet."
},
"address": {
"type": "string",
"minLength": 1,
"description": "Recipient detailed address."
},
"district": {
"type": "string",
"minLength": 1,
"description": "Recipient district."
},
"order_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Your own order code. GHTK refuses an order_id it already has."
},
"pick_tel": {
"type": "string",
"minLength": 1,
"description": "Pickup contact phone number."
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"weight"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Product name."
},
"price": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Unit price in VND."
},
"weight": {
"type": "number",
"description": "Weight in kilograms.",
"exclusiveMinimum": 0
},
"quantity": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Quantity (default 1).",
"exclusiveMinimum": 0
},
"product_code": {
"type": "string",
"description": "Product code from ghtk_search_products, if the product has one."
}
}
},
"minItems": 1,
"description": "Items in the order. Weights are in kilograms."
},
"province": {
"type": "string",
"minLength": 1,
"description": "Recipient province or city."
},
"pick_name": {
"type": "string",
"minLength": 1,
"description": "Pickup contact name."
},
"pick_ward": {
"type": "string",
"description": "Pickup ward."
},
"transport": {
"enum": [
"road",
"fly"
],
"type": "string",
"description": "Shipping method: road (by land) or fly (by air). If omitted, GHTK uses its default."
},
"pick_money": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Cash on delivery (COD) amount the courier collects, in VND. 0 = no COD."
},
"is_freeship": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
],
"description": "1 = recipient pays only the COD amount; 0 = recipient pays COD plus the shipping fee (default 0)."
},
"pick_address": {
"type": "string",
"minLength": 1,
"description": "Short pickup address (house number, street)."
},
"pick_district": {
"type": "string",
"minLength": 1,
"description": "Pickup district."
},
"pick_province": {
"type": "string",
"minLength": 1,
"description": "Pickup province or city."
},
"pick_address_id": {
"type": "string",
"description": "Pickup address id from ghtk_list_pickup_addresses. If set, GHTK uses it before the pickup fields."
}
}
},
"annotations": {
"title": "Create a shipping order",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| id_type | string | What order_id holds: ghtk_label (default) or partner_order_id (your own order code). |
| order_id * | string | The GHTK label (for example S1.A1.17373471) or your own order code. |
{
"name": "ghtk_cancel_order",
"title": "Cancel a shipping order",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"id_type": {
"enum": [
"ghtk_label",
"partner_order_id"
],
"type": "string",
"description": "What order_id holds: ghtk_label (default) or partner_order_id (your own order code)."
},
"order_id": {
"type": "string",
"minLength": 1,
"description": "The GHTK label (for example S1.A1.17373471) or your own order code."
}
}
},
"annotations": {
"title": "Cancel a shipping order",
"destructiveHint": true
}
}Tools for GHTK, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "What is the status of GHTK order a4 for my shop?"; "How much does it cost to ship a 2 kg parcel from Hà Nội to Đà Nẵng by road?"; "List my pickup addresses and the solutions my shop can attach to an order.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes GHTK data. Free plan: 50 tool calls per month. Run ghtk_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run ghtk_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run ghtk_upgrade without a plan: it returns both plans, each with a payment link for the user to open. ghtk_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.