China Macro

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:

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

For the local bridge, use:

{
  "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.