What is the 한국투자증권 MCP Server?

The 한국투자증권 MCP Server is a Python-based server that provides a REST API for accessing stock trading and market data from 한국투자증권 (Korea Investment & Securities). It supports both domestic and overseas stock trading.

What is MCP (Model Context Protocol)?

MCP (Model Context Protocol) is an open standard that streamlines how applications provide context to Large Language Models (LLMs), enabling AI models to interact with external data sources and tools.

What are the key features of this MCP Server?

Key features include domestic and overseas stock trading, asynchronous processing, real-time market data, robust error handling, and an extensible design.

Which markets are supported for overseas stock trading?

The server supports markets including the US (NASDAQ, NYSE, AMEX), Hong Kong, China, Japan, and Vietnam.

What are the requirements for installing the MCP Server?

The requirements include Python 3.13 or higher and the uv Python packaging tool.

How do I install the server dependencies?

Create a virtual environment using uv venv, activate it, and then install the dependencies using uv pip install -e ..

What environment variables do I need to configure?

You need to configure KIS_APP_KEY (API key), KIS_APP_SECRET (API secret), KIS_ACCOUNT_TYPE (account type - “REAL” or “VIRTUAL”), and KIS_CANO (account number).

Is this project safe to use for live trading?

No, this project is under active development and should not be used for live trading without thorough testing in a simulated environment. The user assumes all responsibility for any losses incurred.

Where can I find the trading hours for different markets?

Trading hours are provided for domestic stocks, as well as US (NASDAQ/NYSE), Japan, China, Hong Kong, and Vietnam markets.

What is UBOS and how does it relate to this MCP Server?

UBOS is a full-stack AI Agent development platform that can be integrated with the 한국투자증권 MCP Server to build sophisticated AI-powered trading agents.