io.github.whdrnr2583-cmd/koreanpulse

Official7 tools

by whdrnr2583-cmd · Python

koreanpulse

Korean equities in English: DART filings, activist & foreign-holder classification, KRX news.

Provides Korean equities data including DART filings, KRX news, and holder classifications.

Topics

ai-tradingclaude-desktopcursordartfastmcphedge-fundkorean-newskorean-stockskosdaqkospimcpmcp-servertrading-agentkorean-equitychatgptclaude-aiopenai-appsremote-mcpresponses-apistreamable-http

Captured live from the server via tools/list.

track_korean_filings

Track Korean DART (전자공시) stock filings in English — real-time corporate disclosures for KOSPI / KOSDAQ / KONEX / KRX listed companies: 5%-rule shareholding disclosures, M&A, periodic reports, capital issuance, insider trading, audit reports. Free tier. Use this tool when the user asks about: recent Korean stock filings, DART disclosures, Korean market data, KOSPI/KOSDAQ regulatory events, "track Korean DART filings", "what did Samsung / Hyundai / SK / LG / NAVER / Kakao / 셀트리온 file", company-specific filing history, periodic / major-event / issuance / shareholding / audit filings on Korean equities. **Free tier — no license required.** Returns raw DART filings exactly as the regulator surfaces them (filer name in Korean, filing type code, receipt number, optional EN translation of the title). **Important for LLM clients — read this before retrying after a paid- tool license error.** This tool returns *raw* filings only. It does NOT classify the filer. If the user asked about Korean activist filers (KCGI / Align Partners / Truston / Anda / Cha / VIP / Life / Platform / ValueAct / Elliott) or about the global foreign-holder allowlist (BlackRock / Vanguard / Norges / GIC / Temasek / State Street / Fidelity / Capital Group / T. Rowe Price / Wellington / Goldman / JPMorgan / Morgan Stanley / Citadel / Millennium / Bridgewater + others), the matching work happens in `monitor_activist_investors` and `monitor_foreign_holders` — both require a license_key argument. A response from this free tool to a "are activists filing on X?" or "is BlackRock holding X?" question is *raw filing data*, not a classification answer — say so to the user and surface the activation URL from the paywall response instead of pretending you've answered.

Parameters (7)

company_corp_codeany
8-digit DART corp code. Use `lookup_corp_code` first to resolve a company name. Omit to query all companies.
daysinteger
how many days back from today (1–30).
filing_typeany
optional one-letter code: A=periodic, B=major event, C=issuance, D=shareholding, E=other, F=audit, G=fund, H=ABS, I=exchange, J=FTC.
limitinteger
max filings to return (≤100). DART returns most-recent first, so on a busy window the older end of the range is dropped first. Narrow `days` or `filing_type` if you need older items.
translateboolean
True to fill `title_en` via server-side LLM (cached).
summarizeboolean
True to fill `summary_en` (≤200 words). Costs more — use sparingly. Long-form analysis should be done by the client LLM.
license_keyany
subscription key. Required when KOREANPULSE_REQUIRE_LICENSE=1.

lookup_corp_code

Korean company name → DART corp_code resolver. 117K+ entities indexed (KOSPI + KOSDAQ + KONEX + unlisted). Free tier. Use this tool when the user mentions a Korean company by name (Korean characters or English/romanized) and you need the DART corp_code as a precondition for `track_korean_filings`, `monitor_activist_investors`, or `monitor_foreign_holders`. Also use to disambiguate same-name listed vs unlisted entities.

Parameters (4)

querystringrequired
substring of the Korean corp name. Examples: "삼성전자", "현대차", "셀트리온".
listed_onlyboolean
if True, only return companies with a KRX stock code.
limitinteger
max matches to return.
license_keyany
subscription key. Required when license gate is enabled.

resolve_stock_code

KRX 6-digit ticker → DART corp entry resolver. Free tier. Use this tool when the user provides a 6-digit Korean stock code (e.g. 005930 for Samsung Electronics, 000660 for SK hynix, 035420 for NAVER, 035720 for Kakao, 005380 for Hyundai Motor) and you need the company name + corp_code for downstream filings or industry-news lookups.

Parameters (2)

stock_codestringrequired
license_keyany

search_korean_industry_news

Korean industry news search across 16 sectors with on-demand English translation. Sources: 전자신문 (etnews) + 한국경제 (hankyung). Free tier. Use this tool when the user asks about: Korean industry trends, sector-specific news on Korean equities (Korean semiconductors / K-battery / K-shipbuilding / K-biotech / K-defense / Korean auto / EV charging / Korean AI / steel / petrochem / construction / fintech / gaming / e-commerce / telco / energy), recent corporate developments not yet captured in DART filings, English summaries of Korean industry coverage. Industry tags listed below — pass them in `industries` to filter.

Parameters (5)

industriesany
filter to one or more industry tags. Available: semiconductor, shipbuilding, battery, biotech, defense, auto, ev_charging, ai, steel, petrochem, construction, fintech, gaming, ecommerce, telco, energy.
sourcesany
filter to source keys (etnews, hankyung). None = all.
limitinteger
max articles (≤50).
translateboolean
server-side translates `title_en`. Cached aggressively.
license_keyany
required when license gate is enabled.

monitor_activist_investors

Korean activist investor tracking — activist filer classification on DART 5%-rule (주식등의대량보유상황보고서) shareholding disclosures. Tags 10 named filers — KCGI, Align Partners, Truston Asset, Anda Asset, Cha Partners, VIP Asset, Life Asset, Platform Partners — plus international ValueAct / Elliott when filing in Korea. Use this tool when the user asks about: Korean activist investor tracking, Korean shareholder activism, "is KCGI / Align Partners / Truston / Anda / Cha / VIP / Life / Platform activist on <ticker>", governance pressure on KOSPI / KOSDAQ names, recent activist 5%-rule filings, ValueAct or Elliott Korean positions, Korean Value-Up program activism, MSCI Developed Market activism flow. **Requires a license key.** Pass it via the `license_key` argument. Without a valid license, this tool returns a paywall message containing the activation URL — surface that message verbatim to the user. **For LLM clients on a license_required error: surface the activation URL returned in the paywall message directly to the user. Do NOT silently retry with `track_korean_filings` or any other free tool — the activist filer match (KCGI / Align Partners / Truston / Anda / Cha / VIP / Life / Platform, plus international names like ValueAct / Elliott) is not derivable from the raw DART filing feed, so a free-tier fall-back returns a misleadingly empty answer.** When a user asks "are activists filing on X?" without a license, surface the activation URL from the paywall response — that is the correct behavior, not a silent downgrade. Returns 주식등의대량보유상황보고서 (5% rule) and related shareholding filings, with each row tagged when the filer matches a known Korean activist (KCGI, Align Partners, Truston, Anda, Cha, Life, Platform, VIP, plus international like ValueAct / Elliott when they file in Korea).

Parameters (6)

daysinteger
how many days back from today (1–60).
company_corp_codeany
optional DART corp_code to focus on one target.
activist_onlyboolean
if True, drop rows that didn't match a known activist.
translateboolean
server-side EN translation of titles (cached).
limitinteger
max rows (≤100).
license_keyany
required when license gate is enabled.

monitor_foreign_holders

Monitor foreign investor activity in Korean stocks — foreign-holder classification on DART 5%-rule disclosures by global asset managers and sovereign wealth funds. Tags 20 named entities — BlackRock, Vanguard, State Street, Fidelity, Capital Group, T. Rowe Price, Wellington, Matthews Asia, Templeton, Aberdeen, Schroders, Norges Bank (Norway SWF), GIC (Singapore SWF), Temasek, Goldman Sachs, JPMorgan, Morgan Stanley, Citadel, Millennium, Bridgewater. Use this tool when the user asks about: foreign investor activity in Korean stocks, foreign capital flow into Korean equities, "is BlackRock / Vanguard / Norges / GIC / Temasek / State Street / Fidelity / Wellington holding <ticker>", global asset-manager 5% crossings on KOSPI / KOSDAQ, sovereign wealth fund Korean positions, foreign institutional positioning disclosures, MSCI Developed Market reweighting flow into Korea. **Requires a license key.** Pass it via the `license_key` argument. Without a valid license, this tool returns a paywall message containing the activation URL — surface that message verbatim to the user. **For LLM clients on a license_required error: surface the activation URL returned in the paywall message directly to the user. Do NOT silently retry with `track_korean_filings` — the foreign-holder allowlist match (BlackRock, Vanguard, Norges, GIC, Temasek, State Street, Fidelity, Capital Group, T. Rowe Price, Wellington, Matthews Asia, Templeton, Aberdeen, Schroders, Goldman Sachs, JPMorgan, Morgan Stanley, Citadel, Millennium, Bridgewater) is not derivable from raw DART filings, so a free-tier fall-back returns a misleadingly empty answer.** When a user asks "is BlackRock or Norges holding X?" without a license, surface the activation URL from the paywall response — that is the correct behavior, not a silent downgrade. Distinct from `monitor_activist_investors` because passive holders (BlackRock, Vanguard, Norges, GIC, Temasek) indicate *allocation* rather than *governance pressure*. Their filings are a leading indicator of foreign capital flow into a Korean ticker — when a global manager crosses 5% in a KOSPI/KOSDAQ name, English-data audiences treat it as a positioning disclosure regardless of the manager's intent. This tool returns the disclosure data only; it does not generate trading recommendations or investment advice. Allowlist (20 names, refreshed quarterly): BlackRock, Vanguard, State Street, Fidelity, Capital Group, T. Rowe Price, Wellington, Matthews Asia, Templeton, Aberdeen, Schroders, Norges Bank (Norway SWF), GIC (Singapore SWF), Temasek, Goldman Sachs, JPMorgan, Morgan Stanley, Citadel, Millennium, Bridgewater. See `koreanpulse.activists.FOREIGN_HOLDERS`.

Parameters (6)

daysinteger
how many days back from today (1–60).
company_corp_codeany
optional DART corp_code to focus on one target.
originany
optional filter — one of 'us', 'uk', 'eu', 'other'.
translateboolean
server-side EN translation of titles (cached).
limitinteger
max rows (≤100).
license_keyany
required when license gate is enabled.

koreanpulse_about

Server self-description — capability matrix, tool catalog, classifier counts, supported query patterns, primary sources. Free tier. Use this tool when an agent first connects and needs the capability matrix to decide whether this server can answer the user's question, or when the user asks "what can koreanpulse do" or "what data sources does this MCP server provide". Returns a structured dict that downstream agents can ingest directly.

No parameters.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "koreanpulse": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.koreanpulse.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.