# ComePass — Korean Companies & Public Procurement

> Korean company facts in English: DART financials and filings, KONEPS procurement, NTS status.

- name: xyz.comepass/korean-companies
- version: 0.2.0
- connection class: R0 (autonomous)
- trust: 81/100 flags: no-repository
- quality: 82/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/xyz.comepass%2Fkorean-companies
- tools: https://api.protogrid.dev/v1/servers/xyz.comepass%2Fkorean-companies/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "korean-companies": {
      "type": "http",
      "url": "https://agents.comepass.xyz/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 96
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-91% +updated-10d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 82/100 (good)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 94 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 3 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 4 of 4 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 2,104 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump
- pass `tools.hidden_text`: no hidden text in tool names, descriptions, schemas or annotations

### stability: 50 (weight 15)

- warn `stability.changes`: 14 tool changes in 30 days
- fail `stability.rug_pull`: 4 tools kept their name but changed most of their description in 30 days; review before trusting them
- pass `stability.new_links`: no tool change named a new site

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 4, about 2,104 tokens to load them all
- tool set hash: d84363af1861b8596d2a951bfc4b440b
- tools last changed: 2026-11-09T08:00:49.538Z
- badge: [![protogrid quality](https://protogrid.dev/badge/xyz.comepass/korean-companies.svg)](https://protogrid.dev/servers/xyz.comepass/korean-companies)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-09 `kr_company_procurement` changed (description, outputSchema)
  - before: Get precomputed 12-month Korean government and public-agency contract totals and recent awards for a KOSPI-listed company or other corporate supplier from the Public Procurement Service (KONEPS), cross-linked with DART corporate identifiers. Use this to evaluate a Korean company's public-sector delivery track record when you have an 8-digit DART corp_code, 6-digit KRX stock_code, or 10-digit business_registration_no (call kr_company_search first if you only have a name). Returns company identifiers (including business_registration_no), period (with basis: "original_signed_date"), 12-month contract_count, joint_contract_count, total_amount_krw, breakdowns by_category (goods, construction, services, foreign) and by_contract_type (lump_sum, unit_price, multi_year), top 5 government buyers, and up to 20 recent contracts with KONEPS detail URLs; if the company has no contracts in the window, returns found=true and has_procurement=false with a "No procurement in last 12 months" message. Pass business_registration_no to kr_business_status to verify live National Tax Service status, or corp_code to kr_company_profile for DART financials. Limitations: corporate entities only (sole proprietors are excluded). The 12-month window is by original contract signing date (period.basis = "original_signed_date"): it covers contracts first signed in the period, and excludes amendments registered in the period to contracts signed earlier. Amounts are in KRW from KONEPS; the 12-month total counts sole contracts in full and joint contracts by the supplier's share (joint contracts without a published share are counted but not summed), multi-year contracts count only the current-period amount, and unit-price (framework) contracts are reported separately because their values are ceilings, not spend. Read-only, keyless.
  - after: Get precomputed 12-month Korean government and public-agency contract totals and recent awards for a listed company or other corporate supplier from the Public Procurement Service (KONEPS), cross-linked with DART corporate identifiers. Use this to evaluate a Korean company's public-sector delivery track record when you have an 8-digit DART corp_code, 6-digit KRX stock_code, or 10-digit business_registration_no (call kr_company_search first if you only have a name). Returns company identifiers (including business_registration_no), period (with basis: "original_signed_date"), 12-month contract_count, joint_contract_count, total_amount_krw, breakdowns by_category (goods, construction, services, foreign) and by_contract_type (lump_sum, unit_price, multi_year), top 5 government buyers, and up to 20 recent contracts with KONEPS detail URLs; if the company has no contracts in the window, returns found=true and has_procurement=false with a "No procurement in last 12 months" message. Pass business_registration_no to kr_business_status to verify live National Tax Service status, or corp_code to kr_company_profile for DART financials. Limitations: corporate entities only (sole proprietors are excluded). The 12-month window is by original contract signing date (period.basis = "original_signed_date"): it covers contracts first signed in the period, and excludes amendments registered in the period to contracts signed earlier. Amounts are in KRW from KONEPS; the 12-month total counts sole contracts in full and joint contracts by the supplier's share (joint contracts without a published share are counted but not summed), multi-year contracts count only the current-period amount, and unit-price (framework) contracts are reported separately because their values are ceilings, not spend; contract_type is unknown when KONEPS gives no type. Also returns sanctions: PPS bid-participation restrictions (부정당제재) at the last daily check, split into active and suspended (enforcement stayed), with a scope_note, also for a corporate number outside the dataset; an empty list does not mean the company was never sanctioned. Read-only, keyless.
- 2026-11-09 `kr_company_profile` changed (description, outputSchema)
  - before: Get the precomputed, cross-linked profile of one KOSPI-listed Korean company from official Korean government filings: corporate identifiers (8-digit DART corp_code, 6-digit KRX stock_code, 10-digit business_registration_no, corporate_registration_no, CEO, address, website, founding date, fiscal month, industry code), the latest annual financial summary with prior-year comparison (revenue, operating income, net income, assets, liabilities, equity as integers in the reported currency given by financials.currency, usually KRW, consolidated CFS preferred), recent 90-day DART filings (up to 20), and cross-linked 12-month KONEPS public procurement summary if present. Use this when you have a KOSPI company's corp_code or stock_code; if you only have a name or business_registration_no, call kr_company_search first. Follow up with kr_company_procurement for full contract-type breakdowns or kr_business_status to verify active tax registration. Returns found=false if the company is not in the KOSPI index. Source: Korea FSS OpenDART and PPS KONEPS. Read-only, keyless. Not investment advice.
  - after: Get the precomputed, cross-linked profile of one Korean company listed on KOSPI, KOSDAQ, or KONEX from official Korean government filings: corporate identifiers (8-digit DART corp_code, 6-digit KRX stock_code, 10-digit business_registration_no, corporate_registration_no, CEO, address, website, founding date, fiscal month, industry code), the latest annual financial summary with prior-year comparison (revenue, operating income, net income, assets, liabilities, equity as integers in the reported currency given by financials.currency, usually KRW, financials.basis CFS (consolidated, preferred) or OFS (separate)), recent_filings: DART filings of the last 90 days (up to 20), and the cross-linked 12-month KONEPS procurement summary if present (the same procurement object as kr_company_procurement, with recent_contracts[].category goods, construction, services, or foreign and contract_type lump_sum, unit_price, multi_year, or unknown). Use this when you have a listed company's corp_code or stock_code; if you only have a name or business_registration_no, call kr_company_search first. Follow up with kr_company_procurement for full contract-type breakdowns or kr_business_status to verify active tax registration. An unlisted company from the DART company register (corp_code from a kind=registered search candidate) returns company.kind=registered with identifiers only, financials=null, and market=null. Returns found=false if the corp_code or stock_code is in neither. Source: Korea FSS OpenDART and PPS KONEPS. Read-only, keyless. Not investment advice.
- 2026-11-09 `kr_company_search` changed (title, description, outputSchema)
  - before: Search KOSPI-listed Korean companies and corporate public procurement suppliers across precomputed, cross-linked official Korean government datasets (FSS OpenDART and Public Procurement Service KONEPS). Use this first when you have a company name (Korean or English, e.g. "Samsung Electronics", "삼성전자", "한화시스템"), a 6-digit KRX stock_code, an 8-digit DART corp_code, or a 10-digit business_registration_no. Returns up to 20 ranked candidates with kind ("listed" or "supplier"), corp_code, stock_code, business_registration_no, Korean legal name, DART/KONEPS registered English name, alternate names, and 12-month KONEPS procurement total in KRW; each candidate carries match_type (exact_id, exact_name, prefix, contains); results sort by match_type, then listed companies, then size. Pass corp_code or stock_code to kr_company_profile for financials and DART filings, pass corp_code, stock_code, or business_registration_no to kr_company_procurement for KONEPS contract breakdowns, or pass business_registration_no to kr_business_status for live tax registration status. Coverage: all KOSPI companies (~830) and all corporate KONEPS suppliers (130,000+ over 12 months); corporate entities only (sole proprietors are excluded). Read-only, keyless.
  - after: Search Korean companies listed on KOSPI, KOSDAQ, and KONEX, and corporate public procurement suppliers across precomputed, cross-linked official Korean government datasets (FSS OpenDART and Public Procurement Service KONEPS). Use this first when you have a company name (Korean or English, e.g. "Samsung Electronics", "삼성전자", "한화시스템"), a 6-digit KRX stock_code, an 8-digit DART corp_code, or a 10-digit business_registration_no. Returns up to 20 ranked candidates with kind ("listed" or "supplier"), corp_code, stock_code, business_registration_no, Korean legal name, DART/KONEPS registered English name, alternate names, and 12-month KONEPS procurement total in KRW; each candidate carries match_type (exact_id, exact_name, prefix, contains); results sort by match_type, then listed companies, then size. Pass corp_code or stock_code to kr_company_profile for financials and DART filings, pass corp_code, stock_code, or business_registration_no to kr_company_procurement for KONEPS contract breakdowns, or pass business_registration_no to kr_business_status for live tax registration status. Coverage: companies DART reports as listed on KOSPI, KOSDAQ, or KONEX; unlisted companies in the DART company register (kind=registered: names and identifiers, no financials); for-profit head offices enrolled in Korean employment and industrial-accident insurance (kind=insured, COMWEL annual file, matched by exact or leading name or BRN; insured_employees on any candidate with a BRN); and all corporate KONEPS suppliers (130,000+ over 12 months); corporate entities only (sole proprietors are excluded). Read-only, keyless.
- 2026-11-07 `kr_business_status` changed (description, outputSchema)
  - before: Check whether Korean 10-digit business registration numbers are currently active, suspended, or closed via the National Tax Service (NTS) live API. Use this to verify a Korean supplier, customer, or counterparty before a transaction; business_registration_no can be obtained from kr_company_search, kr_company_profile, or kr_company_procurement results. Accepts 1–10 ten-digit numbers (hyphens allowed, e.g. "124-81-00998") and returns per number: status (active | suspended | closed | not_registered), original Korean status text, tax type, closure date if closed, and check timestamp. Combine with kr_company_procurement to inspect the entity's 12-month KONEPS public procurement track record. Limitations: queries an external government API in real time; submitted numbers are never stored or logged. Read-only, keyless.
  - after: Check whether Korean 10-digit business registration numbers are currently active, suspended, or closed via the National Tax Service (NTS) live API. Use this to verify a Korean supplier, customer, or counterparty before a transaction; business_registration_no can be obtained from kr_company_search, kr_company_profile, or kr_company_procurement results. Accepts 1–10 ten-digit numbers (hyphens allowed, e.g. "124-81-00998") and returns per number: status (active | suspended | closed | not_registered | unknown), original Korean status text, tax type, closure date if closed, and check timestamp. not_registered means NTS explicitly said so; unknown means NTS gave no explicit answer, so retry rather than treat the business as unregistered. Combine with kr_company_procurement to inspect the entity's 12-month KONEPS public procurement track record. Limitations: queries an external government API in real time; submitted numbers are never stored or logged. Read-only, keyless.
- 2026-11-07 `kr_company_procurement` changed (description, outputSchema)
  - before: Get precomputed 12-month Korean government and public-agency contract totals and recent awards for a listed company or unlisted corporate supplier from the Public Procurement Service (KONEPS), cross-linked with DART corporate identifiers. Use this to evaluate a Korean company's public-sector delivery track record when you have an 8-digit DART corp_code, 6-digit KRX stock_code, or 10-digit business_registration_no (call kr_company_search first if you only have a name). Returns company identifiers (including business_registration_no), period (with basis: "original_signed_date"), 12-month contract_count, joint_contract_count, total_amount_krw, breakdowns by_category (goods, construction, services, foreign) and by_contract_type (lump_sum, unit_price, multi_year), top 5 government buyers, and up to 20 recent contracts with KONEPS detail URLs; if the company has no contracts in the window, returns found=true and has_procurement=false with a "No procurement in last 12 months" message. Pass business_registration_no to kr_business_status to verify live National Tax Service status, or corp_code to kr_company_profile for DART financials. Limitations: corporate entities only (sole proprietors are excluded). The 12-month window is by original contract signing date (period.basis = "original_signed_date"): it covers contracts first signed in the period, and excludes amendments registered in the period to contracts signed earlier. Amounts are in KRW from KONEPS; the 12-month total counts sole contracts in full and joint contracts by the supplier's share (joint contracts without a published share are counted but not summed), multi-year contracts count only the current-period amount, and unit-price (framework) contracts are reported separately because their values are ceilings, not spend. Read-only, keyless.
  - after: Get precomputed 12-month Korean government and public-agency contract totals and recent awards for a KOSPI-listed company or other corporate supplier from the Public Procurement Service (KONEPS), cross-linked with DART corporate identifiers. Use this to evaluate a Korean company's public-sector delivery track record when you have an 8-digit DART corp_code, 6-digit KRX stock_code, or 10-digit business_registration_no (call kr_company_search first if you only have a name). Returns company identifiers (including business_registration_no), period (with basis: "original_signed_date"), 12-month contract_count, joint_contract_count, total_amount_krw, breakdowns by_category (goods, construction, services, foreign) and by_contract_type (lump_sum, unit_price, multi_year), top 5 government buyers, and up to 20 recent contracts with KONEPS detail URLs; if the company has no contracts in the window, returns found=true and has_procurement=false with a "No procurement in last 12 months" message. Pass business_registration_no to kr_business_status to verify live National Tax Service status, or corp_code to kr_company_profile for DART financials. Limitations: corporate entities only (sole proprietors are excluded). The 12-month window is by original contract signing date (period.basis = "original_signed_date"): it covers contracts first signed in the period, and excludes amendments registered in the period to contracts signed earlier. Amounts are in KRW from KONEPS; the 12-month total counts sole contracts in full and joint contracts by the supplier's share (joint contracts without a published share are counted but not summed), multi-year contracts count only the current-period amount, and unit-price (framework) contracts are reported separately because their values are ceilings, not spend. Read-only, keyless.
- 2026-11-07 `kr_company_profile` changed (description, outputSchema)
  - before: Get the precomputed, cross-linked profile of one KOSPI-listed Korean company from official Korean government filings: corporate identifiers (8-digit DART corp_code, 6-digit KRX stock_code, 10-digit business_registration_no, corporate_registration_no, CEO, address, website, founding date, fiscal month, industry code), the latest annual financial summary with prior-year comparison (revenue, operating income, net income, assets, liabilities, equity in integer KRW, consolidated CFS preferred), recent 90-day DART filings (up to 20), and cross-linked 12-month KONEPS public procurement summary if present. Use this when you have a KOSPI company's corp_code or stock_code; if you only have a name or business_registration_no, call kr_company_search first. Follow up with kr_company_procurement for full contract-type breakdowns or kr_business_status to verify active tax registration. Returns found=false if the company is not in the KOSPI index. Source: Korea FSS OpenDART and PPS KONEPS. Read-only, keyless. Not investment advice.
  - after: Get the precomputed, cross-linked profile of one KOSPI-listed Korean company from official Korean government filings: corporate identifiers (8-digit DART corp_code, 6-digit KRX stock_code, 10-digit business_registration_no, corporate_registration_no, CEO, address, website, founding date, fiscal month, industry code), the latest annual financial summary with prior-year comparison (revenue, operating income, net income, assets, liabilities, equity as integers in the reported currency given by financials.currency, usually KRW, consolidated CFS preferred), recent 90-day DART filings (up to 20), and cross-linked 12-month KONEPS public procurement summary if present. Use this when you have a KOSPI company's corp_code or stock_code; if you only have a name or business_registration_no, call kr_company_search first. Follow up with kr_company_procurement for full contract-type breakdowns or kr_business_status to verify active tax registration. Returns found=false if the company is not in the KOSPI index. Source: Korea FSS OpenDART and PPS KONEPS. Read-only, keyless. Not investment advice.
- 2026-11-07 `kr_company_search` changed (description, outputSchema)
  - before: Search KOSPI-listed Korean companies and corporate public procurement suppliers across precomputed, cross-linked official Korean government datasets (FSS OpenDART and Public Procurement Service KONEPS). Use this first when you have a company name (Korean or English, e.g. "Samsung Electronics", "삼성전자", "한화시스템"), a 6-digit KRX stock_code, an 8-digit DART corp_code, or a 10-digit business_registration_no. Returns up to 20 ranked candidates with kind ("listed" or "supplier"), corp_code, stock_code, business_registration_no, Korean legal name, DART/KONEPS registered English name, alternate names, and 12-month KONEPS procurement total in KRW; results sort by exact identifier match first, then listed companies, then 12-month procurement amount descending. Pass corp_code or stock_code to kr_company_profile for financials and DART filings, pass corp_code, stock_code, or business_registration_no to kr_company_procurement for KONEPS contract breakdowns, or pass business_registration_no to kr_business_status for live tax registration status. Coverage: all KOSPI companies (~830) and all corporate KONEPS suppliers (~110,000 over 12 months); corporate entities only (sole proprietors are excluded). Read-only, keyless.
  - after: Search KOSPI-listed Korean companies and corporate public procurement suppliers across precomputed, cross-linked official Korean government datasets (FSS OpenDART and Public Procurement Service KONEPS). Use this first when you have a company name (Korean or English, e.g. "Samsung Electronics", "삼성전자", "한화시스템"), a 6-digit KRX stock_code, an 8-digit DART corp_code, or a 10-digit business_registration_no. Returns up to 20 ranked candidates with kind ("listed" or "supplier"), corp_code, stock_code, business_registration_no, Korean legal name, DART/KONEPS registered English name, alternate names, and 12-month KONEPS procurement total in KRW; each candidate carries match_type (exact_id, exact_name, prefix, contains); results sort by match_type, then listed companies, then size. Pass corp_code or stock_code to kr_company_profile for financials and DART filings, pass corp_code, stock_code, or business_registration_no to kr_company_procurement for KONEPS contract breakdowns, or pass business_registration_no to kr_business_status for live tax registration status. Coverage: all KOSPI companies (~830) and all corporate KONEPS suppliers (130,000+ over 12 months); corporate entities only (sole proprietors are excluded). Read-only, keyless.
- 2026-11-02 `kr_business_status` changed (description)
  - before: Check whether Korean business registration numbers are currently active, suspended (temporarily closed), or closed, using the National Tax Service's live API. Use this to verify a Korean supplier, customer, or counterparty before a transaction. Accepts 1–10 ten-digit numbers (hyphens allowed, e.g. "124-81-00998"). Returns per number: status (active | suspended | closed | not_registered), the original Korean status text, tax type, closure date if closed, and check time. You can find a listed company's number in kr_company_profile (business_registration_no). Numbers you submit are not stored. Read-only; queries an external government API in real time.
  - after: Check whether Korean 10-digit business registration numbers are currently active, suspended, or closed via the National Tax Service (NTS) live API. Use this to verify a Korean supplier, customer, or counterparty before a transaction; business_registration_no can be obtained from kr_company_search, kr_company_profile, or kr_company_procurement results. Accepts 1–10 ten-digit numbers (hyphens allowed, e.g. "124-81-00998") and returns per number: status (active | suspended | closed | not_registered), original Korean status text, tax type, closure date if closed, and check timestamp. Combine with kr_company_procurement to inspect the entity's 12-month KONEPS public procurement track record. Limitations: queries an external government API in real time; submitted numbers are never stored or logged. Read-only, keyless.
- 2026-11-02 `kr_company_procurement` added
  - Get precomputed 12-month Korean government and public-agency contract totals and recent awards for a listed company or unlisted corporate supplier from the Public Procurement Service (KONEPS), cross-linked with DART corporate identifiers. Use this to evaluate a Korean company's public-sector delivery track record when you have an 8-digit DART corp_code, 6-digit KRX stock_code, or 10-digit business_registration_no (call kr_company_search first if you only have a name). Returns company identifiers (including business_registration_no), period (with basis: "original_signed_date"), 12-month contract_count, joint_contract_count, total_amount_krw, breakdowns by_category (goods, construction, services, foreign) and by_contract_type (lump_sum, unit_price, multi_year), top 5 government buyers, and up to 20 recent contracts with KONEPS detail URLs; if the company has no contracts in the window, returns found=true and has_procurement=false with a "No procurement in last 12 months" message. Pass business_registration_no to kr_business_status to verify live National Tax Service status, or corp_code to kr_company_profile for DART financials. Limitations: corporate entities only (sole proprietors are excluded). The 12-month window is by original contract signing date (period.basis = "original_signed_date"): it covers contracts first signed in the period, and excludes amendments registered in the period to contracts signed earlier. Amounts are in KRW from KONEPS; the 12-month total counts sole contracts in full and joint contracts by the supplier's share (joint contracts without a published share are counted but not summed), multi-year contracts count only the current-period amount, and unit-price (framework) contracts are reported separately because their values are ceilings, not spend. Read-only, keyless.
- 2026-11-02 `kr_company_profile` changed (title, description, outputSchema)
  - before: Get the full profile of one KOSPI-listed Korean company: corporate details (English and Korean names, CEO, business and corporate registration numbers, address, website, founding date, fiscal month, industry code), the latest annual financial summary with the prior year (revenue, operating income, net income, total assets, liabilities, equity; integers in KRW as filed, consolidated if available), and DART filings from the last 90 days (up to 20) with original links. Provide exactly one of corp_code or stock_code; if you only have a name, call kr_company_search first. Returns found=false if the company is not covered. Source: Korea FSS OpenDART. Read-only, no API key needed. Not investment advice.
  - after: Get the precomputed, cross-linked profile of one KOSPI-listed Korean company from official Korean government filings: corporate identifiers (8-digit DART corp_code, 6-digit KRX stock_code, 10-digit business_registration_no, corporate_registration_no, CEO, address, website, founding date, fiscal month, industry code), the latest annual financial summary with prior-year comparison (revenue, operating income, net income, assets, liabilities, equity in integer KRW, consolidated CFS preferred), recent 90-day DART filings (up to 20), and cross-linked 12-month KONEPS public procurement summary if present. Use this when you have a KOSPI company's corp_code or stock_code; if you only have a name or business_registration_no, call kr_company_search first. Follow up with kr_company_procurement for full contract-type breakdowns or kr_business_status to verify active tax registration. Returns found=false if the company is not in the KOSPI index. Source: Korea FSS OpenDART and PPS KONEPS. Read-only, keyless. Not investment advice.

Full history: https://api.protogrid.dev/v1/servers/xyz.comepass%2Fkorean-companies/changes

## Remotes

- https://agents.comepass.xyz/mcp (streamable-http, auth none, reachable true, uptime30d 0.9111111)

## Packages

_none_

## Tools (4)

- `kr_business_status`: Check whether Korean 10-digit business registration numbers are currently active, suspended, or closed via the National Tax Service (NTS) live API. Use this to verify a Korean supplier, customer, or counterparty before a transaction; business_registration_no can be obtained from kr_company_search, kr_company_profile, or kr_company_procurement results. Accepts 1–10 ten-digit numbers (hyphens allowed, e.g. "124-81-00998") and returns per number: status (active | suspended | closed | not_registered | unknown), original Korean status text, tax type, closure date if closed, and check timestamp. not_registered means NTS explicitly said so; unknown means NTS gave no explicit answer, so retry rather than treat the business as unregistered. Combine with kr_company_procurement to inspect the entity's 12-month KONEPS public procurement track record. Limitations: queries an external government API in real time; submitted numbers are never stored or logged. Read-only, keyless.
- `kr_company_procurement`: Get precomputed 12-month Korean government and public-agency contract totals and recent awards for a listed company or other corporate supplier from the Public Procurement Service (KONEPS), cross-linked with DART corporate identifiers. Use this to evaluate a Korean company's public-sector delivery track record when you have an 8-digit DART corp_code, 6-digit KRX stock_code, or 10-digit business_registration_no (call kr_company_search first if you only have a name). Returns company identifiers (including business_registration_no), period (with basis: "original_signed_date"), 12-month contract_count, joint_contract_count, total_amount_krw, breakdowns by_category (goods, construction, services, foreign) and by_contract_type (lump_sum, unit_price, multi_year), top 5 government buyers, and up to 20 recent contracts with KONEPS detail URLs; if the company has no contracts in the window, returns found=true and has_procurement=false with a "No procurement in last 12 months" message. Pass business_registration_no to kr_business_status to verify live National Tax Service status, or corp_code to kr_company_profile for DART financials. Limitations: corporate entities only (sole proprietors are excluded). The 12-month window is by original contract signing date (period.basis = "original_signed_date"): it covers contracts first signed in the period, and excludes amendments registered in the period to contracts signed earlier. Amounts are in KRW from KONEPS; the 12-month total counts sole contracts in full and joint contracts by the supplier's share (joint contracts without a published share are counted but not summed), multi-year contracts count only the current-period amount, and unit-price (framework) contracts are reported separately because their values are ceilings, not spend; contract_type is unknown when KONEPS gives no type. Also returns sanctions: PPS bid-participation restrictions (부정당제재) at the last daily check, split into active and suspended (enforcement stayed), with a scope_note, also for a corporate number outside the dataset; an empty list does not mean the company was never sanctioned. Read-only, keyless.
- `kr_company_profile`: Get the precomputed, cross-linked profile of one Korean company listed on KOSPI, KOSDAQ, or KONEX from official Korean government filings: corporate identifiers (8-digit DART corp_code, 6-digit KRX stock_code, 10-digit business_registration_no, corporate_registration_no, CEO, address, website, founding date, fiscal month, industry code), the latest annual financial summary with prior-year comparison (revenue, operating income, net income, assets, liabilities, equity as integers in the reported currency given by financials.currency, usually KRW, financials.basis CFS (consolidated, preferred) or OFS (separate)), recent_filings: DART filings of the last 90 days (up to 20), and the cross-linked 12-month KONEPS procurement summary if present (the same procurement object as kr_company_procurement, with recent_contracts[].category goods, construction, services, or foreign and contract_type lump_sum, unit_price, multi_year, or unknown). Use this when you have a listed company's corp_code or stock_code; if you only have a name or business_registration_no, call kr_company_search first. Follow up with kr_company_procurement for full contract-type breakdowns or kr_business_status to verify active tax registration. An unlisted company from the DART company register (corp_code from a kind=registered search candidate) returns company.kind=registered with identifiers only, financials=null, and market=null. Returns found=false if the corp_code or stock_code is in neither. Source: Korea FSS OpenDART and PPS KONEPS. Read-only, keyless. Not investment advice.
- `kr_company_search`: Search Korean companies listed on KOSPI, KOSDAQ, and KONEX, and corporate public procurement suppliers across precomputed, cross-linked official Korean government datasets (FSS OpenDART and Public Procurement Service KONEPS). Use this first when you have a company name (Korean or English, e.g. "Samsung Electronics", "삼성전자", "한화시스템"), a 6-digit KRX stock_code, an 8-digit DART corp_code, or a 10-digit business_registration_no. Returns up to 20 ranked candidates with kind ("listed" or "supplier"), corp_code, stock_code, business_registration_no, Korean legal name, DART/KONEPS registered English name, alternate names, and 12-month KONEPS procurement total in KRW; each candidate carries match_type (exact_id, exact_name, prefix, contains); results sort by match_type, then listed companies, then size. Pass corp_code or stock_code to kr_company_profile for financials and DART filings, pass corp_code, stock_code, or business_registration_no to kr_company_procurement for KONEPS contract breakdowns, or pass business_registration_no to kr_business_status for live tax registration status. Coverage: companies DART reports as listed on KOSPI, KOSDAQ, or KONEX; unlisted companies in the DART company register (kind=registered: names and identifiers, no financials); for-profit head offices enrolled in Korean employment and industrial-accident insurance (kind=insured, COMWEL annual file, matched by exact or leading name or BRN; insured_employees on any candidate with a BRN); and all corporate KONEPS suppliers (130,000+ over 12 months); corporate entities only (sole proprietors are excluded). Read-only, keyless.