Skip to main content
Glama
yjhann33-design

Korea Stock Insight MCP

by yjhann33-design
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DART_API_KEYYesYour free DART API key from opendart.fss.or.kr

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_today_dateA

Return today's date in KST and UTC (YYYYMMDD format).

Use before any date-range query — Korean market APIs require YYYYMMDD and KST is the trading-day timezone.

get_corp_codeA

Resolve Korean company name or stock code to DART corp_code (8-digit).

DART corp_code is the unique identifier needed for financial-statement and detailed-disclosure lookups. Accepts either a 6-digit stock code (exact match) or a Korean company name (partial, case-insensitive).

For non-Korean speakers: search the company's English name first via web search, then pass the official Korean name to this tool.

get_disclosure_listA

List recent DART disclosures for a Korean-listed company.

Returns filing metadata (date, title, type, receipt number) for the last days calendar days. Use rcept_no with get_disclosure to open a specific filing.

get_disclosureB

Fetch metadata + viewer URL for a specific DART filing.

v0.1 returns the canonical dart.fss.or.kr viewer URL. v0.2 will add in-process body extraction (DART filings are zipped XBRL).

get_financial_statementA

Full XBRL financial statements for a Korean company.

Returns every account line from the periodic report. Use get_corp_code first to resolve a name/ticker to the 8-digit corp_code.

Args: corp_code: 8-digit DART code. year: Business year (e.g. 2025). quarter: "Q1" / "H1" / "Q3" / "FY" (default "FY" = annual report). fs_div: "CFS" (consolidated, default) or "OFS" (separate).

get_stock_quoteA

Daily OHLCV bars for a Korean-listed stock (KOSPI/KOSDAQ).

Auto-detects the market by trying .KS then .KQ. Prices in KRW. v0.1 uses yfinance (no API key required); v0.2 may add official KRX OpenAPI for intraday and accurate market cap.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.1/5.0

Scored across 6 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: company code resolution, filing metadata retrieval, filing listing, financial statements, stock quotes, and date utility. No overlap or ambiguity.

Naming Consistency5/5

All tool names follow a consistent 'verb_noun' pattern in snake_case (e.g., get_corp_code, get_disclosure). This makes the tool set predictable and easy to navigate.

Tool Count5/5

With 6 tools, the server is well-scoped for its purpose. Each tool addresses a core aspect of Korean stock data access without unnecessary bloat or missing essentials.

Completeness4/5

The tool set covers key workflows: company lookup, disclosure browsing and retrieval, financial statements, stock quotes, and a date utility. Minor gaps like missing a dedicated search tool are mitigated by existing partial-match capabilities.

Resources