china_postal_stats
Pack: china-macro · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/china_postal_stats for the schema, then POST the same URL with its arguments for the data.
China postal/express revenue and volume, cumulative and monthly, with YoY and release link.
Tool description as the model sees it
China postal and express-delivery industry statistics from the State Post Bureau (\u56fd\u5bb6\u90ae\u653f\u5c40 \u90ae\u653f\u884c\u4e1a\u8fd0\u884c\u60c5\u51b5): postal industry revenue, express revenue (\u5feb\u9012\u4e1a\u52a1\u6536\u5165), express volume (\u5feb\u9012\u4e1a\u52a1\u91cf) and the same-city / inter-city / international split, each as cumulative January-to-month and single-month figures with year-on-year growth exactly as published, plus the release title, date and link. Answers “China express volume Jan-Sep 2026”, “\u5feb\u9012\u4e1a\u52a1\u91cf 9\u6708 \u540c\u6bd4”, “SF Holding industry express revenue YoY”, “\u90ae\u653f\u884c\u4e1a\u4e1a\u52a1\u6536\u5165 \u7d2f\u8ba1”. Units are 100 million CNY (\u4ebf\u5143) and 100 million items (\u4ebf\u4ef6). Give year and month (the release for that month); year alone returns the latest release of that year; no arguments returns the latest release. A month with no release returns found:false plainly with the releases that do exist; nothing is estimated. Source: State Post Bureau of China, postal industry operating statistics.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
year | number | no | Calendar year, e.g. 2026. Omit for the latest release. |
month | number | no | Month 1-12 (the end month of the cumulative window), e.g. 9 for the January-September release. Needs year. |
Example call
Arguments
{
"year": 2026,
"month": 9
}curl
curl -X POST https://gateway.pipeworx.io/china-macro/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"china_postal_stats","arguments":{"year":2026,"month":9}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('china_postal_stats', {
"year": 2026,
"month": 9
});Response shape
| Field | Type | Description |
|---|---|---|
found | boolean | |
year | number | null | x |
month | number | null | x |
period | object | |
data_as_of | string | YYYY-MM |
release | object | |
figures | unknown | null when the release table could not be read |
available_releases | array | Releases that exist (found:false) |
message | string | Explanation (found:false or figures:null) |
field_notes | object | |
source | string | Publisher and dataset |
Full JSON Schema
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"year": {
"type": [
"number",
"null"
],
"description": "x"
},
"month": {
"type": [
"number",
"null"
],
"description": "x"
},
"period": {
"type": "object",
"properties": {
"year": {
"type": "number"
},
"month": {
"type": "number"
},
"cumulative_window": {
"type": "string",
"description": "x"
}
},
"additionalProperties": true
},
"data_as_of": {
"type": "string",
"description": "YYYY-MM"
},
"release": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "x"
},
"published": {
"type": [
"string",
"null"
],
"description": "x"
},
"url": {
"type": "string",
"description": "x"
}
},
"additionalProperties": true
},
"figures": {
"anyOf": [
{
"type": "object",
"properties": {
"postal_revenue": {
"type": "object",
"properties": {
"unit": {
"type": "string",
"description": "Unit"
},
"cumulative": {
"type": [
"number",
"null"
],
"description": "January-to-month figure"
},
"month": {
"type": [
"number",
"null"
],
"description": "Single-month figure"
},
"cumulative_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Cumulative YoY percent"
},
"month_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Month YoY percent"
}
},
"additionalProperties": true
},
"express_revenue": {
"type": "object",
"properties": {
"unit": {
"type": "string",
"description": "Unit"
},
"cumulative": {
"type": [
"number",
"null"
],
"description": "January-to-month figure"
},
"month": {
"type": [
"number",
"null"
],
"description": "Single-month figure"
},
"cumulative_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Cumulative YoY percent"
},
"month_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Month YoY percent"
}
},
"additionalProperties": true
},
"postal_parcel_volume": {
"type": "object",
"properties": {
"unit": {
"type": "string",
"description": "Unit"
},
"cumulative": {
"type": [
"number",
"null"
],
"description": "January-to-month figure"
},
"month": {
"type": [
"number",
"null"
],
"description": "Single-month figure"
},
"cumulative_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Cumulative YoY percent"
},
"month_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Month YoY percent"
}
},
"additionalProperties": true
},
"express_volume": {
"type": "object",
"properties": {
"unit": {
"type": "string",
"description": "Unit"
},
"cumulative": {
"type": [
"number",
"null"
],
"description": "January-to-month figure"
},
"month": {
"type": [
"number",
"null"
],
"description": "Single-month figure"
},
"cumulative_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Cumulative YoY percent"
},
"month_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Month YoY percent"
}
},
"additionalProperties": true
},
"express_volume_same_city": {
"type": "object",
"properties": {
"unit": {
"type": "string",
"description": "Unit"
},
"cumulative": {
"type": [
"number",
"null"
],
"description": "January-to-month figure"
},
"month": {
"type": [
"number",
"null"
],
"description": "Single-month figure"
},
"cumulative_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Cumulative YoY percent"
},
"month_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Month YoY percent"
}
},
"additionalProperties": true
},
"express_volume_inter_city": {
"type": "object",
"properties": {
"unit": {
"type": "string",
"description": "Unit"
},
"cumulative": {
"type": [
"number",
"null"
],
"description": "January-to-month figure"
},
"month": {
"type": [
"number",
"null"
],
"description": "Single-month figure"
},
"cumulative_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Cumulative YoY percent"
},
"month_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Month YoY percent"
}
},
"additionalProperties": true
},
"express_volume_international_hk_mo_tw": {
"type": "object",
"properties": {
"unit": {
"type": "string",
"description": "Unit"
},
"cumulative": {
"type": [
"number",
"null"
],
"description": "January-to-month figure"
},
"month": {
"type": [
"number",
"null"
],
"description": "Single-month figure"
},
"cumulative_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Cumulative YoY percent"
},
"month_yoy_pct": {
"type": [
"number",
"null"
],
"description": "Month YoY percent"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
{
"type": "null"
}
],
"description": "null when the release table could not be read"
},
"available_releases": {
"type": "array",
"items": {
"type": "object",
"properties": {
"year": {
"type": "number"
},
"month": {
"type": "number"
},
"title": {
"type": "string",
"description": "x"
},
"published": {
"type": [
"string",
"null"
],
"description": "x"
}
},
"additionalProperties": true
},
"description": "Releases that exist (found:false)"
},
"message": {
"type": "string",
"description": "Explanation (found:false or figures:null)"
},
"field_notes": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"source": {
"type": "string",
"description": "Publisher and dataset"
}
},
"additionalProperties": true
}Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}Connect to just the china-macro pack
{
"mcpServers": {
"china-macro": {
"url": "https://gateway.pipeworx.io/china-macro/mcp"
}
}
}See Getting Started for client-specific install steps.