Skip to content
MCP server

GHN MCP by usefulapi

Hosted MCP server to quote, track, create and cancel GHN shipping orders from AI clients

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://ghn.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ghn": {
      "url": "https://ghn.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": {
    "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.

How AIPoweredBot checks servers

Alternatives to GHN MCP by usefulapi

  1. Free US truckload rate estimates for any lane, 8 truck types, history from 2003

    • 13 tools
    • Remote
    • Free
    • Freight and logistics
  2. Zentria Flow

    MCP server

    US tariff layers by HTS code and origin, origin comparison and landed cost for importers

    Runs locally
    • 4 tools
    • Freemium
    • Freight and logistics
  3. Gangway AIS

    MCP server

    Vessel positions, port calls and anchorage waiting times from licensed AIS data

    • 21 tools
    • Remote
    • Freemium
    • Freight and logistics
  4. Cofinal

    MCP server

    Check orders, stock, inbound shipments, returns and invoices at a Danish warehouse

    • Remote
    • Paid
    • Freight and logistics
  5. X3 Compliance

    MCP server

    Regulation-citing tools for trucking, OSHA, 811 dig times, eCFR and Coast Guard records

    • 20 tools
    • Remote
    • Free
    • Security