# South Korea KOSIS MCP

> South Korea KOSIS MCP Server lets your agent pull raw, official statistics directly from the Korean Statistical Information Service. You can find tables on everything—from GDP and trade to demographics using 'search_korea_statistics', then execute specific data fetches with 'get_korea_stats_data'. It gives you granular, government-certified numbers for market analysis.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** national-statistics, demographics, economic-data, korean-market, data-discovery

## Description

You're looking at the KOSIS MCP Server—the Korean National Statistics Data toolset. It lets your agent pull raw, official statistics straight from the Korean Statistical Information Service (KOSIS). This isn't general data; it's government-certified numbers for serious market analysis.

It works in two distinct phases: finding the right dataset and then pulling the exact figures you need. You gotta start by using the `search_korea_statistics` tool. You feed it a keyword—say, 'semiconductor,' or maybe 'employment'—and the system sweeps through the entire KOSIS national database. This search doesn't just give you results; it finds and returns the necessary table IDs, organization IDs, and names for relevant tables across everything from population metrics to trade flows.

Once that search gives you a list of candidates, you then use `get_korea_stats_data`. You gotta provide this tool with the specific organization ID (orgId) and the table ID (tableId) that matched your needs. This action pulls precise, raw numerical data from that exact KOSIS table.

When pulling figures, remember you can narrow down what you're looking at. The system lets you filter results by date range using start and end date parameters in YYYYMM format. You can also restrict the scope of your analysis using a classification period. This means you control exactly which historical window or specific category the numbers represent.

If you're modeling macro-economics, for example, this server handles national account data like GDP figures or total trade volume. It gives you reliable, granular statistics that are crucial for building out economic models. You can track industrial output and see how various sectors measured up. If your focus is on the people—the demographics and labor side of things—you'll pull detailed information on population trends, fertility rates, and employment figures across specific industries. This means you don't just get a total; you segment the data by industry or category.

In short, `search_korea_statistics` helps your agent find the perfect dataset using keywords, giving you the identifiers needed for retrieval. Then, `get_korea_stats_data` uses those identifiers—the orgId and tableId—to yank raw figures from KOSIS. You're always in control of the scope; you set the dates, you choose the classification period. This gives your AI client access to hard numbers, whether you need to track changes in trade flows over a decade or analyze labor force participation rates for a single quarter. It’s direct data access that bypasses general APIs and hits the source tables directly.

## Tools

### get_korea_stats_data
Retrieves raw statistical figures from a specific, identified table in the KOSIS database.

### search_korea_statistics
Searches the entire KOSIS national database by keyword to locate relevant tables and their necessary IDs.

## Prompt Examples

**Prompt:** 
```
What are South Korea's semiconductor export figures for the last 3 years?
```

**Response:** 
```
I've queried KOSIS for semiconductor trade data. South Korea's semiconductor exports reached approximately $132 billion in 2023, rebounding strongly from the $101 billion dip in 2022. Samsung and SK Hynix continue to dominate global memory chip production, driving the recovery.
```

**Prompt:** 
```
What is South Korea's current population growth rate?
```

**Response:** 
```
Based on the latest KOSIS demographic data, South Korea's population growth rate is currently negative, standing at approximately -0.1%, driven by a record low total fertility rate.
```

**Prompt:** 
```
Show me the employment statistics for the manufacturing sector this quarter.
```

**Response:** 
```
According to KOSIS labor force survey data, employment in the manufacturing sector for Q3 reached 4.45 million workers, representing a 1.2% year-over-year growth, largely supported by automotive exports.
```

## Capabilities

### Discover Statistical Tables
You search the entire KOSIS database using keywords (e.g., 'semiconductor' or 'employment') to find relevant tables, receiving the necessary IDs for data retrieval.

### Pull Raw Numerical Data
The agent retrieves precise figures from a specific KOSIS table, requiring you to provide the correct organization and table identifiers.

### Filter by Time Period
You narrow down statistical results using start and end date parameters (YYYYMM), ensuring the data reflects the exact historical window you need.

### Analyze Economic Indicators
The system pulls national account data, such as GDP or trade volume, providing reliable figures for macro-economic modeling.

### Track Demographics and Labor Data
You pull detailed information on population trends, fertility rates, and employment figures across specific industries.

## Use Cases

### Analyzing the semiconductor boom
A user needs to know South Korea's export numbers for memory chips over the last five years. They ask their agent, which first uses 'search_korea_statistics' (keyword: 'semiconductor'). It finds the right table ID, and then calls 'get_korea_stats_data' using that ID and a 5-year date range to build a complete trend line.

### Modeling labor force changes
A firm wants to compare employment rates in the auto sector versus electronics over two quarters. The agent uses 'search_korea_statistics' for both sectors, collects the necessary IDs, and then runs multiple calls to 'get_korea_stats_data', ensuring all numbers are pulled from the same official source.

### Understanding demographic pressure
A researcher needs to confirm the current population growth rate. They query KOSIS for demographics, which returns a direct answer based on the latest available data, showing the impact of low fertility rates immediately.

### Comparing regional economic health
A consultant wants to compare housing market trends across different regions and time periods. The agent uses 'search_korea_statistics' to identify multiple relevant tables (e.g., by region code) before running targeted, filtered data calls via 'get_korea_stats_data'.

## Benefits

- See precise figures for semiconductor exports. Instead of guessing, your agent pulls exact trade numbers from the official source using 'get_korea_stats_data'.
- Track population shifts and demographics with accuracy. You can use KOSIS to see current growth rates or historical fertility trends.
- Get national account metrics instantly. Model things like GDP or employment levels by filtering data through `get_korea_stats_data` using specific date ranges.
- Find the right source quickly. Use 'search_korea_statistics' first, so you don't waste time guessing IDs when you need to pull data later.
- Avoid stale reports. The KOSIS connection provides access to highly granular and recently updated government statistics.

## How It Works

The bottom line is: search for what you need first; then run the specific command with the resulting IDs.

1. Start by calling `search_korea_statistics` with your topic keywords (e.g., 'semiconductor exports').
2. Review the output to identify the required `orgId` and `tableId`, which define the data set you want.
3. `get_korea_stats_data` uses those IDs and any desired date ranges to fetch the raw, official numbers.

## Frequently Asked Questions

**How do I start with South Korea KOSIS MCP Server?**
You always start by using `search_korea_statistics`. This tool searches the database by keywords (like 'GDP' or 'population') and gives you the IDs needed for the next step.

**Do I need to run both tools, `get_korea_stats_data` and `search_korea_statistics`?**
Yes. You must use `search_korea_statistics` first because it generates the necessary table IDs that you then pass into `get_korea_stats_data` to actually pull the numbers.

**Can I filter data using South Korea KOSIS MCP Server?**
Absolutely. When calling `get_korea_stats_data`, you can pass start/end period parameters (YYYYMM format) to narrow down the results to a specific time frame.

**What data types are available in South Korea KOSIS MCP Server?**
The server covers demographics, national accounts (GDP), trade flows, technology adoption rates, and employment statistics across various industries.

**What do I need to use the `get_korea_stats_data` tool?**
You must register for an API key at kosis.kr first. The server requires this credential to authenticate your request before running any queries.

**How do I find the necessary identifiers for `get_korea_stats_data`?**
Run the `search_korea_statistics` tool first. This returns all the required `orgId`, `tableId`, and names you need to pass into the data retrieval function.

**What formats are accepted for time period filtering in `get_korea_stats_data`?**
The tool accepts two primary date formats: YYYYMM (for full year/month precision) or YYYY (for year-only data). Always check the documentation to confirm which format fits your required granularity.

**If I use an incorrect table ID, what should I do?**
The server will return a specific error indicating invalid parameters. You shouldn't guess IDs; always start by calling `search_korea_statistics` to verify the correct organization and table identifiers.

**How do I get a KOSIS API key?**
Register at kosis.kr, then apply for API access in the Open API section. Your API key is issued instantly upon application.

**What makes Korean data unique?**
South Korea is the world's leading producer of memory semiconductors and a major hub for display panels, batteries, and shipbuilding. KOSIS provides granular production, export, and trade data for these critical industries that is unavailable from any other source.

**Does the API provide historically consistent data?**
Yes, KOSIS standardizes time-series data ensuring that demographic, industrial, and national accounts figures remain historically consistent, often providing data points spanning several decades.