PostEx MCP Server

Name: PostEx MCP Server
Author: faizan45640

@faizan45640

About PostEx MCP Server

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

#postex #mcp-server #api-tools

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "PostEx-MCP-Server": {
      "command": "node",
      "args": [
        "index.js",
        "<YOUR_POSTEX_API_TOKEN>"
      ]
    }
  }
}

Tools

Get a list of cities where PostEx operates.

Get the merchant's registered pickup addresses.

Create a new pickup address for the merchant.

Get the types of orders supported (e.g., "Normal", "Reverse").

Create a new order in the PostEx system.

List orders created but not yet booked for pickup within a date range.

Track a single order using its tracking number.

Track 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).

Provide advice (e.g., retry, return) for an attempted parcel.

Retrieve shipper advice history for a tracking number.

Cancel an order using its tracking number. (Note: Implemented as PUT with a JSON body).

Check the payment settlement status for an order.

Get a list of all possible order statuses.

List orders within a date range, optionally filtered by status ID.

Overview

What is PostEx MCP Server?

An MCP server that provides tools for interacting with various endpoints of the PostEx Merchant API (v4.1.9). It is intended for developers who need to manage PostEx orders, addresses, tracking, and related operations through a standardized protocol.

How to use PostEx MCP Server?

Install dependencies (@modelcontextprotocol/sdk, zod, node-fetch@2), then run the server with Node.js, passing your PostEx API token as a command-line argument: node index.js <YOUR_POSTEX_API_TOKEN>. The server connects via standard I/O and listens for MCP requests.