Korea Investment & Securities REST API MCP (Model Context Protocol)

This is an MCP (Model Context Protocol) server that uses the REST API of Korea Investment & Securities (KIS) to search for stock trading and price information. It provides various financial transaction functions such as domestic and overseas stock trading, price search, and account management.

✨ Key Features

• 🇰🇷 Domestic stock trading

  • Real-time current price inquiry

  • Buy/Sell Order

  • Check balance

  • View household information

  • Check order history

• 🌏 Foreign stock trading

  • Support for major markets including the US, Japan, China, Hong Kong, and Vietnam

  • Real-time current price inquiry

  • Buy/Sell Order

• ⚡ Features

  • Fast response with asynchronous processing

  • Real-time price and transaction information

  • Stable error handling

  • Scalable design

⚠️ Note

This project is still in development and is an unfinished project. Please test it thoroughly before using it for actual investment.

• Any and all losses and liabilities arising from the use of this project are entirely the responsibility of the user.

• When using the API, you must comply with the Korea Investment & Securities Terms of Use.

• Caution is required when using a real account, and sufficient testing with a mock investment account is recommended.

• Be sure to check the restrictions regarding API call limits.

Requirements

• Python >= 3.13

• uv (Python packaging tool)

Installation

Functions

Domestic Stock Trading

• inquery_stock_price - Inquire about current stock price

  • symbol : stock code (e.g. "005930") (string, required)

  • Returns: Current price, previous day's price, rate of increase or decrease, trading volume, etc.

• order_stock - Stock buy/sell order

  • symbol : stock code (string, required)

  • quantity : Order quantity (number, required)

  • price : order price (0: market price) (number, required)

  • order_type : Order type ("buy" or "sell") (string, required)

• inquery_balance - Inquire account balance

  • Returns: Holdings, valuation, profit and loss status, etc.

• inquery_order_list - Inquire daily order history

  • start_date : Search start date (YYYYMMDD) (string, required)

  • end_date : End date of search (YYYYMMDD) (string, required)

• inquery_order_detail - Inquire order details

  • order_no : order number (string, required)

  • order_date : Order date (YYYYMMDD) (string, required)

• inquery_stock_ask - Inquire stock price information

  • symbol : stock code (string, required)

  • Returns: Ask/Buy price, bid quantity, etc.

Overseas Stock Trading

• order_overseas_stock - Overseas stock buy/sell order

  • symbol : stock code (e.g. "AAPL") (string, required)

  • quantity : Order quantity (number, required)

  • price : order price (number, required)

  • order_type : Order type ("buy" or "sell") (string, required)

  • market : Market code (string, required)

    • "NASD": NASDAQ

    • "NYSE": New York

    • "AMEX": Amex

    • "SEHK": Hong Kong

    • "SHAA": Shanghai, China

    • "SZAA": Shenzhen, China

    • "TKSE": Japan

    • "HASE": Hanoi, Vietnam

    • "VNSE": Ho Chi Minh City, Vietnam

• inquery_overseas_stock_price - Inquire about current overseas stock prices

  • symbol : stock code (string, required)

  • market : Market code (string, required)

Resources

Configuration

Set your API key and account information via environment variables:

• KIS_APP_KEY : Korea Investment & Securities App Key

• KIS_APP_SECRET : Korea Investment & Securities Secret Key

• KIS_ACCOUNT_TYPE : Account type ("REAL" or "VIRTUAL")

• KIS_CANO : Account number

Trading Hours

Domestic stocks:

• Regular hours: 09:00 ~ 15:30

• After-hours single price: 15:40 ~ 16:00

Foreign stocks:

• US (NASDAQ/New York): 22:30 ~ 05:00 (Korean time)

• Japan: 09:00 ~ 15:10

• China: 10:30 ~ 16:00

• Hong Kong: 10:30 - 16:00

• Vietnam: 11:15 - 16:15

Error Handling

Major errors that can occur when calling the API:

• Authentication error: Invalid API key or secret key

• Insufficient funds: When the order amount is greater than the account balance

• Time limit: Outside trading hours

• Order Limit: If the order quantity or amount exceeds the limit.

About

• Scalable design

• Fast response with asynchronous processing

• Real-time price and transaction information

• Stable error handling

License

MIT License