LS Securities OpenAPI — Korean Stocks for AI Assistants

by redoxnet

337 downloads
Not rated
GitHub

About

MCP server for LS Securities OpenAPI — Korean stock quotes, multi-timeframe charts, technical indicators, market screeners, ETF holdings, and local portfolio notes as natural-language tools for Claude Desktop, Claude Code, VS Code, and Codex. Built on .NET, distributed via NuGet

Details

Author
redoxnet
Downloads
337
Categories
Finance

- Current quote and 10-level order book for Korean stocks.
- Multi-quote comparison for up to 50 stocks.
- Daily, weekly, monthly, minute, and tick OHLCV charts.
- Technical indicators: SMA, EMA, RSI, MACD, Bollinger Bands.
- KOSPI, KOSDAQ, KOSPI200, KRX100 snapshots and history.
- Top gainers, losers, market-cap, volume, and trading-value screeners.
- ETF/ETN snapshots with holdings treemaps and NAV data.
- Local portfolio tracking stored in SQLite on your machine.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name LS Securities OpenAPI — Korean Stocks for AI Assistants
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Obtain an LS OpenAPI AppKey and AppSecretKey from openapi.ls-sec.co.kr, then configure your MCP client with the JSON snippet using the dnx command (requires .NET SDK 10 or later). Set three environment variables: LS_APPKEY, LS_APPSECRETKEY, and LS_MARKET (set to "real"). After setup, prompt your AI assistant in natural language—for example, "Show me Samsung Electronics' current quote and 10-level order book."

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ls securities openapi \u2014 korean stocks for ai assistants": {
            "lsopenapi": {
                "command": "dnx",
                "args": [
                    "RedoxNet.Mcp.LsOpenApi",
                    "--yes"
                ],
                "env": {
                    "LS_APPKEY": "<YOUR_LS_APPKEY>",
                    "LS_APPSECRETKEY": "<YOUR_LS_APPSECRETKEY>",
                    "LS_MARKET": "real"
                }
            }
        }
    }
}

McpServers

{
    "lsopenapi": {
        "command": "dnx",
        "args": [
            "RedoxNet.Mcp.LsOpenApi",
            "--yes"
        ],
        "env": {
            "LS_APPKEY": "<YOUR_LS_APPKEY>",
            "LS_APPSECRETKEY": "<YOUR_LS_APPSECRETKEY>",
            "LS_MARKET": "real"
        }
    }
}

LS Securities OpenAPI for AI assistants.

Query Korean stock quotes, order books, charts, indicators, ETF holdings, market screeners, index context, analyst opinions, short-selling trends, and local portfolio notes from Claude Desktop, Claude Code, VS Code, Codex, or any MCP-compatible client.

> ⚠️ Unofficial third-party server. Not affiliated with or endorsed by LS Securities Co., Ltd.
> This server is for information retrieval and local portfolio notes. It does not place trades or sync brokerage accounts.

Get Started



1. Get LS OpenAPI keys



Log in to openapi.ls-sec.co.kr with your LS Securities account, apply for OpenAPI access, then create an AppKey / AppSecretKey from MY > API Key 관리.

2. Configure your MCP client



Example for Claude Desktop:

``json
{
"mcpServers": {
"lsopenapi": {
"command": "dnx",
"args": ["RedoxNet.Mcp.LsOpenApi", "--yes"],
"env": {
"LS_APPKEY": "<YOUR_LS_APPKEY>",
"LS_APPSECRETKEY": "<YOUR_LS_APPSECRETKEY>",
"LS_MARKET": "real"
}
}
}
}
`

dnx requires .NET SDK 10 or later.

3. Try a prompt



> "Show me Samsung Electronics' current quote and 10-level order book."

> "Pull SK Hynix daily, weekly, and monthly charts with MA20 and RSI."

> "Find today's top trading-value stocks and analyze the strongest one."

> "Show my holdings in the semiconductor industry."

> "What are recent analyst opinion changes for Samsung Electronics?"

What You Can Ask



Quotes and Stock Lookup



- Current price and 10-level order book for a single Korean stock
- Multi-quote comparison for up to 50 stocks
- Company name to ticker lookup across KOSPI / KOSDAQ
- Company profile, PER / PBR / EPS, quarterly financials, foreign ownership, top brokers, 52-week and YTD ranges

Charts and Technical Analysis



- Daily / weekly / monthly / yearly / minute / tick OHLCV candles
- Multi-timeframe charts in one call
- SMA, EMA, RSI, MACD, Bollinger Bands, ZigZag swing context
- Token-efficient summaries and dataset handles for follow-up chart work
- Optional Plotly chart specs for MCP clients that support inline rendering

Market Context and Screeners



- KOSPI / KOSDAQ / KOSPI200 / KRX100 snapshots and history
- Industry index rankings and stocks inside an industry
- LS theme stocks and stock-to-theme lookup
- Top gainers / losers / market-cap / volume / trading-value / volume-surge screens
- Fundamentals ranking by PER, PBR, ROE, EPS, BPS, growth metrics, debt ratio, and retained earnings ratio
- Investor flow, market warnings, corporate events, new highs / lows
- Overseas index / FX / futures snapshots, including aliases such as NASDAQ, S&P 500, Dow, SOXX, USD/KRW, WTI, and gold

ETF / ETN



- ETF snapshot: NAV, tracking index, premium / discount, AUM, LPs
- ETF constituent holdings with weights, market value, cash, and bond components
- Optional Plotly treemap for supported clients

Local Portfolio Notes



- Track accounts, holdings, watchlists, and watched LS themes locally
- Buy / sell / set holdings manually with weighted average cost
- Apply local corporate actions such as split, reverse split, and bonus issue
- Filter holdings by theme or FICS industry
- Export / import a local JSON portfolio backup

Portfolio data is stored only on your machine in SQLite. It is not synced with LS Securities and does not represent live brokerage account state.

Credential Safety



LS_APPKEY and LS_APPSECRETKEY are accepted only through environment variables. They are never requested through chat, tool arguments, or MCP elicitation.

Access tokens are cached locally, but the token cache key stores only
SHA256(appkey):market; raw AppKey and AppSecretKey are not written to disk. Logs and errors mask secrets.

Tool Surface



The server exposes curated semantic tools such as:

-
ls_search_stock
-
ls_get_quote
-
ls_get_multi_quote
-
ls_get_stock_info
-
ls_get_chart
-
ls_get_top_stocks
-
ls_get_index_quote
-
ls_get_index_history
-
ls_get_industry_indices
-
ls_get_theme_stocks
-
ls_get_fundamentals_rank
-
ls_get_investor_flow
-
ls_get_etf_info
-
ls_get_etf_holdings
-
ls_holdings_list

It also includes TR catalog tools for advanced users:
ls_search_tr, ls_describe_tr, and ls_call_tr`.

For full setup instructions, host-specific config snippets, complete tool schemas, response examples, and release notes, see the GitHub repository.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.