# China Macro [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/pipeworx-io/mcp-china-macro  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1368  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/china-macro

## Description
China's PBOC Loan Prime Rate (LPR) — 1-year and 5-year benchmark lending rates with reference…

## Tools
Capabilities this server exposes over MCP:

- **china_lpr** — China's PBOC Loan Prime Rate (贷款市场报价利率, LPR) history — the 1-year and 5-year benchmark lending rates, each with its official reference/announcement date. Published monthly on the 20th (or next business day) by the National Interbank Funding Center under PBOC authorization. The 1-year rate anchors most corporate and consumer loans; the 5-year rate anchors mortgages. Returns up to the last 12 monthly announcements (the publisher exposes only a rolling ~1-year window) plus a `latest` field for the most recent print. Answers "what is the current PBOC LPR", "China's 1-year and 5-year loan prime rate history", "when did the PBOC last cut the LPR". Keyless, sourced live from the National Interbank Funding Center, under PBOC authorization.
- **china_lpr_latest** — China's most recent PBOC Loan Prime Rate (贷款市场报价利率一年期/五年期, LPR 1Y/5Y) print only — a cheap single-row call for just the current 1-year and 5-year rates and their official reference/announcement date, without the 12-month history. Use china_lpr instead if you need the trend over time. Keyless, sourced live from the National Interbank Funding Center, under PBOC authorization.
- **china_macro_indicator** — China's headline National Bureau of Statistics (NBS) macro indicators — one tool, pick an `indicator`: `cpi` (Consumer Price Index, national/urban/rural, y/y + m/m), `ppi` (Producer Price Index), `pmi` (manufacturing + non-manufacturing Purchasing Managers' Index), `gdp` (quarterly GDP, published as year-to-date cumulative, by sector), `industrial_production` (industrial value-added growth), `retail_sales` (total retail sales of consumer goods), `fixed_asset_investment` (FAI), `money_supply` (M0/M1/M2 outstanding + growth), or `trade` (General Administration of Customs monthly export/import totals in USD). Returns the latest period's values first (with its period, e.g. "2026-09"), then up to `periods` months/quarters of history, newest first — every Chinese NBS field name translated to an English name with its unit and the index convention it uses (prior-period = 100 unless stated otherwise). Answers "China's latest CPI", "China PMI history", "China Q2 GDP growth", "China M2 money supply", "China's trade surplus last month". Default route is a republisher's data centre. Pass `source: "nbs"` to read the National Bureau of Statistics of China's own database directly: every series then carries its period, period TYPE (single month/quarter vs year-to-date), measure (index vs percent change vs level), unit and base, exactly as published and never converted, and `data_as_of`. The direct route also adds `urban_unemployment` (surveyed urban unemployment rate) and `capacity_utilization` (industrial capacity utilisation, quarterly), and `region` (a province name, or `all` for the 31 mainland provincial-level regions in one period) for cpi, ppi, industrial_production, fixed_asset_investment and gdp. A series whose base cannot be established from the publisher's own label comes back basis_status "unresolved" rather than guessed. Keyless, sourced live from the National Bureau of Statistics of China (General Administration of Customs for `trade`).
- **china_house_prices** — China's NBS 70-city residential price indexes — new-build commercial housing (新建商品住宅) and resale/existing housing (二手住宅), year-on-year and month-on-month, for Beijing, Shanghai, Shenzhen, and 67 other NBS-tracked cities. Pass `city` (English name, e.g. "Beijing") for that city's history (up to 24 months); pass `month` ("YYYY-MM") to pin a specific release; pass neither for the latest month's full 70-city cross-section. Index values use the prior period = 100 convention (e.g. 97.7 = a 2.3% year-on-year fall). Answers "Beijing home price index", "which Chinese cities have falling house prices", "China 70-city house price index for August". Keyless, sourced live from the National Bureau of Statistics of China, via Eastmoney's data centre.
- **china_rates** — China's money-market and government-bond benchmark rates. `series: "shibor"` returns the Shanghai Interbank Offered Rate across all 8 tenors (overnight through 1-year) — the latest 11:00-Beijing-time fixing plus up to `days` of daily history. `series: "yield_curve"` returns the China Government Bond yield curve: the dated 1-year/10-year benchmark series (IMF SDDS disclosure) plus CFETS's real-time quoted-yield curve across every actively-traded CGB maturity (~1 month to ~50 years). Answers "current SHIBOR rates", "China's 10-year government bond yield", "China yield curve history". Keyless, sourced live from the China Foreign Exchange Trade System / National Interbank Funding Center.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "china-macro": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-china-macro"]
  }
}
```

## Documentation

## What China Macro MCP server does

China Macro exposes Chinese macroeconomic and financial data as MCP tools for AI clients and other MCP-compatible applications. The service covers the Loan Prime Rate (LPR), headline economic indicators, residential price indexes for 70 cities, SHIBOR fixings, and China government-bond yields.

The data is sourced from Chinese official institutions and market-data systems. LPR comes from the National Interbank Funding Center under PBOC authorization. National statistics and residential prices come from the National Bureau of Statistics of China, while trade totals come from the General Administration of Customs. SHIBOR and bond yields use data from the China Foreign Exchange Trade System and the National Interbank Funding Center.

## How it works

The hosted MCP endpoint is available at `https://gateway.pipeworx.io/china-macro/mcp`. Add that URL to an MCP client to expose the China Macro tools. A local npm package, `@pipeworx/mcp-china-macro`, provides a stdio bridge that forwards requests to the same hosted endpoint and therefore requires network access.

The service is keyless for anonymous use. The hosted endpoint can also be called directly over HTTP, including through the `/v1/tools/{tool}` routes. A full Pipeworx gateway endpoint is available when an application needs the broader catalog rather than this pack’s directly listed tools.

Pack endpoints also expose shared Pipeworx meta-tools. These include routing and discovery functions such as `ask_pipeworx`, which can select tools across the wider catalog. The local bridge lists only the pack tools unless `PIPEWORX_META_TOOLS=1` is set.

## Setup and configuration

For a hosted connection, configure an MCP client with:

```json
{
  "mcpServers": {
    "china-macro": {
      "url": "https://gateway.pipeworx.io/china-macro/mcp"
    }
  }
}
```

For the local bridge, use:

```json
{
  "mcpServers": {
    "china-macro": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-china-macro"]
    }
  }
}
```

Anonymous npm usage is capped at 50 calls per day. Setting `PIPEWORX_API_KEY` with a Pipeworx account raises the allowance to 200 calls per day. `NODE_USE_ENV_PROXY=1` can be used with Node versions that support environment-based HTTPS proxy handling.

## Tools and capabilities

- `china_lpr` returns up to 12 recent monthly LPR announcements, including one-year and five-year rates, dates, and a latest value.
- `china_lpr_latest` returns only the latest one-year and five-year LPR print and reference date.
- `china_macro_indicator` covers CPI, PPI, PMI, GDP, industrial production, retail sales, fixed-asset investment, money supply, and trade. It supports recent history and a direct NBS route with publication units, measures, periods, and regional data.
- `china_house_prices` returns new-build and resale residential price indexes for the 70 cities, either as a cross-section or city history.
- `china_rates` provides all eight SHIBOR tenors plus China government-bond yield data, including one-year and ten-year benchmark history and the quoted curve.

## Limitations and notes

LPR history is limited by the upstream rolling window to roughly 12 months. LPR is normally announced on the 20th of each month or the next business day, so the latest reference date changes approximately monthly.

The macro-indicator history defaults to 12 periods and allows up to 36; government-bond benchmark history is capped at 60 rows per call. Some NBS series preserve the publisher’s raw value and mark the basis as unresolved when the published label cannot establish it. Blank periods are removed and counted rather than returned as null values.

The NBS and Customs series are delivered through a keyless republisher, with the official source named first in responses. The integration is independent and unofficial, and is not affiliated with or endorsed by the upstream providers.

_Full upstream README: https://allmcps.com/mcp/china-macro/readme_