`nso_vn_get_data`

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

Get figures from a Vietnam National Statistics Office (NSO) table as labelled rows (dimension labels in Vietnamese, value, period, data_as_of). select maps a dimension (code or label) to what you want: a value label or code, an array of them, ”*” for all, “first”, “last”, or “last:N” for the final N. Matching is by exact code, exact label, then label text. Any dimension you leave out is defaulted — year dimensions to their latest value, every other to its first value (usually the total) — and every default is listed in selection_resolved and note. Selections above 1,500 cells are refused with the sizes so you can narrow them.

Parameters

Name	Type	Required	Description
`table_id`	string	yes	Native table id from nso_vn_search_tables.
`select`	object	no	Map of dimension code/label to value(s), e.g. {“Năm”:“last:3”,“Phân tổ”:“Tổng số”}.

Example call

Arguments

{
  "table_id": "Dân số và lao động/V02.59.px",
  "select": {
    "Năm": "last:3",
    "Vùng": "Tổng số"
  }
}

curl

curl -X POST https://gateway.pipeworx.io/nso-vn/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nso_vn_get_data","arguments":{"table_id":"Dân số và lao động/V02.59.px","select":{"Năm":"last:3","Vùng":"Tổng số"}}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('nso_vn_get_data', {
  "table_id": "Dân số và lao động/V02.59.px",
  "select": {
    "Năm": "last:3",
    "Vùng": "Tổng số"
  }
});

Response shape

Field	Type	Description
`table_id`	string
`title`	string
`unit_note`	string
`source`	string
`data_as_of`	string
`cells`	number
`selection_resolved`	object
`rows`	array
`note`	string

Full JSON Schema

{
  "type": "object",
  "properties": {
    "table_id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "unit_note": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    },
    "cells": {
      "type": "number"
    },
    "selection_resolved": {
      "type": "object",
      "properties": {
        "Năm": {
          "type": "object",
          "properties": {
            "label": {
              "type": "string"
            },
            "chosen": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "how": {
              "type": "string"
            }
          },
          "additionalProperties": true
        },
        "Vùng": {
          "type": "object",
          "properties": {
            "label": {
              "type": "string"
            },
            "chosen": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "how": {
              "type": "string"
            }
          },
          "additionalProperties": true
        },
        "Thành thị, nông thôn": {
          "type": "object",
          "properties": {
            "label": {
              "type": "string"
            },
            "chosen": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "how": {
              "type": "string"
            },
            "defaulted": {
              "type": "boolean"
            }
          },
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "Thành thị, nông thôn": {
            "type": "string"
          },
          "Vùng": {
            "type": "string"
          },
          "Năm": {
            "type": "string"
          },
          "value": {
            "type": "number"
          }
        },
        "additionalProperties": true
      }
    },
    "note": {
      "type": "string"
    }
  },
  "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 nso-vn pack

{
  "mcpServers": {
    "nso-vn": {
      "url": "https://gateway.pipeworx.io/nso-vn/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

nso_vn_get_data