`ecos_get_series`

Pack: ecos-kr · Endpoint: https://gateway.pipeworx.io/ecos-kr/mcp

Fetch a time series from Bank of Korea ECOS. Pass stat_code + cycle (A/Q/M/D) + start/end period. Date format matches the cycle: yearly = “2024”, quarterly = “2024Q3”, monthly = “202403”, daily = “20240315”. Optionally narrow to specific item_code(s) via item1/item2/item3/item4. Returns rows with stat_name, item_name, unit, time, data_value. Use after ecos_search_tables + ecos_series_items to discover codes.

Parameters

Name	Type	Required	Description
`stat_code`	string	yes	Statistic code (e.g., “901Y009” for CPI, “731Y001” for exchange rates).
`cycle`	string	yes	Cycle: A (annual), Q (quarterly), M (monthly), D (daily), SM (semi-monthly).
`start`	string	yes	Start period in cycle’s native format (e.g., “2024” / “2024Q1” / “202401” / “20240101”).
`end`	string	yes	End period (same format as start).
`item1`	string	no	Optional item filter (e.g., “0000001” for USD in the exchange-rate table).
`item2`	string	no	Optional second item filter.
`item3`	string	no	Optional third item filter.
`item4`	string	no	Optional fourth item filter.
`limit`	number	no	Max rows to return (default 100, max 1000).

Example call

Arguments

{
  "stat_code": "731Y001",
  "cycle": "M",
  "start": "202401",
  "end": "202412",
  "item1": "0000001"
}

curl

curl -X POST https://gateway.pipeworx.io/ecos-kr/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ecos_get_series","arguments":{"stat_code":"731Y001","cycle":"M","start":"202401","end":"202412","item1":"0000001"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('ecos_get_series', {
  "stat_code": "731Y001",
  "cycle": "M",
  "start": "202401",
  "end": "202412",
  "item1": "0000001"
});

More examples

{
  "stat_code": "901Y009",
  "cycle": "M",
  "start": "202301",
  "end": "202412"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "ecos-kr": {
      "url": "https://gateway.pipeworx.io/ecos-kr/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

ecos_get_series