jp_gdp_series
Pack: japan-gdp · 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/jp_gdp_series for the schema, then POST the same URL with its arguments for the data.
Dated quarterly rows of Japan’s GDP and its expenditure components from the Cabinet Office (Government of Japan), from January-March 1994, for one release. Choose measure real or nominal and basis qoq (quarter-on-quarter %), annualized (quarter-on-quarter %, annualized), yoy (year-on-year %, original series), amount (billion yen, chained 2020 yen for real), or contribution_qoq / contribution_annualized / contribution_yoy (percentage points of GDP growth). adjustment is seasonally_adjusted or original and is fixed by the basis except for amount. from/to are quarters such as 2025-Q3 (default: the last 8 quarters). Returns the release date and stage (first or second preliminary), the unit and one values object per quarter keyed by component; unavailable cells are null. Honest limit: a preliminary estimate is revised and seasonally adjusted history changes at each release; expenditure approach only. A range with no quarters returns no_match=true with the available range, which is different from a read failure (an error).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
measure | string | no | Real (chained 2020 yen) or nominal. Default real. |
basis | string | no | What the numbers are. Default qoq. |
adjustment | string | no | Series. Only choosable for basis amount (default seasonally_adjusted). |
components | array | no | Keep components whose name contains any of these words (case-insensitive), e.g. [“GDP”,“Exports”]. Default all. |
items | string | no | |
from | string | no | First quarter, e.g. 2025-Q1 or 2025. |
to | string | no | Last quarter, e.g. 2026-Q3 or 2026. |
release_date | string | no | ISO date of a published release. Default: the newest release. |
Example call
Arguments
{
"measure": "real",
"basis": "annualized",
"components": [
"GDP",
"Private Consumption",
"Exports",
"Imports"
],
"from": "2025-Q3",
"to": "2026-Q3"
}
curl
curl -X POST https://gateway.pipeworx.io/japan-gdp/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"jp_gdp_series","arguments":{"measure":"real","basis":"annualized","components":["GDP","Private Consumption","Exports","Imports"],"from":"2025-Q3","to":"2026-Q3"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('jp_gdp_series', {
"measure": "real",
"basis": "annualized",
"components": [
"GDP",
"Private Consumption",
"Exports",
"Imports"
],
"from": "2025-Q3",
"to": "2026-Q3"
});
Response shape
| Field | Type | Description |
|---|---|---|
source | string | |
data_as_of | string | |
release | object | |
limits | string | |
measure | string | |
basis | string | |
adjustment | string | |
table | string | |
unit | string | |
available_range | object | |
no_match | boolean | |
count | number | |
truncated | boolean | |
rows | array |
Full JSON Schema
{
"type": "object",
"properties": {
"source": {
"type": "string"
},
"data_as_of": {
"type": "string"
},
"release": {
"type": "object",
"properties": {
"release_date": {
"type": "string"
},
"period": {
"type": "string"
},
"period_label": {
"type": "string"
},
"stage": {
"type": "string"
},
"stage_as_published": {
"type": "string"
},
"benchmark_year": {
"type": "number"
}
},
"additionalProperties": true
},
"limits": {
"type": "string"
},
"measure": {
"type": "string"
},
"basis": {
"type": "string"
},
"adjustment": {
"type": "string"
},
"table": {
"type": "string"
},
"unit": {
"type": "string"
},
"available_range": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"additionalProperties": true
},
"no_match": {
"type": "boolean"
},
"count": {
"type": "number"
},
"truncated": {
"type": "boolean"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"period": {
"type": "string"
},
"values": {
"type": "object",
"properties": {
"GDP(Expenditure Approach)": {
"type": "number"
},
"Private Consumption": {
"type": "number"
},
"Net Exports": {
"type": "null"
},
"Exports": {
"type": "number"
},
"Imports": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
}
},
"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 japan-gdp pack
{
"mcpServers": {
"japan-gdp": {
"url": "https://gateway.pipeworx.io/japan-gdp/mcp"
}
}
}
See Getting Started for client-specific install steps.