`boj_money_stock`

Pack: boj · 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/boj_money_stock for the schema, then POST the same URL with its arguments for the data.

Japan’s money stock (M1, M2, M3, or L) from the Bank of Japan, monthly, average amounts outstanding, in 100 million yen, with a computed year-over-year growth rate for every observation. Use for ‘Japan M2 money supply growth’ / ‘Japan M3 YoY’ / ‘BOJ money stock for a month’. Pass month (e.g. ‘2026-10’) to get one month; a month the BOJ has not published yet returns reason not_yet_published together with the latest available value instead of an empty result.

Parameters

Name	Type	Required	Description
`measure`	string	no	Which aggregate (default M2).
`month`	string	no	One month, e.g. ‘2026-10’ or ‘202610’.
`start`	string	no	First month of a range, e.g. ‘2026-01’.
`end`	string	no	Last month of a range.
`seasonally_adjusted`	boolean	no	Use the seasonally adjusted series (default false, the headline unadjusted series).
`limit`	number	no	Max observations returned (default 24, max 240).

Example call

Arguments

{
  "measure": "M2",
  "month": "2026-09"
}

curl

curl -X POST https://gateway.pipeworx.io/boj/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"boj_money_stock","arguments":{"measure":"M2","month":"2026-09"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('boj_money_stock', {
  "measure": "M2",
  "month": "2026-09"
});

More examples

{
  "measure": "M3",
  "start": "2026-01",
  "limit": 6
}

Response shape

Field	Type	Description
`found`	boolean \| null	Whether data was found
`reason`	string \| null	not_yet_published, series_not_found, no_observations, no_observations_in_range, database_not_found, no_matching_series, database_too_large_to_list
`db`	string \| null	BOJ database id
`code`	string \| null	Series code
`name`	string \| null	Series name
`message`	string \| null	Explanation when found is false
`source`	string \| null	Publisher and dataset
`category`	string \| null	Series category
`unit`	string \| null	Unit as published
`frequency`	string \| null	monthly, quarterly or annual
`last_update`	string \| null	Date the BOJ last updated the series (YYYYMMDD)
`data_as_of`	string \| null	Newest period in the series
`series_range`	object	First and last period
`latest`	object	One observation
`observation_count`	number \| null	Observations returned
`observations`	array
`measure`	string \| null	Money stock measure label
`notes`	array
`requested`	string \| null	Requested period (not_yet_published)
`latest_available_period`	string \| null	Newest published period (not_yet_published)
`latest_available_value`	number \| null	Newest published value (not_yet_published)
`hint`	string \| null	Next step

Full JSON Schema

{
  "type": "object",
  "additionalProperties": true,
  "properties": {
    "found": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether data was found"
    },
    "reason": {
      "type": [
        "string",
        "null"
      ],
      "description": "not_yet_published, series_not_found, no_observations, no_observations_in_range, database_not_found, no_matching_series, database_too_large_to_list"
    },
    "db": {
      "type": [
        "string",
        "null"
      ],
      "description": "BOJ database id"
    },
    "code": {
      "type": [
        "string",
        "null"
      ],
      "description": "Series code"
    },
    "name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Series name"
    },
    "message": {
      "type": [
        "string",
        "null"
      ],
      "description": "Explanation when found is false"
    },
    "source": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publisher and dataset"
    },
    "category": {
      "type": [
        "string",
        "null"
      ],
      "description": "Series category"
    },
    "unit": {
      "type": [
        "string",
        "null"
      ],
      "description": "Unit as published"
    },
    "frequency": {
      "type": [
        "string",
        "null"
      ],
      "description": "monthly, quarterly or annual"
    },
    "last_update": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date the BOJ last updated the series (YYYYMMDD)"
    },
    "data_as_of": {
      "type": [
        "string",
        "null"
      ],
      "description": "Newest period in the series"
    },
    "series_range": {
      "type": "object",
      "description": "First and last period",
      "properties": {
        "first": {
          "type": [
            "string",
            "null"
          ],
          "description": "First period"
        },
        "last": {
          "type": [
            "string",
            "null"
          ],
          "description": "Last period"
        }
      },
      "additionalProperties": true
    },
    "latest": {
      "type": "object",
      "description": "One observation",
      "properties": {
        "period": {
          "type": [
            "string",
            "null"
          ],
          "description": "Period, e.g. 2026-10, 2026-Q2 or 2026"
        },
        "value": {
          "type": [
            "number",
            "null"
          ],
          "description": "Value in the series unit"
        },
        "yoy_pct": {
          "type": [
            "number",
            "null"
          ],
          "description": "Percent change vs the same period a year earlier; null when the prior-year value is not in the series"
        }
      },
      "additionalProperties": true
    },
    "observation_count": {
      "type": [
        "number",
        "null"
      ],
      "description": "Observations returned"
    },
    "observations": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "One observation",
        "properties": {
          "period": {
            "type": [
              "string",
              "null"
            ],
            "description": "Period, e.g. 2026-10, 2026-Q2 or 2026"
          },
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Value in the series unit"
          },
          "yoy_pct": {
            "type": [
              "number",
              "null"
            ],
            "description": "Percent change vs the same period a year earlier; null when the prior-year value is not in the series"
          }
        },
        "additionalProperties": true
      }
    },
    "measure": {
      "type": [
        "string",
        "null"
      ],
      "description": "Money stock measure label"
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "requested": {
      "type": [
        "string",
        "null"
      ],
      "description": "Requested period (not_yet_published)"
    },
    "latest_available_period": {
      "type": [
        "string",
        "null"
      ],
      "description": "Newest published period (not_yet_published)"
    },
    "latest_available_value": {
      "type": [
        "number",
        "null"
      ],
      "description": "Newest published value (not_yet_published)"
    },
    "hint": {
      "type": [
        "string",
        "null"
      ],
      "description": "Next step"
    }
  }
}

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 boj pack

{
  "mcpServers": {
    "boj": {
      "url": "https://gateway.pipeworx.io/boj/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

boj_money_stock