koreanpulse

Official7 tools

by whdrnr2583-cmd · Python

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

io.github.whdrnr2583-cmd/koreanpulse MCP Server

The koreanpulse MCP server provides Korean equity information in English for AI agents via MCP. It connects ChatGPT/Claude/Cursor/FastMCP agents to Korean market data, covering DART corporate disclosures, activist filings, foreign-holder classification/flows, and KRX news. It is exposed as 7 tools.

🛠️ Key Features

DART filings tracked “as they are filed”
Activist filings and activist investor campaigns
Foreign investor holding changes and foreign-holder flows
KRX news coverage
Tooling supported via MCP for agent access

🚀 Use Cases

Monitor Korean stock disclosures and filings
Track changes in foreign-holder holdings
Follow activist investor campaigns related to Korean equities
Provide Korean market context to AI trading or research agents

⚡ Developer Benefits

MCP-based integration for AI assistants
Supports agent ecosystems including ChatGPT, Claude, Cursor, and FastMCP
Enables access to Korean equity intelligence in English

⚠️ Limitations

Server scope is limited to Korean equities data sources (DART/KRX) and related classification/flows.

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 paid tool's license-required notice instead of pretending you've answered. **Batch scan for agents (experimental).** To check MULTIPLE companies for material disclosures since your last checkpoint in ONE call — instead of N separate calls — pass `company_corp_codes` (a list, ≤10) plus a `since` timestamp. This is the portfolio-monitoring / scan-since-checkpoint workflow: give it your watchlist's corp codes and the ISO timestamp of your previous check, optionally with `material_only=True`, and it returns every filing across those companies newer than that timestamp, merged and sorted newest-first. DART has no batch endpoint, so this fans out one cache-backed call per corp code — the ≤10 cap keeps a single call from blowing past DART's daily quota.

Parameters10

company_corp_code	any	optional	8-digit DART corp code (single company). Use `lookup_corp_code` first to resolve a company name. Omit to query all companies. Ignored when `company_corp_codes` (plural) is provided non-empty — the plural list takes precedence.
days	integer	optional	how many days back from today (1–30). Ignored when `since` is provided.
filing_type	any	optional	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.
limit	integer	optional	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. In batch mode (`company_corp_codes`) `limit` applies PER COMPANY, not to the merged set, so a heavy filer can never crowd a quieter company out of the results: an empty result for a company means that company genuinely filed nothing in the window. A batch call can therefore return up to `limit × len(company_corp_codes)` rows.
translate	boolean	optional	True to fill `title_en` via server-side LLM (cached).
summarize	boolean	optional	True to fill `summary_en` (≤200 words). Costs more — use sparingly. Long-form analysis should be done by the client LLM.
license_key	any	optional	subscription key. Required when KOREANPULSE_REQUIRE_LICENSE=1.
company_corp_codes	any	optional	OPTIONAL list of up to 10 corp codes for batch mode. When provided non-empty, the tool queries each corp code concurrently (one cache-backed DART call each), merges the results, and sorts newest-first — use this to scan a whole watchlist in one call. More than 10 codes raises a validation error (DART has no batch endpoint; this is N calls, so the cap protects the daily quota). Takes precedence over `company_corp_code` (singular) when both are given.
since	any	optional	OPTIONAL ISO-8601 date or datetime (e.g. '2026-05-01' or '2026-05-01T09:00:00'). When provided it is the cutoff instead of `days` — only filings with `filed_at >= since` are returned. Use it to fetch only what is new since your last checkpoint. `filed_at` is date-granular (KST), so a time component filters at day boundaries. A malformed value raises a validation error. When omitted, the `days` window is used exactly as before.
material_only	boolean	optional	OPTIONAL. When True, return only filings whose `red_flags` list is non-empty (governance/distress-tagged — see the red_flags catalog below). Applies to both single and batch queries. Reuses the existing red-flag tagging; adds no new classification.

Raw schema

{
  "type": "object",
  "properties": {
    "company_corp_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "8-digit DART corp code (single company). Use\n`lookup_corp_code` first to resolve a company name. Omit to query\nall companies. Ignored when `company_corp_codes` (plural) is\nprovided non-empty — the plural list takes precedence."
    },
    "days": {
      "default": 7,
      "type": "integer",
      "description": "how many days back from today (1–30). Ignored when `since` is\nprovided."
    },
    "filing_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "optional one-letter code:\nA=periodic, B=major event, C=issuance, D=shareholding,\nE=other, F=audit, G=fund, H=ABS, I=exchange, J=FTC."
    },
    "limit": {
      "default": 30,
      "type": "integer",
      "description": "max filings to return (≤100). DART returns most-recent first,\nso on a busy window the older end of the range is dropped first.\nNarrow `days` or `filing_type` if you need older items.\nIn batch mode (`company_corp_codes`) `limit` applies PER COMPANY,\nnot to the merged set, so a heavy filer can never crowd a quieter\ncompany out of the results: an empty result for a company means\nthat company genuinely filed nothing in the window. A batch call\ncan therefore return up to `limit × len(company_corp_codes)` rows."
    },
    "translate": {
      "default": true,
      "type": "boolean",
      "description": "True to fill `title_en` via server-side LLM (cached)."
    },
    "summarize": {
      "default": false,
      "type": "boolean",
      "description": "True to fill `summary_en` (≤200 words). Costs more — use\nsparingly. Long-form analysis should be done by the client LLM."
    },
    "license_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "subscription key. Required when KOREANPULSE_REQUIRE_LICENSE=1."
    },
    "company_corp_codes": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "OPTIONAL list of up to 10 corp codes for batch\nmode. When provided non-empty, the tool queries each corp code\nconcurrently (one cache-backed DART call each), merges the\nresults, and sorts newest-first — use this to scan a whole\nwatchlist in one call. More than 10 codes raises a validation\nerror (DART has no batch endpoint; this is N calls, so the cap\nprotects the daily quota). Takes precedence over\n`company_corp_code` (singular) when both are given."
    },
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "OPTIONAL ISO-8601 date or datetime (e.g. '2026-05-01' or\n'2026-05-01T09:00:00'). When provided it is the cutoff instead of\n`days` — only filings with `filed_at >= since` are returned. Use\nit to fetch only what is new since your last checkpoint.\n`filed_at` is date-granular (KST), so a time component filters at\nday boundaries. A malformed value raises a validation error.\nWhen omitted, the `days` window is used exactly as before."
    },
    "material_only": {
      "default": false,
      "type": "boolean",
      "description": "OPTIONAL. When True, return only filings whose\n`red_flags` list is non-empty (governance/distress-tagged — see\nthe red_flags catalog below). Applies to both single and batch\nqueries. Reuses the existing red-flag tagging; adds no new\nclassification."
    }
  },
  "additionalProperties": false
}

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.

Parameters4

query	string	required	substring of the Korean corp name. Examples: "삼성전자", "현대차", "셀트리온".
listed_only	boolean	optional	if True, only return companies with a KRX stock code.
limit	integer	optional	max matches to return.
license_key	any	optional	subscription key. Required when license gate is enabled.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "substring of the Korean corp name. Examples: \"삼성전자\", \"현대차\", \"셀트리온\"."
    },
    "listed_only": {
      "default": false,
      "type": "boolean",
      "description": "if True, only return companies with a KRX stock code."
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "description": "max matches to return."
    },
    "license_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "subscription key. Required when license gate is enabled."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

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. When the code is unresolved but looks like a Korean preferred-stock ticker (6 digits, non-zero last digit, e.g. 005935 for 삼성전자우), the response carries an additive `related_common_stock` hint pointing at the common-stock entry — the corp registry only maps common stock, so no preferred-stock corp_code is fabricated.

Parameters2

stock_code	string	required
license_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "stock_code": {
      "type": "string"
    },
    "license_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "stock_code"
  ],
  "additionalProperties": false
}

search_korean_industry_news

Korean industry news search across 16 sectors with on-demand English translation. Sources: 전자신문 (etnews) + 한국경제 (hankyung) + The Korea Herald (English-native) + 지디넷코리아 (zdnet). 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.

Parameters5

industries	any	optional	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. An unrecognized tag is never silently dropped or errored — see Returns below.
sources	any	optional	filter to source keys (etnews, hankyung, koreaherald, zdnet). None = all. koreaherald is English-native — its titles are returned as-is (no ko->en translation round-trip needed).
limit	integer	optional	max articles (≤50).
translate	boolean	optional	server-side translates `title_en` for Korean-language sources. Cached aggressively. No-op for koreaherald (already English).
license_key	any	optional	required when license gate is enabled.

Raw schema

{
  "type": "object",
  "properties": {
    "industries": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "filter to one or more industry tags. Available:\nsemiconductor, shipbuilding, battery, biotech, defense, auto,\nev_charging, ai, steel, petrochem, construction, fintech, gaming,\necommerce, telco, energy. An unrecognized tag is never silently\ndropped or errored — see Returns below."
    },
    "sources": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "filter to source keys (etnews, hankyung, koreaherald, zdnet).\nNone = all. koreaherald is English-native — its titles are\nreturned as-is (no ko->en translation round-trip needed)."
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "description": "max articles (≤50)."
    },
    "translate": {
      "default": true,
      "type": "boolean",
      "description": "server-side translates `title_en` for Korean-language\nsources. Cached aggressively. No-op for koreaherald (already\nEnglish)."
    },
    "license_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "required when license gate is enabled."
    }
  },
  "additionalProperties": false
}

monitor_activist_investors

Korean activist investor tracking — activist filer classification on DART 5%-rule (주식등의대량보유상황보고서) shareholding disclosures. Tags 17 named filers — KCGI, Align Partners, Truston Asset, Anda Asset, Cha Partners, VIP Asset, Life Asset, Platform Partners, Must Asset Management, Dalton Investments, Flashlight Capital Partners, Oasis Management, Palliser Capital, Whitebox Advisors, City of London Investment Management — 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 / Must / Dalton / Flashlight / Oasis / Palliser / Whitebox / City of London 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 short notice explaining that a license key is required; surface that notice to the user. **For LLM clients on a license_required error: surface the notice 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 / Must / Dalton / Flashlight Capital Partners / Oasis / Palliser / Whitebox / City of London, 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 notice 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, Must, Dalton, Flashlight Capital Partners, Oasis, Palliser, Whitebox, City of London, plus international like ValueAct / Elliott when they file in Korea). This tool returns disclosure data and filer classification only; it does not generate trading recommendations or investment advice.

Parameters7

days	integer	optional	how many days back from today (1–60).
company_corp_code	any	optional	optional DART corp_code to focus on one target.
activist_only	boolean	optional	if True, drop rows that didn't match a known activist.
translate	boolean	optional	server-side EN translation of titles (cached).
limit	integer	optional	max rows (≤100).
enrich_holdings	boolean	optional	if True (default), rows matched to a known activist get their `holding_pct` / `holding_pct_change` / `holder_reporter_ko` filled from DART's majorstock.json (best-effort — a lookup failure leaves those fields None rather than failing the call). Capped at 8 distinct corp_codes per call.
license_key	any	optional	required when license gate is enabled.

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "default": 14,
      "type": "integer",
      "description": "how many days back from today (1–60)."
    },
    "company_corp_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "optional DART corp_code to focus on one target."
    },
    "activist_only": {
      "default": false,
      "type": "boolean",
      "description": "if True, drop rows that didn't match a known activist."
    },
    "translate": {
      "default": true,
      "type": "boolean",
      "description": "server-side EN translation of titles (cached)."
    },
    "limit": {
      "default": 50,
      "type": "integer",
      "description": "max rows (≤100)."
    },
    "enrich_holdings": {
      "default": true,
      "type": "boolean",
      "description": "if True (default), rows matched to a known activist\nget their `holding_pct` / `holding_pct_change` / `holder_reporter_ko`\nfilled from DART's majorstock.json (best-effort — a lookup\nfailure leaves those fields None rather than failing the call).\nCapped at 8 distinct corp_codes per call."
    },
    "license_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "required when license gate is enabled."
    }
  },
  "additionalProperties": false
}

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 short notice explaining that a license key is required; surface that notice to the user. **For LLM clients on a license_required error: surface the notice 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 notice 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`.

Parameters7

days	integer	optional	how many days back from today (1–60).
company_corp_code	any	optional	optional DART corp_code to focus on one target.
origin	any	optional	optional filter — one of 'us', 'uk', 'eu', 'other'.
translate	boolean	optional	server-side EN translation of titles (cached).
limit	integer	optional	max rows (≤100).
enrich_holdings	boolean	optional	if True (default), rows get their `holding_pct` / `holding_pct_change` / `holder_reporter_ko` filled from DART's majorstock.json (best-effort — a lookup failure leaves those fields None rather than failing the call). Capped at 8 distinct corp_codes per call.
license_key	any	optional	required when license gate is enabled.

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "default": 14,
      "type": "integer",
      "description": "how many days back from today (1–60)."
    },
    "company_corp_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "optional DART corp_code to focus on one target."
    },
    "origin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "optional filter — one of 'us', 'uk', 'eu', 'other'."
    },
    "translate": {
      "default": true,
      "type": "boolean",
      "description": "server-side EN translation of titles (cached)."
    },
    "limit": {
      "default": 50,
      "type": "integer",
      "description": "max rows (≤100)."
    },
    "enrich_holdings": {
      "default": true,
      "type": "boolean",
      "description": "if True (default), rows get their `holding_pct` /\n`holding_pct_change` / `holder_reporter_ko` filled from DART's\nmajorstock.json (best-effort — a lookup failure leaves those\nfields None rather than failing the call). Capped at 8 distinct\ncorp_codes per call."
    },
    "license_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "required when license gate is enabled."
    }
  },
  "additionalProperties": false
}

koreanpulse_about

Server self-description — capability matrix, tool catalog, named-entity tag 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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

README.md29 KBView on GitHub

koreanpulse

Korean stock disclosures, activist filings & foreign-holder flows in English — for AI agents via MCP.

Korean stock market intelligence for AI assistants. koreanpulse is an MCP server that connects ChatGPT / Claude / Cursor / FastMCP agents to Korean (KRX / KOSPI / KOSDAQ) equity data — track DART corporate disclosures as they are filed, monitor foreign investor holding changes and activist investor campaigns, and search classified Korean industry news, all in English. Data and intelligence only — not buy/sell recommendations.

The goal: get pinged in English when a 5%-rule filing or DART event hits a stock you care about. (Beta — watchlist polling + alert dispatch are planned and not yet available; what works today is on-demand queries.)

The pitch: koreanpulse translates, tags, and filters Korean primary-source disclosure data — foreign-holder 5%-rule disclosures, Korean activist filings, major DART events — for AI assistants. KRX itself, ASIFMA, and several global asset managers are on record that Korean disclosure flow into English is structurally thin. Free public daily snapshot at /today; paid Cloud tiers (Solo $29/mo, Analyst $79/mo, Desk $249/mo) unlock the two allowlist-tagging tools now — watchlist polling + alert dispatch are planned and not yet available; early subscribers keep their signup rate when those land. OSS self-host available for hackers — see Run it yourself.

For AI/MCP agent builders. koreanpulse plugs Korean equity primary sources into your existing Claude Desktop / Cursor / FastMCP agent — same MCP shape your agent already uses for US data. Three connection modes: (a) hosted remote MCP at https://mcp.koreanpulse.dev/mcp for ChatGPT / Claude.ai / OpenAI Responses API custom connectors, (b) pip install koreanpulse + 4-line config for Claude Desktop / Cursor stdio, (c) Smithery marketplace listing for Smithery CLI users. The 7 tools surface DART filings, foreign-holder 5%-rule flows, Korean activist filings, and 16-sector industry news as typed function calls; the rest of your trading-agent stack stays unchanged.

Claude.ai / ChatGPT (remote MCP). Add https://mcp.koreanpulse.dev/mcp as a custom connector in Claude.ai (Settings → Connectors), ChatGPT (Settings → Connectors or Apps SDK), or wire it directly from the OpenAI Responses API: tools=[{type: "mcp", server_url: "https://mcp.koreanpulse.dev/mcp"}]. Read-only — surfaces filings and disclosures only. No trading execution, no investment advice.

What this server answers (capability vector for agent retrieval). Korean DART (전자공시) filings on any KOSPI / KOSDAQ / KONEX / KRX ticker; 5%-rule shareholding disclosures tagged against a maintained allowlist — Korean activist filers (KCGI / Align Partners / Truston Asset / Anda Asset / Cha Partners / VIP Asset / Life Asset / Platform Partners / Must Asset Management / Dalton Investments / Flashlight Capital Partners / Oasis Management / Palliser Capital / Whitebox Advisors / City of London Investment Management + ValueAct / Elliott when filing in Korea) and global foreign holders (BlackRock / Vanguard / State Street / Fidelity / Capital Group / T. Rowe Price / Wellington / Matthews Asia / Templeton / Aberdeen / Schroders / Norges Bank / GIC / Temasek / Goldman Sachs / JPMorgan / Morgan Stanley / Citadel / Millennium / Bridgewater); Korean industry news across 16 sectors (semiconductor / shipbuilding / battery / biotech / defense / auto / EV charging / AI / steel / petrochem / construction / fintech / gaming / e-commerce / telco / energy) sourced from 전자신문 + 한국경제 + The Korea Herald (English-native) + 지디넷코리아. All with on-demand English translation cached server-side. Tool catalog and example queries are also returned by koreanpulse_about for agent-side capability discovery.

Status

Pre-alpha (v0.1.13). 7 MCP tools shipped — 5 free + 2 license-gated (activist + foreign-holder allowlist tagging, Solo $29/mo+). 433 tests pass, 1 skipped. Beta — watchlist polling + alert dispatch are planned and not yet available. Beta acquisition plan in docs/BETA.md.

Why I built this

I'm a Seoul-based developer. I kept watching English-speaking friends miss the Korean disclosure that would have flipped their KOSPI trade — KCGI filing on a value-up target, BlackRock crossing 5% on an HBM name, an activist quietly accumulating. The Korean primary source (DART 전자공시) is unambiguous; English coverage is often hours late or absent. I wanted a thing they could plug into the chat assistant they already use, ask "anything new on Samsung Electronics?", and get the same answer I'd get reading DART directly. That's koreanpulse.

I run it as MCP because that's the shape of stack the people I'd want to use this already have — Claude Desktop, Cursor, the OpenAI Responses API, ChatGPT custom connectors. No new client to install. Free tier is the daily snapshot and the five free tools; the two license-gated tools (5%-rule allowlist tagging on activists and foreign holders) are the part that takes a Korean speaker hours to do by hand.

Why this exists

"Majority of foreign investors find it surprisingly difficult to penetrate the Korean hedge fund market due to its limited accessibility and availability of information in foreign language." — HedgeVista, 2025

"Published information should be made available in both Korean and English for all investors." — ASIFMA Korean Capital Markets Report, 2022

"The Korea Exchange will provide investor relations services to companies that lack the capability, particularly in English." — Wellington Management on Korea Value-Up program, 2025

The English-IR gap is multi-source verified. The triggers below sit on top of it:

Broker access keeps widening — Hana Securities × Futu launched Korean stock trading for Futu's Hong Kong retail customers (April 2026), and Samsung Securities × Interactive Brokers launched a pilot (May 2026)
KOSPI has been under review for MSCI Developed Market reclassification — one reason global investors track Korean market-access changes
IRC (Investor Registration Certificate) requirement abolished 2023-12-14, removing the decades-old registration step for foreign investors' direct KRX access
Millennium made its first Korean allocation ($250M to Billionfold) in 2025
Korean activist scene maturing (KCGI, Align Partners) + global activists filing in Korea (ValueAct, Elliott)
Korean shipbuilding, HBM, defense, biotech all globally relevant — but Korean-only sourcing
Korean retail rotated heavily out of crypto into KOSPI ($110B left Upbit/Bithumb in 2025)
Bloomberg/FactSet enterprise tier only — indie/SMB tier empty

Who pays

Audience	Plan	Why
Crypto-native rotator into KOSPI/KOSDAQ	Cloud Solo $29/mo	One Discord channel pinged on watchlist hits — that's the whole job (alerts are planned, not yet available)
Korean diaspora / overseas Korean investor	Cloud Solo $29/mo	English digest of the news they grew up reading (alert delivery planned)
K-content / EM journalist	Cloud Solo $29/mo	Replaces hours of manual translation
Boutique fund analyst covering Korea	Cloud Analyst $79/mo	Higher query cap now; watchlists / archive / multi-channel alerts are planned
Paid-research-budget retail trader	Cloud Analyst $79/mo	Higher query cap now; saved searches planned
Boutique long/short desk, small research team	Cloud Desk $249/mo	Highest query cap now; seats / shared watchlists / Slack alerts planned

The free daily snapshot at /today (no login, no API key) is the funnel front door — the same classified data the paid tools query, published once per weekday.

Design partner program available for the first 20 named seats — contact us.

Pricing

🚧 Beta. Solo $29 / Analyst $79 / Desk $249. Subscribing via Polar starts a paid monthly subscription that charges immediately at checkout; a 30-day refund window applies. What a paying user receives immediately: the two license-gated allowlist-tagging tools, hosted translation, and the metered query cap (2K / 15K / 100K). Watchlist polling, alert dispatch, seat enforcement, and per-tier retention windows are planned and not yet available — until they ship, seat counts, watchlist counts, alert-channel limits, and archive-retention windows are paper limits, and most tier differentiation is roadmap. Early subscribers keep their signup rate when those features land.

Tier	$/mo	Watchlists	Queries/mo	Archive	Alert channels
Cloud Solo	29	5 (planned)	~2,000 (metered)	30 days (planned)	1 Discord or Telegram (planned)
Cloud Analyst	79	25 (planned)	~15,000 (metered)	1 year (planned)	Multi (Discord / Telegram / Email) (planned)
Cloud Desk	249	shared, 3 seats (planned)	~100,000 (metered)	team archive (planned)	Slack / webhooks (planned)

30-day refund window on first payment.

Subscribe: koreanpulse.dev/#pricing — per-tier Polar checkouts (Solo / Analyst / Desk), each covered by Polar as Merchant of Record (sales tax / VAT / refunds handled). The license key is emailed by the webhook worker on subscription.created.

Enterprise / SLA: contact us. No published price.

Run it yourself (OSS)

Source is AGPL-3.0. Self-hosters can run the MCP server locally with their own DART and OpenAI keys. This path is for hackers and max-privacy users.

	OSS self-host	Cloud (Solo / Analyst / Desk)
Cost	$0	$29 / $79 / $249 per month
Provider keys	your `DART_API_KEY` + your `OPENAI_API_KEY`	your `DART_API_KEY` (stays local); we hold the OpenAI key for you
Local install required	yes (`pip install koreanpulse`)	yes (same `pip install`; only translation calls hit our Worker)
Watchlist polling + alerts	not included	planned — not yet available
Hosted archive	none	planned — not yet available (30 days / 1 year / team archive)
Hosted translation cache	none	included now (cross-tenant cache hits compound)
Account sync	none	planned — not yet available
Support	community only (issues/PRs)	priority support on Analyst / Desk
Best for	hackers, privacy-strict envs, OSS contributors	anyone who'll want the watchlist-to-alert workflow once it ships

OSS self-host is not in the pricing table above — it's a separate lane. See docs/SELF_HOSTING.md for the install + key wiring. Note: the OSS-vs-Cloud table above covers the pip-install paths. There is also a zero-install path — the hosted remote MCP at https://mcp.koreanpulse.dev/mcp answers the 5 free tools (including DART filings) with no local install and no DART API key of your own; add the URL as a custom connector in ChatGPT / Claude.ai (license-gated tools take a license_key argument).

Tools

7 MCP tools shipped — 5 free + 2 license-gated. Callable from Claude Desktop / Cursor / any MCP client. The paid tier unlocks the allowlist-tagging work that takes a Korean speaker to do by hand; the free tier ships the raw DART + RSS surface.

Free tier (no license_key, no signup):

Tool	One-line
`track_korean_filings`	Recent DART filings + EN translation/summary
`lookup_corp_code`	Korean company name → DART corp code
`resolve_stock_code`	KRX 6-digit → DART corp entry
`search_korean_industry_news`	etnews / 한국경제 / Korea Herald / zdnet RSS, classified into 16 industries
`koreanpulse_about`	Server info, free vs paid tool list

Paid tier (Solo $29/mo+, requires license_key — pass as tool argument or via the calling client's secure-input field):

Tool	One-line
`monitor_activist_investors`	Activist 5%-rule filings auto-tagged (KCGI / Align / Truston / Anda / Cha / VIP / ValueAct / Elliott)
`monitor_foreign_holders`	Foreign 5%-rule disclosures (BlackRock / Vanguard / Norges / GIC / Temasek + 15 more)

When a paid tool is called without a license, the server returns a short notice explaining that a license key is required. No checkout link is included in the tool response.

4 more planned (docs/SPEC.md): digest_analyst_reports, get_ma_pipeline, track_government_policy, summarize_korean_earnings_call.

Differentiation vs incumbents

	Bloomberg	FactSet	KED Global	koreanpulse
Korean primary source depth	medium	medium	English wire only	deep
Real-time AI agent integration (MCP)	none	none	none	native
Indie/SMB pricing	enterprise-priced	enterprise-priced	free (low signal)	$29 / $79 / $249 Cloud tiers
Korean activist / M&A pipeline	weak	weak	reactive	proactive watch (planned)

Differentiation vs other Korean MCP servers

A handful of Korean-data MCP servers exist. Pick what matches your job. We focus on English-first equity data with allowlist-based filer tagging, served as a hosted endpoint your LLM client can connect to in one click. If you need raw KRX OHLCV or Korean-language financial-statement tables, others do that better.

Capability	koreanpulse	korea-stock-mcp (jjlabsio, 137★)	korean-dart-mcp (chrisryugj, 35★)	openregistry (sophymarine)
Transport	Streamable HTTP + SSE	stdio only (`npx`)	stdio only (`npx`)	Streamable HTTP
Hosted endpoint	`mcp.koreanpulse.dev/mcp`	— (self-install)	— (self-install)	`openregistry.sophymarine.com/mcp`
1-click connect (ChatGPT / Claude.ai)	Yes	No (stdio)	No (stdio)	Yes
Your own DART API key to start	No — hosted endpoint serves DART for you	Yes (register + configure)	Yes (register + configure)	n/a
Activist filer tagging (KCGI / Align / Truston / Anda / Cha / VIP / Life / Platform / Must / Dalton / FCP / Oasis / Palliser / Whitebox / City of London / ValueAct / Elliott)	17 labels	— raw filings only	— raw filings only	— registry data only
Foreign-holder 5%-rule allowlist (BlackRock / Vanguard / Norges / GIC / Temasek + 15 more)	20 labels	— raw filings only	— raw filings only	— registry data only
English-first docstrings (LLM-friendly)	All tools	Korean primary, English secondary	Korean primary	Yes
Korean industry news (etnews / 한국경제 / Korea Herald / zdnet RSS, EN translated)	16 industries	—	—	—
KRX OHLCV (daily prices)	— out of scope	Yes (KOSPI / KOSDAQ / KONEX)	—	—
XBRL financial statements	— out of scope	Yes	Yes	—
HWP / PDF attachment → markdown	— out of scope	—	Yes	—
Multi-user architecture (one endpoint, N AI agents in parallel)	N→1 hosted (quota-ceiling estimate ~9,500 MAU at 70% cache hit — derivation in Capacity)	1: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 user	No (free tools use our shared key)	Yes (each user signs up)	Yes (each user signs up)	No
Pricing	Free 5 tools · Solo $29 · Analyst $79 · Desk $249/mo	Free OSS (BYO API keys)	Free OSS (BYO API keys)	Free anonymous tier

Other servers in the space (different scope or smaller install base): SongT-50/korean-stock-mcp, koreal6803/finlab-ai (quant-focused), eddmpython/dartlab (Python lib). Comparison last verified 2026-05-07 — other projects may have shipped changes since.

Capacity (DART quota math)

DART caps each API key at 40,000 calls/day (verified 2026-05). We enforce a soft cap at 32,000/day (80%) with DART_DAILY_QUOTA env override.

Filing-list responses go through list_filings_cached() with a freshness-aware TTL (60s for today's window, 1h for ≤6d old, 24h for ≥7d old). Cache hits don't burn DART quota.

Cache hit	Customer ceiling/day	MAU ceiling (12mo mix)
0% (no filing cache)	32,000	~800
70% (3-mo realistic)	107,000	~9,500
85% (mature)	213,000	~19,000
95% (high reuse)	~25,000 MAU (DART-limited)	—

Hard ceiling: ~30,000 MAU per DART key. Second key (separate 사업자등록번호) required beyond that.

Forecast 12mo mix (756 MAU) sits at ~930 DART calls/day = 2.9% of soft quota with 70% cache. ~34× headroom to scale before quota engineering.

See src/koreanpulse/cache.py, src/koreanpulse/dart.py:list_filings_cached.

Roadmap

Available now: queries (DART filings, foreign-holder + activist tracking, industry news), hosted translation cache (Cloud KOREANPULSE_CACHE_MODE=hosted), /today daily snapshot, Polar → D1 license issuance (Polar is our sole billing provider and Merchant of Record), first-party hosted MCP endpoint at https://mcp.koreanpulse.dev/mcp (Streamable HTTP transport for ChatGPT / Claude.ai / OpenAI Responses API custom connectors — no pip install).

Planned — not yet available:

Watchlist polling loop (Cloudflare cron + koreanpulse.alerts)
Alert dispatch enforcement (Discord / Telegram / Slack / webhook)
Per-tier limit enforcement: watchlist count, alert-channel count, archive retention, seat count

Earlier milestones:

W1–2 ✅ project skeleton, FastMCP server, DART client, agentprod integration
W3–4 ✅ MVP: track_korean_filings, lookup_corp_code, search_korean_industry_news, translation layer with cache
W5–6 ✅ Webhook handler skeleton (license auto-issuance) — Polar billing
W5–6 ✅ Cloudflare D1-backed LicenseStore (replaces in-memory)
W7–8 ⏳ Watchlist polling + alert dispatch (planned, not yet available) — wiring cache-worker cron + daily-worker cron + koreanpulse.alerts module into the watchlist-to-alert workflow that powers Solo / Analyst / Desk. D1 schema and alert-dispatch primitives already shipped; the cron loop is the missing piece.
W7–8 digest_analyst_reports, summarize_korean_earnings_call
W9–10 Multi-seat / shared watchlists for Cloud Desk
W11–12 First paid customer

Architecture

MCP server — FastMCP (Python), runs on the user's machine over stdio. Zero hosting cost on our side. Cloud customers still install this locally; switching KOREANPULSE_CACHE_MODE=hosted routes translation calls (only) to the Worker.
Cache Worker (cache-worker/) — Cloudflare Workers + KV. Holds our OpenAI key, fronts a global translation cache, gates each call behind a license check. Free tier (100K req/day Workers + 100K read/day KV) covers paid traffic until well past $5K MRR.
Daily Worker (daily-worker/) — Cloudflare Workers + KV. Cron-driven /today dashboard build (KST 16:30 weekdays).
Webhook Worker (webhook-worker/) — Cloudflare Worker + D1 (SQLite). Handles Polar billing events (Polar is our sole billing provider, active 2026-05-06+) and /v1/validate for the Cache Worker. Replaces the old Lightsail/FastAPI/Postgres stack so the operator runs zero servers.
Reuses agentprod — Throttle, Retry, CostTracker.

OSS self-host vs Cloud

Two ways to run the MCP, switched via KOREANPULSE_CACHE_MODE. Both require a local install (pip install koreanpulse + 4-line Claude Desktop config); the difference is whether translation calls go through our Worker or directly to OpenAI from your machine.

(Quick-start comparison also appears in "Run it yourself" above — keep both in sync when editing.)

	`local` (OSS self-host)	`hosted` (Cloud Solo / Analyst / Desk)
Local MCP install	required	required (same `pip install`)
Provider key	your `OPENAI_API_KEY`	ours, on the Worker (no OpenAI key on your side)
Translation cache	local JSONL file	global Cloudflare KV (cross-tenant reuse)
Per-call cost	OpenAI billed to you	absorbed in your Cloud plan
Privacy	translation never leaves your machine + OpenAI	translation calls go to our Worker; DART traffic still local
Best for	hackers, OSS contributors, max-privacy envs	anyone who'll want the watchlist-to-alert workflow once it ships

Cache hits are the entire reason a $29/mo Solo plan can sustain healthy gross margin: the same Korean filing title gets translated once, then served to every other tenant on the same plan from KV. See docs/CLAUDE_DESKTOP.md for the env-var split between modes.

Hosted HTTP transport (no local install). First-party endpoint at https://mcp.koreanpulse.dev/mcp (Streamable HTTP, single-region node fronted by Caddy + Let's Encrypt cert). Add as a custom connector in ChatGPT (Settings → Connectors), Claude.ai (Settings → Connectors), or wire it directly from the OpenAI Responses API. Last validated end-to-end against ChatGPT and Claude.ai on 2026-05-06 — monitor_activist_investors chains lookup_corp_code and returns Korean→English translated 5%-rule filings without any client-side install. The local stdio install path remains canonical for self-hosters and max-privacy users; the Smithery listing keeps Smithery CLI users in the discovery path.

Legal posture

Korean news: short summaries with attribution + outbound links only, no full-text republication. Summaries are generated from public RSS feed metadata.
DART data: retrieved via the DART open API with attribution; every item links to the original filing. Underlying filings remain subject to their own applicable rules.
Korean broker reports: not ingested (paywalled reports excluded).
No spatial / mapping data is used.
Not investment advice. koreanpulse provides disclosure data, translation, filtering, and tagging. It does not execute trades and does not provide personalized buy/sell recommendations; no individualized analysis is performed. All output is general data intended for informational purposes only.
Users should assess the licensing, data-use, and financial-services obligations that apply to their own jurisdiction and use case, especially when redistributing data downstream. Nothing in this repository is legal advice.
Privacy + data protection: see https://koreanpulse.dev/privacy — covers Korea PIPA, EU GDPR, US CCPA. Terms of service: https://koreanpulse.dev/terms.

Billing (Polar — active provider)

Billing runs on the webhook-worker/ Cloudflare Worker + D1 (SQLite). The operator runs zero servers.

Active provider: Polar (polar.sh) — Merchant of Record since 2026-05-06. Handles VAT / sales tax / refunds / chargebacks for all subscriptions. License keys are emailed automatically on subscription.created via the webhook worker.

Lemon Squeezy: not in use. Their store application was declined on 2026-05-06; we did not appeal. No LS variant secrets are configured in production and no LS webhook deliveries are accepted. The /webhook/lemonsqueezy handler code remains in the repo only as a historical implementation reference — Polar is the sole billing provider.

See webhook-worker/README.md for the full deploy + secrets walkthrough; the short version:

bash

cd webhook-worker
npm install
npx wrangler d1 create koreanpulse_db   # paste returned id into wrangler.toml
npm run migrate:prod                     # applies 0001_licenses.sql + 0002_pricing_v2.sql

# ── Polar (active provider) ──────────────────────────────────────────
npx wrangler secret put POLAR_WEBHOOK_SECRET    # `polar_whs_...` from Polar webhook page
npx wrangler secret put POLAR_API_TOKEN         # `polar_oat_...` (subscriptions:read scope)
npx wrangler secret put POLAR_PRODUCT_SOLO      # UUID of Cloud Solo product
npx wrangler secret put POLAR_PRODUCT_ANALYST   # UUID of Cloud Analyst product
npx wrangler secret put POLAR_PRODUCT_DESK      # UUID of Cloud Desk product

# ── Shared ───────────────────────────────────────────────────────────
npx wrangler secret put KOREANPULSE_CACHE_SHARED_SECRET   # same value cache-worker uses

npm run deploy

Endpoints (deployed to https://api.koreanpulse.dev or https://koreanpulse-webhook.<account>.workers.dev):

GET /health → {"status":"ok"}
POST /webhook/polar → Standard Webhooks signature verified (webhook-id / webhook-timestamp / webhook-signature), idempotent on webhook-id
POST /webhook/lemonsqueezy → not in use (handler retained as historical reference — see Billing note above)
POST /v1/validate → HMAC-signed by the cache-worker, validates license + atomically increments period counter

Polar events handled: subscription.created / .active / .updated / .canceled / .revoked. Auto-issues license keys, upgrades plans in place, deactivates on cancellation. License rows are tagged with metadata.provider = "polar" so the source is traceable per row.

The earlier path (Python koreanpulse-webhook FastAPI on Lightsail + Postgres) is superseded as of 2026-05-05; for operator memory it lives at docs/legacy/POSTGRES_LIGHTSAIL.md. New deploys should use the Cloudflare Worker path.

Distribution / marketplaces

Listing copy + submission checklists in docs/MARKETPLACE.md:

First-party hosted endpoint — https://mcp.koreanpulse.dev/mcp (ChatGPT / Claude.ai / OpenAI Responses API custom connectors)
Smithery — marketplace listing for Smithery CLI users
PulseMCP — not yet submitted (deferred)
Glama — live (auto-discovered, score badge)
Awesome MCP — PR #5893
MCP Market — Smithery ingest (auto)
mcp.so — live (manual submission)
MCP Registry (registry.modelcontextprotocol.io) — published

Beta acquisition (50 users in 30 days) plan + crypto-native channel mix in docs/BETA.md. Demo recording script in docs/DEMO.md. CI / PyPI release pipeline in docs/CI.md.

Alert primitives (library — the hosted watchlist→alert loop is not yet available)

The koreanpulse.alerts module ships the dispatch primitive that the planned watchlist workflow will use. koreanpulse.alerts.send_alert(url, title=, body=) sends to any of:

Discord webhooks (https://discord.com/api/webhooks/...)
Slack incoming webhooks (https://hooks.slack.com/services/...)
Telegram bots (shortcut tg://<bot_token>/<chat_id> or full sendMessage URL)

Fire-and-forget — transport / formatting failures return AlertResult(ok=False) instead of raising, so an outage in one channel never breaks a tool call. See src/koreanpulse/alerts.py.

Example prompts

Copy-paste these into Claude.ai, ChatGPT, or any MCP client connected to https://mcp.koreanpulse.dev/mcp:

code

Ask Claude: "What DART filings were submitted for Samsung Electronics in the last 7 days?"

code

Ask Claude: "Look up the DART corp code for Kakao and show me its latest disclosures."

code

Ask Claude: "Any Korean semiconductor news this week from 전자신문?"

code

Ask Claude: "Which activist investors filed 5%-rule disclosures on KOSPI stocks this month? [license_key: YOUR_KEY]"

code

Ask Claude: "Show me recent foreign-holder 5%-rule filings — has BlackRock or Norges Bank crossed any thresholds? [license_key: YOUR_KEY]"

The first three prompts use free tools (no signup). The last two use the activist and foreign-holder allowlist tagging and require a Solo $29/mo license key — the server returns a short notice explaining that a license key is required if license_key is missing (no checkout link in the response).

License

Source: AGPL-3.0-or-later. Hosted service: commercial.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. It is distributed WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See LICENSE for the full text, or https://www.gnu.org/licenses/.

Install

Tools (7)

track_korean_filingslookup_corp_coderesolve_stock_codesearch_korean_industry_newsmonitor_activist_investorsmonitor_foreign_holderskoreanpulse_about

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.koreanpulse.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

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.

io.github.whdrnr2583-cmd/koreanpulse MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

track_korean_filings

lookup_corp_code

resolve_stock_code

search_korean_industry_news

monitor_activist_investors

monitor_foreign_holders

koreanpulse_about

koreanpulse

Status

Why I built this

Why this exists

Who pays

Pricing

Run it yourself (OSS)

Tools

Differentiation vs incumbents

Differentiation vs other Korean MCP servers

Capacity (DART quota math)

Roadmap

Architecture

OSS self-host vs Cloud

Legal posture

Billing (Polar — active provider)

Distribution / marketplaces

Alert primitives (library — the hosted watchlist→alert loop is not yet available)

Example prompts

License

Install

Remote endpoint

Related servers