PostEx MCP Server

MCP server providing tools to interact with the PostEx Merchant API for order management, tracking, and other logistics operations.

Local serverstdio

What is the PostEx MCP Server?

MCP server providing tools to interact with the PostEx Merchant API for order management, tracking, and other logistics operations.

What it actually does

This project implements a Model Context Protocol (MCP) server that provides tools for interacting with various endpoints of the PostEx Merchant API (v4.1.9).

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
getOperationalCitiesGet a list of cities where PostEx operates.
getMerchantAddressGet the merchant's registered pickup addresses.
createMerchantAddressCreate a new pickup address for the merchant.
getOrderTypesGet the types of orders supported (e.g., "Normal", "Reverse").
createOrderCreate a new order in the PostEx system.
getUnbookedOrdersList orders created but not yet booked for pickup within a date range.
trackOrderTrack a single order using its tracking number.
trackBulkOrderTrack multiple orders using a list of tracking numbers. (Note: API docs specify GET but require a body; implementation uses GET as per latest code change, which might not work as expected with a body).
saveShipperAdviceProvide advice (e.g., retry, return) for an attempted parcel.
getShipperAdviceRetrieve shipper advice history for a tracking number.
cancelOrderCancel an order using its tracking number. (Note: Implemented as PUT with a JSON body).
getPaymentStatusCheck the payment settlement status for an order.
getOrderStatusGet a list of all possible order statuses.
listOrdersList orders within a date range, optionally filtered by status ID.

Configuration

  • Node.js (LTS version recommended) * npm or yarn * A valid PostEx Merchant API Token

Example prompts to try

  • “Use PostEx to getOperationalCities.”
  • “Use PostEx to getMerchantAddress.”
  • “Use PostEx to createMerchantAddress.”

Frequently asked questions

Node.js (LTS recommended) and npm/yarn. Dependencies include `@modelcontextprotocol/sdk`, `zod`, and `node-fetch@2`.