RedoxNet.Mcp.LsOpenApi 0.8.0

RedoxNet.Mcp.LsOpenApi

MCP server for the LS증권 OpenAPI — exposes Korean stock market data as MCP tools so AI assistants can query quotes, charts, and ETF data in natural language. v0.6 adds market context (index + industry indices + LS themes), portfolio export/import, and a freshness-tracked theme cache, on top of v0.5's local-only multi-account portfolio module.

Unofficial third-party MCP server. Not affiliated with or endorsed by LS Securities Co., Ltd. (LS증권). v0.x.x scope: read-only market data + local portfolio notes (manual entry; no broker sync, no order placement).

Install

Prerequisite. dnx is the dotnet tool launcher that ships with .NET SDK 10 or later. Install from .NET downloads if you don't have it yet. Verify with dnx --help.

dnx fetches the latest published version from NuGet on every launch — no separate install step. Wire it into your MCP host:

Claude Desktop / Claude Code

claude_desktop_config.json (Claude Desktop) or .mcp.json at your workspace root (Claude Code):

{
  "mcpServers": {
    "lsopenapi": {
      "command": "dnx",
      "args": ["RedoxNet.Mcp.LsOpenApi", "--yes"],
      "env": {
        "LS_APPKEY": "...",
        "LS_APPSECRETKEY": "...",
        "LS_MARKET": "virtual"  // "virtual" (paper) or "real" (live)
      }
    }
  }
}

Codex CLI

%USERPROFILE%\.codex\config.toml (Windows) or ~/.codex/config.toml (macOS / Linux):

[mcp_servers.lsopenapi]
command = "dnx"
args = ["RedoxNet.Mcp.LsOpenApi", "--yes"]

[mcp_servers.lsopenapi.env]
LS_APPKEY = "..."
LS_APPSECRETKEY = "..."
LS_MARKET = "virtual"  # "virtual" (paper) or "real" (live)

VS Code

Workspace .vscode/mcp.json:

{
  "servers": {
    "lsopenapi": {
      "type": "stdio",
      "command": "dnx",
      "args": ["RedoxNet.Mcp.LsOpenApi", "--yes"],
      "env": {
        "LS_APPKEY": "...",
        "LS_APPSECRETKEY": "...",
        "LS_MARKET": "virtual"  // "virtual" (paper) or "real" (live)
      }
    }
  }
}

FieldCure AssistStudio

Settings → Connect → Add MCP Server, then fill the dialog:

LS_APPKEY=...
LS_APPSECRETKEY=...
LS_MARKET=virtual

AssistStudio renders the optional Plotly chart spec from ls_get_chart inline in the chat — call it with include_chart=true (single timeframe) to get a candlestick chart directly in the conversation.

Environment variables

Credentials are accepted only through the process environment — never through chat, tool arguments, or MCP elicitation. Prompting for them in conversation would either log them or train callers to share them in transcripts, so that input path is intentionally closed off.

Local data lives at %LOCALAPPDATA%\RedoxNet\LsOpenApi\ on Windows and ~/.local/share/redoxnet/lsopenapi/ on Linux/macOS: token.db (auth cache, SHA-256 keyed) and portfolio.db (user-supplied holdings/watchlists; never read or written by tools outside the portfolio family).

Tools (main — 48 total)

v0.7 net delta: +6 new (screeners + index history + metadata refresh) − 3 Tier 2 compression. Current main also adds five wrappers — ls_get_global_market_quote (overseas index / FX / futures), ls_get_analyst_opinions (t3401), ls_get_short_selling_trend (t1927), ls_get_high_low_stocks (t1442), and ls_get_market_funds_trend (t8428). Headline pivot: natural screener questions answerable in one call — "PER 낮은 종목", "오늘 외인 매수 누구", "다음 주총 언제", "내 보유 중 관리종목". Storage hygiene: avg_price no longer drifts under split/reverse-split round-trips (schema v4 integer fractional won), ETFs stop reporting perpetual themes_pending (sentinel-row), and FICS industry classification populates stocks.industry for the new industry? filter on ls_holdings_list.

Market data (LS-backed, credentials required)

Index + industry (LS-backed)

LS themes (LS-backed)

Screeners & per-stock analytics (LS-backed)

Portfolio (local-only, no broker sync)

Manual entries persisted to portfolio.db next to token.db. List responses fall back to a quote_error envelope when LS credentials are missing, but saved data still returns.

Ambiguity policy. Reads fall back; writes require an explicit target when ambiguous. 0 accounts → RequiresAccount; 1 account → auto with applied_to echo; 2+ → AmbiguousAccount with candidates[] so the model can re-call without prompting the user. Every mutation response includes applied_to (single account) or applied_to[] with before/after snapshots (corporate actions).

Error envelopes. RequiresAccount / AmbiguousAccount / AccountNotFound / RequiresConfirmation / InsufficientQuantity / ValidationError — all carry structured fields (candidates, identifier, holding count + market value, etc.) so the LLM can recover automatically.

Full release notes: https://github.com/redoxnet/mcp-lsopenapi/blob/main/RELEASENOTES.Mcp.md

Documentation & source

• Project home: https://github.com/redoxnet/mcp-lsopenapi
• TR inventory: https://github.com/redoxnet/mcp-lsopenapi/blob/main/docs/LS-TR-INVENTORY.md
• SDK package: https://www.nuget.org/packages/RedoxNet.LsOpenApi.Core/
• License: MIT