MCP.so
Sign In

한국투자증권 REST API MCP (MCP)

@migusdn

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

migusdn

About 한국투자증권 REST API MCP

한국투자증권 mcp server

한국투자증권 REST API MCP config

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

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

한국투자증권 REST API MCP tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

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.

3

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.

4

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.

5

What are the minimum Python and dependency requirements?

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

Comments

More Developer Tools MCP servers