koreanpulse
MCP server — activist & foreign-holder filing tagging for KRX

When KCGI or Elliott files a 5%-rule disclosure on a Korean stock, your AI assistant sees it in English — tagged, not raw.

koreanpulse is an MCP server that tags Korean DART filings by known activist investors (KCGI, Align Partners, Elliott, ValueAct, Truston, Anda, Cha, VIP…) and global foreign holders (BlackRock, Vanguard, Norges Bank, GIC, Temasek…) — translated to English, callable from Claude Desktop or Cursor. The tagging runs on the hosted service, which is paused since 2026-09-21; a self-hosted install covers the 5 free tools.

DART publishes activist 5% disclosures in hours, but the raw feed is Korean text with no entity tagging. Identifying whether a filing is KCGI or a passive retail holder requires a maintained Korean-name allowlist and filer-of-record disambiguation that the raw API does not provide. That classification is what koreanpulse ships.

The same server also surfaces foreign 5%-rule entries whose filer matches a maintained list of sovereign wealth funds, global asset managers, and hedge funds. koreanpulse translates, tags, and filters the primary-source DART feed and links every item to the original filing — inside your AI workflow.

Hosted endpoint paused. The hosted MCP endpoint mcp.koreanpulse.dev/mcp has been paused since 2026-09-21. Use the self-hosted install: pip install koreanpulse with your own DART API key for the 5 free tools. The 2 license-gated tools run only on the hosted service and are unavailable while it is paused (see the self-hosting guide). The free daily snapshot at /today is unaffected.

Beta — DART queries (the 5 free tools) work now in a self-hosted install. Activist + foreign-holder tagging is paused with the hosted service. Watchlist polling and alert dispatch are planned and not yet available.

What this looks like in practice

Two real 5%-rule filings from July 2026, exactly as the classifier tags them (verify both on DART via the receipt numbers):

1. Hanyang Securities 한양증권 (001750)
   Filer: 케이씨지아이제2호사모투자 → tagged ACTIVIST — KCGI
   Type:  주식등의대량보유상황보고서(일반)
          → "Report on Large Holdings of Stocks, Etc. (General)"
   Filed: 2026-07-15 | DART receipt 20260715000397
   https://dart.fss.or.kr/dsaf001/main.do?rcpNo=20260715000397

2. Coway 코웨이 (021240)
   Filer: 얼라인파트너스자산운용 → tagged ACTIVIST — Align Partners
   Type:  주식등의대량보유상황보고서(일반)
   Filed: 2026-07-07 | DART receipt 20260707000434
   https://dart.fss.or.kr/dsaf001/main.do?rcpNo=20260707000434

Every 5%-rule filer — passive fund, individual, or activist — uses this
same DART filing type, and the raw feed names the filer in Korean
free text only. koreanpulse tags the filer against a maintained
allowlist of named funds; filers not on the list are left untagged,
never guessed.

Real filings, reproducible with monitor_activist_investors (allowlist matching on the filer of record). Company names translated automatically. Not investment advice.

Why now

Foreign access to KRX keeps getting easier

  • 2023-12-14: the Investor Registration Certificate (IRC) requirement for foreign investors was abolished, removing the decades-old registration step for direct KRX access.
  • 2026-04: Hana Securities and Futu Securities launched Korean stock trading for Futu's Hong Kong retail customers.
  • 2026-05: Samsung Securities and Interactive Brokers launched a Korean stock trading pilot for IBKR customers.

More foreign investors can reach KRX directly, while the primary disclosure source (DART) remains Korean-only. That English-language gap is what koreanpulse works on.

Why people are paying attention to KRX

  • The activist signal is in the filing, but the entity is not. DART 5%-rule filings name the filer in Korean only. Whether “국내투자자” is KCGI building a position or a retail investor crossing a reporting threshold is not labelled anywhere in the raw feed. koreanpulse maintains the allowlist and disambiguates on every pull.
  • English IR gap is structural. KRX itself, ASIFMA, Wellington, Aberdeen, Matthews Asia all on record: Korean disclosure flow into English is structurally inadequate. We are anchored on this gap.
  • Real-time on-chain-style disclosures. DART publishes activist 5% filings, insider trades, and major decisions in hours. Closer to a blockchain explorer than to quarterly 10-Qs.
  • MSCI Developed Market reclassification path. Korea has been under review for reclassification — one of the reasons global investors track Korean market-access changes.
  • K-themes are global themes. HBM, EV batteries, K-defense, K-biotech, K-content, shipbuilding — same trades you already follow on US tape, with different microstructure and faster filings.
  • Disclosure-driven market. Korean small/mid caps are heavily covered by retail flow that reacts to DART disclosures — reading the filing itself, fast, matters more here than in most markets.

How koreanpulse compares

There are a handful of Korean-data MCP servers in the wild. Pick the one that matches your job. We focus on English-first equity data with allowlist-based filer tagging (hosted service only, paused since 2026-09-21; a self-hosted install covers the 5 free tools). If you need raw KRX OHLCV or Korean-language financial statement tables, others do that better.

Capabilitykoreanpulsekorea-stock-mcp
jjlabsio
korean-dart-mcp
chrisryugj
openregistry
Transport✓ Streamable HTTP + SSEstdio only (npx)stdio only (npx)✓ Streamable HTTP
Hosted endpointmcp.koreanpulse.dev/mcp paused since 2026-09-21— (self-install)— (self-install)✓ openregistry.sophymarine.com
1-click connect (ChatGPT / Claude.ai)Paused since 2026-09-21No (stdio)No (stdio)✓ Yes
Activist filer tagging (allowlist)
KCGI, Align, Truston, Anda, Cha, VIP, Life, Platform, Must, Dalton, FCP, Oasis, Palliser, Whitebox, City of London, ValueAct, Elliott
✓ 17 labels (hosted only; paused)— raw filings only— raw filings only— registry data only
Foreign-holder 5%-rule allowlist
BlackRock, Vanguard, Norges, GIC, Temasek + 15 more
✓ 20 labels (hosted only; paused)— raw filings only— raw filings only— registry data only
English-first docstrings (LLM-friendly)✓ All toolsKorean primaryKorean primary✓
Korean→English translation inside tool responses
filing titles + company names translated in the returned data, not just in the docs
✓ Hosted translation cache— data returned in Korean— data returned in Korean— registry data only
Correction-filing linkage
정정공시 tagged and linked back to the filing it corrects
✓ is_correction + previous_receipt_no fields— not linked— not linked— registry data only
Korean industry news (etnews / 한국경제 / Korea Herald / ZDNet Korea RSS, EN)✓ 16 industries———
KRX OHLCV (daily prices)— out of scope✓ KOSPI / KOSDAQ——
XBRL financial statements— out of scope✓✓—
HWP / PDF attachment → markdown— out of scope—✓—
Multi-user architecture
One endpoint, N AI agents in parallel
N→1 hosted design (one shared DART key, cached); endpoint paused since 2026-09-211:1 (one process per user on user's machine)1:1 (one process per user on user's machine)✓ Hosted
DART API key required from end userYes while the hosted endpoint is paused (the hosted design used a shared key)Yes (each user signs up)Yes (each user signs up)No
PricingFree 5 tools · Solo $29 · Analyst $79 · Desk $249/moFree OSS (BYO API keys)Free OSS (BYO API keys)Free anonymous tier

Comparison last verified 2026-07-19 — other projects may have shipped changes since. Other servers in the space: OldTemple91/korea-filings-api (English summaries, pay-per-call), SongT-50/korean-stock-mcp, koreal6803/finlab-ai (quant-focused), eddmpython/dartlab (Python lib). The MCP-server space for Korean equities is shaped by the underlying data scope, not by any one team — pick what fits your workflow.

Where official English disclosure ends. KRX's mandatory English-disclosure regime reaches only the largest listed issuers; most KOSDAQ and small/mid-cap filings have no official English version. koreanpulse translates the DART feed itself, so English coverage does not stop where the mandate does.

Free public daily snapshot

Updated KST 16:30 every weekday at koreanpulse.dev/today: foreign-holder 5%-rule disclosures (BlackRock, Vanguard, Norges, GIC, Temasek, Goldman, JPM, Morgan Stanley…), Korean activist filings, major DART disclosures — all summarised in English. Public, no login. The page shows its data date and flags itself when a snapshot is stale.

Machine-readable JSON at /today.json. Last 30 days at /today/YYYY-MM-DD.

Beta — what works now vs. what is planned

Available now

  • 5 free tools: DART filings, company/ticker resolution, industry news, server info
  • Hosted English translation for filing titles
  • Public daily snapshot at /today

Not yet available (planned)

  • Continuous watchlist polling
  • Discord / Telegram / Email / Slack alerts
  • Saved searches, CSV/JSON export
  • Archive search & retention windows
  • Team seats & shared watchlists

Paused since 2026-09-21: the 2 license-gated tools (monitor_activist_investors, monitor_foreign_holders) run only on the hosted service and are unavailable to everyone, license holders included, until it resumes.

Until the planned features ship, the runtime differences between paid tiers are the monthly query cap (2K / 15K / 100K) and support level — most tier differentiation is roadmap. If a planned feature matters to you, wait for it to ship before subscribing, or ask us first.

Pricing

Solo $29/mo is the plan for the two allowlist-tagging tools (activist + foreign-holder), which run only on the hosted service and are unavailable while it is paused since 2026-09-21. Checkout is closed while the hosted endpoint is paused; plan names and prices are kept below for when it resumes. Watchlist polling and alert dispatch are planned and not yet available — early subscribers keep their signup rate when those features land.

What you get without a license
5 free MCP tools — raw DART surface
  • · track_korean_filings — raw DART filings, optionally translated
  • · lookup_corp_code — Korean name → DART corp code
  • · resolve_stock_code — KRX 6-digit ticker → corp entry
  • · search_korean_industry_news — etnews / 한국경제 RSS, 16 industries
  • · koreanpulse_about — server info, free vs paid tool list

The hosted endpoint (mcp.koreanpulse.dev/mcp) is paused since 2026-09-21. Self-install with pip install koreanpulse and your own DART API key to use these tools.

What Solo $29/mo+ unlocks
2 paid MCP tools — classification work
  • · monitor_activist_investors — Korean activist filer match (KCGI, Align Partners, Truston, Anda, Cha, VIP, Life, Platform, Must, Dalton, FCP, Oasis, Palliser, Whitebox, City of London, ValueAct, Elliott)
  • · monitor_foreign_holders — global allowlist match (BlackRock, Vanguard, Norges, GIC, Temasek, State Street, Fidelity, Capital Group, T. Rowe Price, Wellington, Goldman, JPMorgan, Morgan Stanley, Citadel, Millennium, Bridgewater + others)

These two classifications are not derivable from the raw DART feed — they require a maintained allowlist + Korean-name normalisation + filer-of-record disambiguation. That work is what your $29/mo pays for.

These tools run only on the hosted service. They are unavailable while it is paused (since 2026-09-21), and a self-install does not include them.

What the license gate returns without a key

Calling a license-gated tool without a license_key never fails silently — the tool returns this notice, which your AI client relays:

`monitor_activist_investors` requires a license key. Pass a
`license_key` argument when calling this tool. The activist /
foreign-holder allowlist tagging runs server-side on the hosted
koreanpulse service. OSS self-host (github.com/whdrnr2583-cmd/
koreanpulse + your own DART API key) is free but does NOT include
this allowlist tagging, so self-hosting will not unlock this tool.

How the surrounding assistant text reads varies by client and model. Once checkout reopens, your license key arrives by email.

Cloud Solo
$29/mo
Individual traders, solo analysts
  • ·Unlocks 2 paid MCP tools (hosted service only; paused since 2026-09-21): monitor_activist_investors + monitor_foreign_holders
  • ·Korean activist filer match — KCGI / Align Partners / Truston / Anda / Cha / VIP / Life / Platform / ValueAct / Elliott
  • ·Foreign-holder allowlist — BlackRock / Vanguard / Norges / GIC / Temasek / Goldman / JPM + 13 more
  • ·Hosted translation cache (no OpenAI key needed)
  • ·~2,000 queries/mo (metered; paused with the hosted service)
  • ·5 watchlists (planned — not yet available)
  • ·30-day archive search (planned — not yet available)
  • ·1 Discord or Telegram alert channel (planned — not yet available)
  • ·Daily English digest (available now)
Paused — checkout closed while the hosted endpoint is paused
Cloud Analyst
$79/mo
Boutique fund analysts, paid-research-budget retail
  • ·Everything in Solo (2 paid MCP tools + classification)
  • ·~15,000 queries/mo (metered; paused with the hosted service)
  • ·25 watchlists (planned — not yet available)
  • ·1-year archive search (planned — not yet available)
  • ·Multi-channel alerts (Discord / Telegram / Email) (planned — not yet available)
  • ·Saved searches (planned — not yet available)
  • ·CSV / JSON export (planned — not yet available)
  • ·Priority cache + priority refresh
Paused — checkout closed while the hosted endpoint is paused
Cloud Desk
$249/mo
Small research teams, boutique long/short desks
  • ·Everything in Analyst (2 paid MCP tools + classification)
  • ·~100,000 queries/mo (metered; paused with the hosted service)
  • ·3 seats, shared watchlists (planned — not yet available)
  • ·Slack / webhook alerts (planned — not yet available)
  • ·Team archive (planned — not yet available)
  • ·Priority support
Paused — checkout closed while the hosted endpoint is paused

After subscribing (once checkout reopens). Polar emails your license key (format kp_…) to the checkout email. Pass it as a tool argument when calling monitor_activist_investors or monitor_foreign_holders in Claude.ai, ChatGPT, Cursor, or the OpenAI Responses API — e.g. {license_key: "kp_…", ticker: "005930"}. A stdio env-var option and one-time HTTP Bearer config are planned but not yet available; for now, include the key per-prompt or in your client's system prompt.

Paid Cloud plans are paused while the hosted endpoint is paused (since 2026-09-21): a Cloud license cannot currently be used on the hosted endpoint, and the local stdio install does not include the two license-gated tools; hosted translation uses our OpenAI key and validates your license, so no OpenAI key is needed on your side. Enterprise / SLA: contact us.

By subscribing you agree to our Terms of Service and Privacy Policy. koreanpulse provides disclosure data, translation, filtering, and tagging only — not investment advice. It does not execute trades or provide personalized buy/sell recommendations.

Hosted endpoint for ChatGPT / Claude.ai: paused

The hosted remote MCP endpoint https://mcp.koreanpulse.dev/mcp has been paused since 2026-09-21 and is not accepting connections, so it cannot be added as a custom connector in ChatGPT, Claude.ai or the OpenAI Responses API right now. To use the 5 free tools (DART filings, company and ticker lookup, Korean industry news, server info), run the server yourself: pip install koreanpulse and the local stdio path below. The 2 license-gated tools (foreign-holder + activist tracking) run only on the hosted service and are unavailable while it is paused. Read-only data layer; not investment advice.

Run it yourself (OSS)

Source is AGPL-3.0. Self-hosters can run the MCP server locally with their own DART and OpenAI keys — community support only, no hosted archive, no shared translation cache, no alerts. This path is for hackers and max-privacy users; the paid Cloud tiers above are where the planned watchlist-to-alert workflow will land once polling and dispatch ship.

What runs under the hood

7 MCP tools split into 5 free (raw DART + RSS surface, no signup) and 2 license-gated — 5%-rule foreign-holder and Korean activist filer matching against a maintained allowlist; they run only on the hosted service, which is paused since 2026-09-21. Calling a gated tool without a license returns a clear license-required notice (shown above), never a silent failure.

Free (no signup)

track_korean_filings

DART filings as disclosed, optionally translated to English. Every item links to the original filing.

search_korean_industry_news

etnews + 한국경제 RSS classified into 16 industries (semis, batteries, defense, biotech…).

lookup_corp_code

Korean company name → DART corp code. Resolves Hangul or romanized spellings.

resolve_stock_code

KRX 6-digit ticker → DART corp entry. Pairs cleanly with track_korean_filings.

koreanpulse_about

Server self-description — tool catalog, free vs license-gated split, data sources.

Paid (Solo $29/mo or higher; hosted service only, paused)

monitor_foreign_holders

Foreign 5%-rule filings tagged against a maintained list — BlackRock / Vanguard / Norges / GIC / Temasek / Goldman / JPM + 13 more.

monitor_activist_investors

Activist 5%-rule filings auto-tagged for KCGI / Align / Anda / Cha / Truston / Life / Platform / VIP, plus international ValueAct + Elliott.

Planned, not yet available: summarize_korean_earnings_call, get_ma_pipeline, track_government_policy, and webhook alert delivery (Discord / Telegram / Slack).

Get notified at launch

One email when the planned watchlist-alert workflow ships. The role field is optional — it helps us figure out who's actually showing up.

Not investment advice.

koreanpulse provides translated and classified primary-source data from Korean public filings (DART) and Korean industry news. It is not investment advice and does not constitute a recommendation to buy, sell, or hold any security. The service performs no individualized analysis or personalized recommendation. All output is general data routing intended for informational purposes only. You are responsible for your own investment decisions and should consult a licensed financial advisor where appropriate.

koreanpulse는 한국 공시시스템(DART) 및 한국 산업 뉴스의 1차 자료를 영어로 번역·분류하여 제공하는 데이터 서비스이며, 투자자문 또는 투자권유에 해당하지 않습니다.

Guides