GHN MCP by usefulapi
Hosted MCP server to quote, track, create and cancel GHN shipping orders from AI clients
- Pricing
- Freemium
- Platforms
- API, Web
- Runs
- Remotely
- Version
- 1.4.1
- Listing updated
- today
About GHN MCP by usefulapi
GHN MCP by usefulapi is a freemium MCP server for freight and logistics. It runs as a hosted remote server, so there is nothing to install locally.
The server connects an AI assistant to a GHN shipping account, so a shop owner can ask for fee quotes, look up parcels by GHN tracking code or their own order code, and create or cancel orders in plain language. The README describes it as a hosted endpoint, so there is nothing to install locally; the user signs in once with their GHN Token API value and ShopId.
The tool set has 13 entries. Seven are read-only, covering province, district and ward lookups, service types, fee calculation and order retrieval. Two write tools create cash-on-delivery orders and cancel orders in batches; the README notes that clients should ask for confirmation before running them, and that a batch cancel is all-or-nothing. The remaining four handle usage status, feature requests and Pro or Pro+ subscriptions.
It suits online sellers who ship with GHN and already use Claude, ChatGPT, Cursor or VS Code. The vendor states it is independent of GHN and not endorsed by GHN.
Install
Run in a terminal
claude mcp add --transport http ghn https://ghn.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://ghn.usefulapi.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"ghn": {
"url": "https://ghn.usefulapi.io/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ghn": {
"type": "http",
"url": "https://ghn.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ghn": {
"serverUrl": "https://ghn.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ghn": {
"type": "http",
"url": "https://ghn.usefulapi.io/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (13)
Taken from the project documentation; the running server may differ.
- ghn_list_provinces
- List all provinces and cities with their ProvinceID.
- ghn_list_districts
- List the districts of one province with DistrictID and service support.
- ghn_list_wards
- List the wards of one district.
- ghn_list_services
- List the delivery services GHN offers on a route for this shop.
- ghn_calculate_fee
- Quote the shipping fee for a parcel to a ward, without creating an order.
- ghn_get_order
- Get the full details of one shipping order by its GHN tracking code.
- ghn_get_order_by_client_code
- Get the full details of one shipping order by the client's own order code.
- ghn_create_order
- Create a real shipping order, optionally with cash on delivery.
- ghn_cancel_orders
- Cancel shipping orders in an all-or-nothing batch.
- ghn_usage_status
- Report the caller's current usage and plan limits.
- ghn_request_feature
- Send a request to usefulapi for a capability the tools cannot provide yet.
- ghn_upgrade
- Get a Pro or Pro+ payment link or change an existing Pro subscription to Pro+.
- ghn_cancel_subscription
- Cancel the Pro subscription at the end of the paid period.
What it does
- Shipping fee quotes
- Calculates the fee for a parcel to a ward before any order is created.
- Order lookup
- Retrieves order details by GHN tracking code or by the shop's own client order code.
- Cash-on-delivery orders
- Creates shipping orders that can collect cash on delivery from the recipient.
- Batch order cancellation
- Cancels several shipping orders at once, failing as a whole if any code is unknown.
- Location and service lookup
- Lists provinces, districts, wards and delivery services available on a route.
- OAuth login with GHN credentials
- Signs in with the GHN Token API value and ShopId so no API key goes into client config files.
Good for
- Quote a shipping fee for a customer's parcel before confirming checkout
- Check the delivery status of an order using the shop's own order code
- Create a cash-on-delivery shipment after the customer approves the details
- Cancel a batch of unshipped orders after reviewing their codes
Pricing
Freemium, from $9 a month
Free plan with 50 tool calls/month; Pro $9/mo or $90/yr; Pro+ $39/mo or $390/yr
Prices change. Check usefulapi.io before you buy.
GHN MCP by usefulapi FAQ
Is this an official GHN product?
No. The website says usefulapi is an independent service and is not affiliated with or endorsed by GHN.
Do I need to install anything locally?
No. The README describes it as a hosted endpoint, connected by adding the server URL to an MCP client.
What credentials are needed to connect?
The login page asks for a GHN Token API value and a GHN ShopId. The website says the Token is revealed in the GHN Developer Portal with an OTP sent to the phone.
Can the AI change order data?
Yes, through two write tools that create and cancel shipping orders. The website says most MCP clients ask for approval before a tool call runs.
Is GHN MCP by usefulapi free?
GHN MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.
How do I add GHN MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http ghn https://ghn.usefulapi.io/mcp
What are the best alternatives to GHN MCP by usefulapi?
The closest alternatives to GHN MCP by usefulapi are ImportYeti Scraper (Apify) - US import records and bills of lading, Lane Cost freight rates, Zentria Flow, Gangway AIS and Cofinal.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
Alternatives to GHN MCP by usefulapi

ImportYeti US import records and company profiles as JSON, billed per row
- Remote
- Paid
- Web search and scraping
Lane Cost freight rates
MCP serverFree US truckload rate estimates for any lane, 8 truck types, history from 2003
- 13 tools
- Remote
- Free
- Freight and logistics

Zentria Flow
MCP serverUS tariff layers by HTS code and origin, origin comparison and landed cost for importers
Runs locally- 4 tools
- Freemium
- Freight and logistics

Gangway AIS
MCP serverVessel positions, port calls and anchorage waiting times from licensed AIS data
- 21 tools
- Remote
- Freemium
- Freight and logistics

Cofinal
MCP serverCheck orders, stock, inbound shipments, returns and invoices at a Danish warehouse
- Remote
- Paid
- Freight and logistics
X3 Compliance
MCP serverRegulation-citing tools for trucking, OSHA, 811 dig times, eCFR and Coast Guard records
- 20 tools
- Remote
- Free
- Security