Korea Data MCP
Korean filings, stock prices, apartment trades, statutes and statistics from official APIs
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.1.10
- Listing updated
- today
Similar MCP servers
About Korea Data MCP
Korea Data MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Raw Korean government APIs hide traps that quietly produce wrong answers, and this server exists to handle them. Its example: OpenDART returns a second-quarter figure in the field an agent would read as half-year revenue. The server returns both periods with explicit dates. It documents 101 such traps, including laws listed as current that take effect later, cancelled apartment deals, and district codes that changed in 2026.
It draws on OpenDART, data.go.kr, law.go.kr and the Bank of Korea ECOS service, so you need a free key from each source you use. It runs locally as a single binary or one-click Claude Desktop bundle, and the README says keys and questions go only to the government APIs, with no telemetry. The README counts 25 tools.
An evaluation of 10 questions reported one call each with the server, against about three times as many calls and one miss using the raw APIs.
Install
Run in a terminal
claude mcp add korea-data-mcp --env OPENDART_API_KEY='<OPENDART_API_KEY>' --env DATAGOKR_SERVICE_KEY='<DATAGOKR_SERVICE_KEY>' --env LAWGOKR_OC='<LAWGOKR_OC>' --env ECOS_API_KEY='<ECOS_API_KEY>' -- npx -y https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"korea-data-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb"
],
"env": {
"OPENDART_API_KEY": "<OPENDART_API_KEY>",
"DATAGOKR_SERVICE_KEY": "<DATAGOKR_SERVICE_KEY>",
"LAWGOKR_OC": "<LAWGOKR_OC>",
"ECOS_API_KEY": "<ECOS_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"korea-data-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb"
],
"env": {
"OPENDART_API_KEY": "<OPENDART_API_KEY>",
"DATAGOKR_SERVICE_KEY": "<DATAGOKR_SERVICE_KEY>",
"LAWGOKR_OC": "<LAWGOKR_OC>",
"ECOS_API_KEY": "<ECOS_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"korea-data-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb"
],
"env": {
"OPENDART_API_KEY": "<OPENDART_API_KEY>",
"DATAGOKR_SERVICE_KEY": "<DATAGOKR_SERVICE_KEY>",
"LAWGOKR_OC": "<LAWGOKR_OC>",
"ECOS_API_KEY": "<ECOS_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"korea-data-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb"
],
"env": {
"OPENDART_API_KEY": "<OPENDART_API_KEY>",
"DATAGOKR_SERVICE_KEY": "<DATAGOKR_SERVICE_KEY>",
"LAWGOKR_OC": "<LAWGOKR_OC>",
"ECOS_API_KEY": "<ECOS_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"korea-data-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb"
],
"env": {
"OPENDART_API_KEY": "<OPENDART_API_KEY>",
"DATAGOKR_SERVICE_KEY": "<DATAGOKR_SERVICE_KEY>",
"LAWGOKR_OC": "<LAWGOKR_OC>",
"ECOS_API_KEY": "<ECOS_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
OPENDART_API_KEYOpenDART key for corporate filings, financials, dividends, shareholders, stakes in other companies and major decisions (opendart.fss.or.kr)DATAGOKR_SERVICE_KEYdata.go.kr Decoding key for holidays, corporations, business status, apartment trades and rents, stock prices, pension workplacesLAWGOKR_OClaw.go.kr OC for statutes and court rulings (set at open.law.go.kr)ECOS_API_KEYBank of Korea ECOS key for interest rates, exchange rates, prices, GDP and other statistics (ecos.bok.or.kr/api)
Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- entity_resolve_company
- Identifies a company from a name or number and returns identifiers and status.
- opendart_search_companies
- Searches companies and checks whether each is listed.
- opendart_get_financials
- Financial statements with period dates, including full scope.
- opendart_get_investments
- Stakes in other companies.
- opendart_list_corporate_actions
- Rights issues, buybacks, mergers and other major decisions.
- opendart_get_ownership_reports
- Reports by 5% holders and insiders.
- opendart_get_dividends
- Dividend data.
- opendart_get_major_shareholders
- Largest shareholders.
- ecos_get_series
- Bank of Korea statistical series.
- ecos_search_series
- Searches ECOS series.
- datagokr_list_apartment_rents
- Apartment rents.
- datagokr_get_pension_workplaces
- National Pension Service workplaces with 12-month history.
What it does
- Corporate filings
- Financials, dividends, major shareholders, stakes and major decisions.
- Property trades and rents
- Apartment sales and rents with cancelled deals removed.
- Statutes and rulings
- Law text in force on a given date, plus court rulings.
- Economic series
- Bank of Korea rates, exchange rates and other statistics.
- Company resolution
- Identifies a company from a name or number, with former names.
- Local and private
- Runs on your machine without telemetry.
Good for
- Compare a company's half-year revenue and dividends
- Check whether a supplier's business is still active
- Find median apartment prices for a district
- Ask whether a law article is in force yet
Pricing
Open source
Uses free official API keys
Korea Data MCP FAQ
What keys are needed?
Keys for OpenDART, data.go.kr, law.go.kr and ECOS, depending on what you use.
Where does it run?
Locally, as a binary or a Claude Desktop bundle.
Does it send data to a third party?
The README says keys and questions go only to the government APIs.
Can I use Korean?
Yes, English or Korean.
Is Korea Data MCP free?
Yes. Korea Data MCP is open source, so you can use and self-host it for free.
How do I add Korea Data MCP to Claude Code?
Run this command in your terminal: claude mcp add korea-data-mcp --env OPENDART_API_KEY='<OPENDART_API_KEY>' --env DATAGOKR_SERVICE_KEY='<DATAGOKR_SERVICE_KEY>' --env LAWGOKR_OC='<LAWGOKR_OC>' --env ECOS_API_KEY='<ECOS_API_KEY>' -- npx -y https://github.com/YoungsoonLee/korea-data-mcp/releases/download/v0.1.10/korea-data-mcp.mcpb
What are the best alternatives to Korea Data MCP?
The closest alternatives to Korea Data MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


