korea-data-mcp Stops AI Agents Misreading Korean APIs

·

korea-data-mcp

korea-data-mcp for AI agents has been released. The project combines the DART, Public Data Portal, and National Law Information APIs into a single MCP server to help agents such as Claude and Cursor accurately retrieve Korean company, real estate, and legal data.

Misreading Pitfalls Hidden in Public API Responses

Even when public API responses are passed directly to AI agents, they may appear plausible while producing incorrect answers. A representative example is a DART semiannual report. When asked about Samsung Electronics’ revenue for the first half of 2025, an agent may respond with KRW 74.6 trillion because thstrm_amount covers three months in the second quarter rather than the first-half cumulative total. Actual first-half cumulative revenue is listed as KRW 153.7 trillion.

korea-data-mcp addresses these issues at the server level and currently handles 47 pitfalls. For legal information, it corrects cases where amendments to existing laws that have not yet taken effect are mixed into the body of the current statute. It selects the version in force on the reference date and displays provisions scheduled to take effect along with their effective dates.

For actual apartment transaction prices, it prevents canceled contracts from being included as valid transactions. By default, it calculates the median after excluding the canceled contract. It also addresses the problem of receiving zero results for the previous month when an outdated regional code is entered due to administrative district restructuring, and provides the updated code. Other input errors, amounts in units of KRW 10,000, and dates with two-digit years are also handled separately. The complete list is documented in the repository’s docs/QUIRKS.ko.md file.

Local Execution and Data Coverage

Supported areas include DART company, disclosure, and financial statement data, stock prices, basic company information, business registration status, actual apartment sale and purchase prices, public holidays, laws, and court precedents. On Claude Desktop, it can be installed by opening the included.mcpb release file, and it is also registered in the official MCP Registry. Other environments support either a single Go binary or a go install method.

Users provide their own free API keys. A single OpenDART key is enough to get started within a few minutes. The server runs only on the user’s personal computer and does not use third-party servers or telemetry. A hosted version that can be accessed through a URL without requiring a key is being prepared.

korea-data-mcp takes the concept of connecting Korean public APIs to AI agents a step further. Instead of displaying raw responses, the server filters out conditions that can produce incorrect answers, such as reporting periods, contract status, administrative districts, and the effective dates of laws. The developers are considering sources such as the Bank of Korea’s ECOS and KOSIS, and are seeking related feedback. More details are available in the GitHub repository.

Reference Sources

This article was written after consulting the following source: geeknews — Show GN: korea-data-mcp – An MCP server that helps AI agents correctly read Korean public APIs

Leave a Reply

Your email address will not be published. Required fields are marked *