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

NameTypeRequiredDescription
measurestringnoReal (chained 2020 yen) or nominal. Default real.
basisstringnoWhat the numbers are. Default qoq.
adjustmentstringnoSeries. Only choosable for basis amount (default seasonally_adjusted).
componentsarraynoKeep components whose name contains any of these words (case-insensitive), e.g. [“GDP”,“Exports”]. Default all.
itemsstringno
fromstringnoFirst quarter, e.g. 2025-Q1 or 2025.
tostringnoLast quarter, e.g. 2026-Q3 or 2026.
release_datestringnoISO 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

FieldTypeDescription
sourcestring
data_as_ofstring
releaseobject
limitsstring
measurestring
basisstring
adjustmentstring
tablestring
unitstring
available_rangeobject
no_matchboolean
countnumber
truncatedboolean
rowsarray
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.

Regenerated from source · build November 16, 2026