MCP.so
Sign In

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

@migusdn

Repository

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

한국투자증권 mcp server

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

A server that exposes Korea Investment & Securities (KIS) REST APIs as MCP tools. It provides catalog-based general tools and convenience tools for domestic/overseas stock inquiry, account inquiry, and order placement. Designed for developers and traders using MCP-compatible clients.

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

Install dependencies with uv sync, create a .env file with KIS_APP_KEY, KIS_APP_SECRET, KIS_CANO, KIS_ACNT_PRDT_CD, and optionally KIS_ENABLE_TRADING for order APIs. Run with uv run python server.py. Configuration can also be provided via command-line arguments. Supports stdio, sse, and streamable-http transports.

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

  • 166 REST APIs across 8 groups (stock, bond, futures, etc.)
  • Catalog-based tools: list-kis-api-specs, get-kis-api-spec, call-kis-api
  • Convenience tools for frequently used domestic/overseas stock functions
  • Automatic account number and token caching
  • Safety gate blocks trading APIs by default
  • Supports stdio, sse, streamable-http transports
  • Lightweight catalog mode reduces MCP tool context usage

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

  • Query domestic stock current price (e.g., Samsung Electronics)
  • Retrieve domestic stock balance and order history
  • Place buy/sell orders for domestic or overseas stocks
  • Check overseas stock balance and purchasable amount
  • Automate portfolio monitoring with AI assistants

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

How do I enable trading (order) APIs?

Set the environment variable KIS_ENABLE_TRADING=true before running the server. Without this, all order, correction, and cancellation APIs are blocked.

What transports are supported?

The server supports stdio (default), sse, and streamable-http transports. Use MCP_TYPE=sse or MCP_TYPE=streamable-http to switch, along with MCP_HOST, MCP_PORT, and MCP_PATH as needed.

What is the catalog toolset mode?

Setting KIS_MCP_TOOLSET=catalog exposes only three catalog tools (list-kis-api-specs, get-kis-api-spec, call-kis-api), reducing context usage while still allowing access to all 166 APIs via the generic call-kis-api tool.

Is this an official Korea Investment & Securities product?

No. This is an unofficial community open-source project. It is not affiliated with, endorsed by, or sponsored by KIS, KIS Developers, or true friend 한국투자증권 Open API.

What are the minimum Python and dependency requirements?

Python >= 3.13 and uv are required. Install dependencies with uv sync.

Frequently asked questions

How do I enable trading (order) APIs?

Set the environment variable `KIS_ENABLE_TRADING=true` before running the server. Without this, all order, correction, and cancellation APIs are blocked.

What transports are supported?

The server supports `stdio` (default), `sse`, and `streamable-http` transports. Use `MCP_TYPE=sse` or `MCP_TYPE=streamable-http` to switch, along with `MCP_HOST`, `MCP_PORT`, and `MCP_PATH` as needed.

What is the `catalog` toolset mode?

Setting `KIS_MCP_TOOLSET=catalog` exposes only three catalog tools (`list-kis-api-specs`, `get-kis-api-spec`, `call-kis-api`), reducing context usage while still allowing access to all 166 APIs via the generic `call-kis-api` tool.

Is this an official Korea Investment & Securities product?

No. This is an unofficial community open-source project. It is not affiliated with, endorsed by, or sponsored by KIS, KIS Developers, or true friend 한국투자증권 Open API.

What are the minimum Python and dependency requirements?

Python >= 3.13 and `uv` are required. Install dependencies with `uv sync`.

Comments

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

migusdn

More Developer Tools MCP servers

E

endoflife.ai

endoflife.ai

Free MCP server for software end-of-life intelligence: EOL dates, support status, and the 0-100 EOL Risk Score across 485 tracked products. Agents can check a single version, pull a product's full lifecycle schedule, or

Burp Suite MCP Server Extension

PortSwigger

MCP Server for Burp

961

Code Index MCP

johnhuang316

A Model Context Protocol (MCP) server that helps large language models index, search, and analyze code repositories with minimal setup

979

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K

Stakpak Agent CLI

stakpak

Ship your code, on autopilot. An open source agent that lives on your machines 24/7 and keeps your apps running. 🦀

1.6K