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

Name: 한국투자증권 REST API MCP (Model Context Protocol)
Author: MCP-Mirror

@MCP-Mirror

リポジトリ

한국투자증권 REST API MCP (Model Context Protocol) について

Mirror of

#migusdn #kis #mcp #server #rest-api #stock-trading

基本情報

カテゴリ

開発者ツール

ランタイム

python

トランスポート

stdio

公開者

MCP-Mirror

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "migusdn_KIS_MCP_Server": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.