remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Integrates with Python 3.13+ as the required runtime environment for the MCP server, as indicated by both the badge and requirements section.
Uses Shields.io badges to display Python version requirements and license information in the README.
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 KeyKIS_APP_SECRET: Korea Investment & Securities Secret KeyKIS_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
This server cannot be installed
A Model Context Protocol server for interacting with Korea Investment & Securities (KIS) REST API, enabling domestic and foreign stock trading, price checks, and account management.