한국투자증권 REST API MCP (Model Context Protocol)

What is 한국투자증권 REST API MCP (Model Context Protocol)?

한국투자증권 REST API MCP (Model Context Protocol) is a server that uses the Korea Investment & Securities (KIS) REST API to provide stock trading and market data inquiry via the Model Context Protocol. It supports domestic and overseas stock trading, price checks, account management, and is intended for developers building AI‑assisted trading tools.

How to use 한국투자증권 REST API MCP (Model Context Protocol)?

Install Python 3.13+ and uv, then create a virtual environment and install dependencies with uv pip install -e .. Set the environment variables KIS_APP_KEY, KIS_APP_SECRET, KIS_ACCOUNT_TYPE, and KIS_CANO with your KIS API credentials. The server exposes MCP tools such as inquery_stock_price, order_stock, inquery_balance, order_overseas_stock, and others for trading and data retrieval.

Key features of 한국투자증권 REST API MCP (Model Context Protocol)

• 🇰🇷 Domestic stock trading: price, orders, balance, ask prices, order history
• 🌏 Overseas stock trading: US, Japan, China, Hong Kong, Vietnam
• Real‑time price and execution information
• Asynchronous processing for fast responses
• Reliable error handling and extensible design
• Environment‑variable configuration for API keys and account

Use cases of 한국투자증권 REST API MCP (Model Context Protocol)

• Automate domestic stock buy/sell orders via AI agents
• Retrieve real‑time overseas stock prices for portfolio monitoring
• Check account balance and profit/loss status programmatically
• Inquire daily order history and order details for reconciliation
• Fetch ask price (bid/ask depth) for trading decisions

FAQ from 한국투자증권 REST API MCP (Model Context Protocol)

What is the difference between this server and using KIS API directly?

This server wraps the KIS REST API into the Model Context Protocol, enabling AI assistants to call trading and data functions through a standardized interface. It handles authentication, async responses, and error formatting.

What are the runtime requirements?

Python 3.13 or later and the uv packaging tool are required. Dependencies are installed via uv pip install -e ..

Where do user credentials and trading data reside?

API keys and account information are set as environment variables (KIS_APP_KEY, KIS_APP_SECRET, KIS_ACCOUNT_TYPE, KIS_CANO). All trading data is retrieved from and sent to the Korea Investment & Securities API; no data is stored locally.

Are there any known limits or restrictions?

The project is still under development. API call limits from KIS apply, and trading is only available during market hours (domestic 09:00–15:30 KST; overseas hours vary by market). Use a virtual account for testing before real trading.

How is authentication handled?

Authentication uses a REST API app key and secret key, passed via environment variables. No OAuth flow is implemented; the server uses these keys directly for every API call.