# GHN MCP by usefulapi

> GHN MCP by usefulapi is a freemium MCP server for freight and logistics. Hosted MCP server to quote, track, create and cancel GHN shipping orders from AI clients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/ghn/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/ghn
- **MCP Registry name:** io.usefulapi/ghn
- **Categories:** freight and logistics
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

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

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

- [ImportYeti Scraper (Apify) - US import records and bills of lading](https://ai-powered.com/mcp/importyeti-scraper-apify-us-import-records-and-bills-of-ladi): ImportYeti Scraper (Apify) - US import records and bills of lading is a paid MCP server for web search and scraping.
- [Lane Cost freight rates](https://ai-powered.com/mcp/lane-cost-freight-rates): Lane Cost freight rates is a free MCP server for freight and logistics.
- [Zentria Flow](https://ai-powered.com/mcp/zentria-flow): Zentria Flow is a freemium MCP server for freight and logistics.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Cofinal](https://ai-powered.com/mcp/cofinal): Cofinal is a paid MCP server for freight and logistics.
- [X3 Compliance](https://ai-powered.com/mcp/x3-compliance): X3 Compliance is a free MCP server for security.
- [RouteMetrics](https://ai-powered.com/mcp/routemetrics): RouteMetrics is a freemium MCP server for maps and travel.
- [Argo Hub Peso Volumétrico](https://ai-powered.com/mcp/argo-hub-peso-volumetrico): Argo Hub Peso Volumétrico is a free MCP server for freight and logistics.

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