Skip to main content
Glama

Monitor Korean activist investor disclosures

monitor_activist_investors
Read-onlyIdempotent

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 ", 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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
daysNohow many days back from today (1–60).
limitNomax rows (≤100).
translateNoserver-side EN translation of titles (cached).
license_keyNorequired when license gate is enabled.
activist_onlyNoif True, drop rows that didn't match a known activist.
enrich_holdingsNoif 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.
company_corp_codeNooptional DART corp_code to focus on one target.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "description": "A type-D filing flagged with activist-investor heuristics.",
      -      "properties": {
      -        "activist_label": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "Canonical activist name if matched (e.g. 'KCGI', 'Align Partners')."
      -        },
      -        "attribution": {
      -          "type": "string"
      -        },
      -        "corp_code": {
      -          "description": "DART 8-digit corp code",
      -          "type": "string"
      -        },
      -        "corp_name_en": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null
      -        },
      -        "corp_name_ko": {
      -          "type": "string"
      -        },
      -        "dart_url": {
      -          "description": "Human-readable DART URL",
      -          "type": "string"
      -        },
      -        "data_fetched_at": {
      -          "anyOf": [
      -            {
      -              "format": "date-time",
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "UTC timestamp this filing was live-fetched from DART (as-of time for the data). None for rows served from a cache entry written before this field existed."
      -        },
      -        "filed_at": {
      -          "format": "date-time",
      -          "type": "string"
      -        },
      -        "filer_name_ko": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "Reporting entity (DART `flr_nm`). For type-D shareholding disclosures this is typically the holder (often an activist); for periodic reports it's the company itself."
      -        },
      -        "filing_type": {
      -          "description": "DART filing type code (A–J)",
      -          "type": "string"
      -        },
      -        "filing_type_label_en": {
      -          "type": "string"
      -        },
      -        "filing_type_label_ko": {
      -          "type": "string"
      -        },
      -        "holder_reporter_ko": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "DART majorstock reporter name (`repror`) matched to this filing's filer. Same paid-tier enrichment as `holding_pct`."
      -        },
      -        "holding_pct": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "Reporter's current holding percentage from DART majorstock.json (대량보유상황보고, `stkrt`). Paid-tier enrichment on monitor_activist_investors / monitor_foreign_holders rows only; None when not looked up or no reporter match was found."
      -        },
      -        "holding_pct_change": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "Change in holding percentage versus the prior majorstock report (`stkrt_irds`). Same paid-tier enrichment as `holding_pct`."
      -        },
      -        "is_likely_activist": {
      -          "default": false,
      -          "description": "Filer name matched a known Korean activist allowlist.",
      -          "type": "boolean"
      -        },
      -        "market": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "Listing market from DART corp_cls: 'KOSPI', 'KOSDAQ', 'KONEX', or 'OTHER'. None when DART omits corp_cls."
      -        },
      -        "query_total_count": {
      -          "anyOf": [
      -            {
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "DART's reported total_count for the query that produced this filing — the full match count before `limit`/`page_count` truncation, not the number of rows returned. None on cached rows written before this field existed."
      -        },
      -        "raw_xml_url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "OpenAPI raw XML if applicable"
      -        },
      -        "receipt_no": {
      -          "description": "DART receipt number; key for fetching",
      -          "type": "string"
      -        },
      -        "red_flags": {
      -          "description": "Governance/distress tags inferred from the filing title, e.g. 'cb_issuance', 'controlling_shareholder_change', 'rehabilitation', 'audit_opinion', 'disclosure_violation', 'rights_issue', 'capital_reduction', 'management_designation', 'delisting_risk', 'trading_halt', 'reverse_split', 'short_term_borrowing', 'going_concern'. Empty when no keyword matched.",
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        },
      -        "stock_code": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "6-digit KRX stock code if listed"
      -        },
      -        "summary_en": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "LLM summary, only set when caller asks"
      -        },
      -        "title": {
      -          "description": "Filing title (Korean)",
      -          "type": "string"
      -        },
      -        "title_en": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "LLM-translated title"
      -        }
      -      },
      -      "required": [
      -        "corp_code",
      -        "corp_name_ko",
      -        "filing_type",
      -        "filing_type_label_ko",
      -        "filing_type_label_en",
      -        "title",
      -        "receipt_no",
      -        "filed_at",
      -        "dart_url",
      -        "attribution"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "string"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "description": "A type-D filing flagged with activist-investor heuristics.",
      +      "properties": {
      +        "activist_label": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Canonical activist name if matched (e.g. 'KCGI', 'Align Partners')."
      +        },
      +        "attribution": {
      +          "type": "string"
      +        },
      +        "corp_code": {
      +          "description": "DART 8-digit corp code",
      +          "type": "string"
      +        },
      +        "corp_name_en": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        },
      +        "corp_name_ko": {
      +          "type": "string"
      +        },
      +        "dart_url": {
      +          "description": "Human-readable DART URL",
      +          "type": "string"
      +        },
      +        "data_fetched_at": {
      +          "anyOf": [
      +            {
      +              "format": "date-time",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "UTC timestamp this filing was live-fetched from DART (as-of time for the data). None for rows served from a cache entry written before this field existed."
      +        },
      +        "filed_at": {
      +          "format": "date-time",
      +          "type": "string"
      +        },
      +        "filer_name_ko": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Reporting entity (DART `flr_nm`). For type-D shareholding disclosures this is typically the holder (often an activist); for periodic reports it's the company itself."
      +        },
      +        "filing_type": {
      +          "description": "DART filing type code (A–J)",
      +          "type": "string"
      +        },
      +        "filing_type_label_en": {
      +          "type": "string"
      +        },
      +        "filing_type_label_ko": {
      +          "type": "string"
      +        },
      +        "holder_reporter_ko": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "DART majorstock reporter name (`repror`) matched to this filing's filer. Same paid-tier enrichment as `holding_pct`."
      +        },
      +        "holding_pct": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Reporter's current holding percentage from DART majorstock.json (대량보유상황보고, `stkrt`). Paid-tier enrichment on monitor_activist_investors / monitor_foreign_holders rows only; None when not looked up or no reporter match was found."
      +        },
      +        "holding_pct_change": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Change in holding percentage versus the prior majorstock report (`stkrt_irds`). Same paid-tier enrichment as `holding_pct`."
      +        },
      +        "is_correction": {
      +          "default": false,
      +          "description": "True when this filing is a DART correction re-filing — its title carries a leading correction tag ([기재정정] content correction or [첨부정정] attachment correction). False for original filings.",
      +          "type": "boolean"
      +        },
      +        "is_likely_activist": {
      +          "default": false,
      +          "description": "Filer name matched a known Korean activist allowlist.",
      +          "type": "boolean"
      +        },
      +        "market": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Listing market from DART corp_cls: 'KOSPI', 'KOSDAQ', 'KONEX', or 'OTHER'. None when DART omits corp_cls."
      +        },
      +        "previous_receipt_no": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "receipt_no of the earlier filing this correction amends, resolved only when that original is present in the same fetched window (matched by corp_code + exact normalized report name + earlier receipt number). None when this is not a correction, when the original fell outside the fetched window, or when no confident match was found — a wrong link is worse than no link."
      +        },
      +        "query_total_count": {
      +          "anyOf": [
      +            {
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "DART's reported total_count for the query that produced this filing — the full match count before `limit`/`page_count` truncation, not the number of rows returned. None on cached rows written before this field existed."
      +        },
      +        "raw_xml_url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "OpenAPI raw XML if applicable"
      +        },
      +        "receipt_no": {
      +          "description": "DART receipt number; key for fetching",
      +          "type": "string"
      +        },
      +        "red_flags": {
      +          "description": "Governance/distress tags inferred from the filing title, e.g. 'cb_issuance', 'controlling_shareholder_change', 'rehabilitation', 'audit_opinion', 'disclosure_violation', 'rights_issue', 'capital_reduction', 'management_designation', 'delisting_risk', 'trading_halt', 'reverse_split', 'short_term_borrowing', 'going_concern'. Empty when no keyword matched.",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "stock_code": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "6-digit KRX stock code if listed"
      +        },
      +        "summary_en": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "LLM summary, only set when caller asks"
      +        },
      +        "title": {
      +          "description": "Filing title (Korean)",
      +          "type": "string"
      +        },
      +        "title_en": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "LLM-translated title"
      +        }
      +      },
      +      "required": [
      +        "corp_code",
      +        "corp_name_ko",
      +        "filing_type",
      +        "filing_type_label_ko",
      +        "filing_type_label_en",
      +        "title",
      +        "receipt_no",
      +        "filed_at",
      +        "dart_url",
      +        "attribution"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "string"
      +  }
      +]
  2. Changed2 schema fields changed
    • addedInput schema / properties / enrich_holdings
      Added value: +{
      +  "default": true,
      +  "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.",
      +  "type": "boolean"
      +}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "description": "A type-D filing flagged with activist-investor heuristics.",
      -      "properties": {
      -        "activist_label": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "Canonical activist name if matched (e.g. 'KCGI', 'Align Partners')."
      -        },
      -        "attribution": {
      -          "type": "string"
      -        },
      -        "corp_code": {
      -          "description": "DART 8-digit corp code",
      -          "type": "string"
      -        },
      -        "corp_name_en": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null
      -        },
      -        "corp_name_ko": {
      -          "type": "string"
      -        },
      -        "dart_url": {
      -          "description": "Human-readable DART URL",
      -          "type": "string"
      -        },
      -        "filed_at": {
      -          "format": "date-time",
      -          "type": "string"
      -        },
      -        "filer_name_ko": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "Reporting entity (DART `flr_nm`). For type-D shareholding disclosures this is typically the holder (often an activist); for periodic reports it's the company itself."
      -        },
      -        "filing_type": {
      -          "description": "DART filing type code (A–J)",
      -          "type": "string"
      -        },
      -        "filing_type_label_en": {
      -          "type": "string"
      -        },
      -        "filing_type_label_ko": {
      -          "type": "string"
      -        },
      -        "is_likely_activist": {
      -          "default": false,
      -          "description": "Filer name matched a known Korean activist allowlist.",
      -          "type": "boolean"
      -        },
      -        "market": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "Listing market from DART corp_cls: 'KOSPI', 'KOSDAQ', 'KONEX', or 'OTHER'. None when DART omits corp_cls."
      -        },
      -        "raw_xml_url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "OpenAPI raw XML if applicable"
      -        },
      -        "receipt_no": {
      -          "description": "DART receipt number; key for fetching",
      -          "type": "string"
      -        },
      -        "red_flags": {
      -          "description": "Governance/distress tags inferred from the filing title, e.g. 'cb_issuance', 'controlling_shareholder_change', 'rehabilitation', 'audit_opinion', 'disclosure_violation', 'rights_issue', 'capital_reduction'. Empty when no keyword matched.",
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        },
      -        "stock_code": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "6-digit KRX stock code if listed"
      -        },
      -        "summary_en": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "LLM summary, only set when caller asks"
      -        },
      -        "title": {
      -          "description": "Filing title (Korean)",
      -          "type": "string"
      -        },
      -        "title_en": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "LLM-translated title"
      -        }
      -      },
      -      "required": [
      -        "corp_code",
      -        "corp_name_ko",
      -        "filing_type",
      -        "filing_type_label_ko",
      -        "filing_type_label_en",
      -        "title",
      -        "receipt_no",
      -        "filed_at",
      -        "dart_url",
      -        "attribution"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "string"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "description": "A type-D filing flagged with activist-investor heuristics.",
      +      "properties": {
      +        "activist_label": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Canonical activist name if matched (e.g. 'KCGI', 'Align Partners')."
      +        },
      +        "attribution": {
      +          "type": "string"
      +        },
      +        "corp_code": {
      +          "description": "DART 8-digit corp code",
      +          "type": "string"
      +        },
      +        "corp_name_en": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        },
      +        "corp_name_ko": {
      +          "type": "string"
      +        },
      +        "dart_url": {
      +          "description": "Human-readable DART URL",
      +          "type": "string"
      +        },
      +        "data_fetched_at": {
      +          "anyOf": [
      +            {
      +              "format": "date-time",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "UTC timestamp this filing was live-fetched from DART (as-of time for the data). None for rows served from a cache entry written before this field existed."
      +        },
      +        "filed_at": {
      +          "format": "date-time",
      +          "type": "string"
      +        },
      +        "filer_name_ko": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Reporting entity (DART `flr_nm`). For type-D shareholding disclosures this is typically the holder (often an activist); for periodic reports it's the company itself."
      +        },
      +        "filing_type": {
      +          "description": "DART filing type code (A–J)",
      +          "type": "string"
      +        },
      +        "filing_type_label_en": {
      +          "type": "string"
      +        },
      +        "filing_type_label_ko": {
      +          "type": "string"
      +        },
      +        "holder_reporter_ko": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "DART majorstock reporter name (`repror`) matched to this filing's filer. Same paid-tier enrichment as `holding_pct`."
      +        },
      +        "holding_pct": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Reporter's current holding percentage from DART majorstock.json (대량보유상황보고, `stkrt`). Paid-tier enrichment on monitor_activist_investors / monitor_foreign_holders rows only; None when not looked up or no reporter match was found."
      +        },
      +        "holding_pct_change": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Change in holding percentage versus the prior majorstock report (`stkrt_irds`). Same paid-tier enrichment as `holding_pct`."
      +        },
      +        "is_likely_activist": {
      +          "default": false,
      +          "description": "Filer name matched a known Korean activist allowlist.",
      +          "type": "boolean"
      +        },
      +        "market": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Listing market from DART corp_cls: 'KOSPI', 'KOSDAQ', 'KONEX', or 'OTHER'. None when DART omits corp_cls."
      +        },
      +        "query_total_count": {
      +          "anyOf": [
      +            {
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "DART's reported total_count for the query that produced this filing — the full match count before `limit`/`page_count` truncation, not the number of rows returned. None on cached rows written before this field existed."
      +        },
      +        "raw_xml_url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "OpenAPI raw XML if applicable"
      +        },
      +        "receipt_no": {
      +          "description": "DART receipt number; key for fetching",
      +          "type": "string"
      +        },
      +        "red_flags": {
      +          "description": "Governance/distress tags inferred from the filing title, e.g. 'cb_issuance', 'controlling_shareholder_change', 'rehabilitation', 'audit_opinion', 'disclosure_violation', 'rights_issue', 'capital_reduction', 'management_designation', 'delisting_risk', 'trading_halt', 'reverse_split', 'short_term_borrowing', 'going_concern'. Empty when no keyword matched.",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "stock_code": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "6-digit KRX stock code if listed"
      +        },
      +        "summary_en": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "LLM summary, only set when caller asks"
      +        },
      +        "title": {
      +          "description": "Filing title (Korean)",
      +          "type": "string"
      +        },
      +        "title_en": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "LLM-translated title"
      +        }
      +      },
      +      "required": [
      +        "corp_code",
      +        "corp_name_ko",
      +        "filing_type",
      +        "filing_type_label_ko",
      +        "filing_type_label_en",
      +        "title",
      +        "receipt_no",
      +        "filed_at",
      +        "dart_url",
      +        "attribution"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "string"
      +  }
      +]
  3. Changed1 schema field changed
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "description": "A type-D filing flagged with activist-investor heuristics.",
      -      "properties": {
      -        "activist_label": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "Canonical activist name if matched (e.g. 'KCGI', 'Align Partners')."
      -        },
      -        "attribution": {
      -          "type": "string"
      -        },
      -        "corp_code": {
      -          "description": "DART 8-digit corp code",
      -          "type": "string"
      -        },
      -        "corp_name_en": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null
      -        },
      -        "corp_name_ko": {
      -          "type": "string"
      -        },
      -        "dart_url": {
      -          "description": "Human-readable DART URL",
      -          "type": "string"
      -        },
      -        "filed_at": {
      -          "format": "date-time",
      -          "type": "string"
      -        },
      -        "filer_name_ko": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "Reporting entity (DART `flr_nm`). For type-D shareholding disclosures this is typically the holder (often an activist); for periodic reports it's the company itself."
      -        },
      -        "filing_type": {
      -          "description": "DART filing type code (A–J)",
      -          "type": "string"
      -        },
      -        "filing_type_label_en": {
      -          "type": "string"
      -        },
      -        "filing_type_label_ko": {
      -          "type": "string"
      -        },
      -        "is_likely_activist": {
      -          "default": false,
      -          "description": "Filer name matched a known Korean activist allowlist.",
      -          "type": "boolean"
      -        },
      -        "raw_xml_url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "OpenAPI raw XML if applicable"
      -        },
      -        "receipt_no": {
      -          "description": "DART receipt number; key for fetching",
      -          "type": "string"
      -        },
      -        "stock_code": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "6-digit KRX stock code if listed"
      -        },
      -        "summary_en": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "LLM summary, only set when caller asks"
      -        },
      -        "title": {
      -          "description": "Filing title (Korean)",
      -          "type": "string"
      -        },
      -        "title_en": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "default": null,
      -          "description": "LLM-translated title"
      -        }
      -      },
      -      "required": [
      -        "corp_code",
      -        "corp_name_ko",
      -        "filing_type",
      -        "filing_type_label_ko",
      -        "filing_type_label_en",
      -        "title",
      -        "receipt_no",
      -        "filed_at",
      -        "dart_url",
      -        "attribution"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "string"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "description": "A type-D filing flagged with activist-investor heuristics.",
      +      "properties": {
      +        "activist_label": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Canonical activist name if matched (e.g. 'KCGI', 'Align Partners')."
      +        },
      +        "attribution": {
      +          "type": "string"
      +        },
      +        "corp_code": {
      +          "description": "DART 8-digit corp code",
      +          "type": "string"
      +        },
      +        "corp_name_en": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        },
      +        "corp_name_ko": {
      +          "type": "string"
      +        },
      +        "dart_url": {
      +          "description": "Human-readable DART URL",
      +          "type": "string"
      +        },
      +        "filed_at": {
      +          "format": "date-time",
      +          "type": "string"
      +        },
      +        "filer_name_ko": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Reporting entity (DART `flr_nm`). For type-D shareholding disclosures this is typically the holder (often an activist); for periodic reports it's the company itself."
      +        },
      +        "filing_type": {
      +          "description": "DART filing type code (A–J)",
      +          "type": "string"
      +        },
      +        "filing_type_label_en": {
      +          "type": "string"
      +        },
      +        "filing_type_label_ko": {
      +          "type": "string"
      +        },
      +        "is_likely_activist": {
      +          "default": false,
      +          "description": "Filer name matched a known Korean activist allowlist.",
      +          "type": "boolean"
      +        },
      +        "market": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Listing market from DART corp_cls: 'KOSPI', 'KOSDAQ', 'KONEX', or 'OTHER'. None when DART omits corp_cls."
      +        },
      +        "raw_xml_url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "OpenAPI raw XML if applicable"
      +        },
      +        "receipt_no": {
      +          "description": "DART receipt number; key for fetching",
      +          "type": "string"
      +        },
      +        "red_flags": {
      +          "description": "Governance/distress tags inferred from the filing title, e.g. 'cb_issuance', 'controlling_shareholder_change', 'rehabilitation', 'audit_opinion', 'disclosure_violation', 'rights_issue', 'capital_reduction'. Empty when no keyword matched.",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "stock_code": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "6-digit KRX stock code if listed"
      +        },
      +        "summary_en": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "LLM summary, only set when caller asks"
      +        },
      +        "title": {
      +          "description": "Filing title (Korean)",
      +          "type": "string"
      +        },
      +        "title_en": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "LLM-translated title"
      +        }
      +      },
      +      "required": [
      +        "corp_code",
      +        "corp_name_ko",
      +        "filing_type",
      +        "filing_type_label_ko",
      +        "filing_type_label_en",
      +        "title",
      +        "receipt_no",
      +        "filed_at",
      +        "dart_url",
      +        "attribution"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "string"
      +  }
      +]
  4. First observed

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnlyHint/idempotentHint annotations, the description discloses the license-key requirement and the exact behavior on missing license (surface paywall notice, no silent fallback), plus best-effort enrichment with a cap of 8 corp_codes and fields becoming None on lookup failure. No contradiction with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded and well-paragraphed, but it is verbose and repetitive: the activist list appears three times and the license warning is wordy. It could be significantly shortened without losing information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is complex with license gating, a large activist list, fallback pitfalls, and enrichment semantics. The description covers all critical operational aspects: when to use, license error handling, data scope, and non-advice disclaimer. Output schema handles return structure, so no gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema description coverage, the baseline is 3, but the description adds meaningful context: license_key is tied to the license gate and paywall behavior, and enrich_holdings is documented as best-effort with a hard cap. This lifts the semantics above the schema alone.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly identifies the tool as 'Korean activist investor tracking — activist filer classification on DART 5%-rule shareholding disclosures', naming specific activists and the data source. This specific verb+resource pairing distinguishes it from siblings like track_korean_filings and monitor_foreign_holders.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

A dedicated 'Use this tool when...' paragraph lists concrete query patterns, and explicit 'Do NOT silently retry with track_korean_filings or any other free tool' instruction with reasoning. This gives clear when-to-use and when-not-to-use guidance, including alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.