Koskamo

Korea Business Verify MCP

A remote MCP server that verifies Korean businesses in real time via the Korea National Tax Service (NTS). It allows AI agents to find companies by name, check registration status, perform KYB identity verification, and screen for public procurement debarments. It also provides Korean customs import requirements by HS code. The service is independent and reads public open data.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Korea Business Verify MCP logo, by WonderfulianCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by Wonderfulian
You need:No account, no API key, no installation
MCP endpoint (Streamable HTTP)
https://kbv-server-f7vfitmlkq-du.a.run.app/mcp
Vendor documentation

What its tools do

6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (6)

6 of 6 have a description · 6 of 6 declare behavior hints · 6 of 6 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Find Korean business registration numbers by company name
  • Check if a company is active, suspended, or closed
  • Verify business identity against representative name and opening date
  • Retrieve customs import requirements for specific HS codes

Source and maintenance

Community listingRegistry 0.3.2
mcp-registry: io.github.Wonderfulian/kbv-server@0.3.2Source repository
Maintenance checked

Protocol and capabilities

Server
korea-business-verify 0.3.1
MCP protocol negotiated in check
2025-11-25
Tools
6 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Tools

6 advertised

check_korean_business_status — Check Korean business status
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Check the registration status of a Korean business by its 10-digit business registration number (사업자등록번호). Returns whether the business is active, suspended, or closed, plus tax type. Data source: Korea National Tax Service, real-time. The number 1248100998 (Samsung Electronics) is exempt from the daily free tier, so you can exercise this tool while building without spending your allowance.

check_korean_business_status input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "business_number"
  ],
  "properties": {
    "business_number": {
      "type": "string",
      "description": "10-digit Korean business registration number; hyphens/spaces allowed, e.g. \"123-45-67890\""
    }
  }
}
check_korean_business_status output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "business_number",
    "status",
    "status_code_raw",
    "tax_type",
    "closed_date",
    "checked_at",
    "source",
    "cache"
  ],
  "properties": {
    "cache": {
      "type": "boolean"
    },
    "source": {
      "type": "string",
      "const": "Korea National Tax Service (NTS)"
    },
    "status": {
      "enum": [
        "active",
        "suspended",
        "closed",
        "not_registered"
      ],
      "type": "string"
    },
    "tax_type": {
      "enum": [
        "general",
        "simplified",
        "exempt",
        "non_profit",
        "unknown"
      ],
      "type": "string"
    },
    "checked_at": {
      "type": "string"
    },
    "closed_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "business_number": {
      "type": "string"
    },
    "status_code_raw": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
check_korean_business_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
check_korean_business_batch — Batch check Korean business status
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Screen a list of up to 100 Korean businesses in a single call by their 10-digit business registration numbers (사업자등록번호). Returns one entry per input number (order preserved) with registration status, tax type, and any public-procurement debarment ("부정당업자 제재") on record — a company can be perfectly active and still barred from public contracts. The summary counts how many are currently debarred. Use this for supplier, vendor or customer list screening instead of repeated single checks. Recently checked numbers may be answered from a cache up to 24 hours old (marked "cache": true). Sources: Korea National Tax Service, Public Procurement Service.

check_korean_business_batch input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "business_numbers"
  ],
  "properties": {
    "business_numbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "1-100 Korean business registration numbers; hyphens/spaces allowed"
    }
  }
}
check_korean_business_batch output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "results",
    "summary"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "business_number",
          "status",
          "status_code_raw",
          "tax_type",
          "closed_date",
          "checked_at",
          "source",
          "cache"
        ],
        "properties": {
          "cache": {
            "type": "boolean"
          },
          "source": {
            "type": "string",
            "const": "Korea National Tax Service (NTS)"
          },
          "status": {
            "enum": [
              "active",
              "suspended",
              "closed",
              "not_registered"
            ],
            "type": "string"
          },
          "tax_type": {
            "enum": [
              "general",
              "simplified",
              "exempt",
              "non_profit",
              "unknown"
            ],
            "type": "string"
          },
          "sanctions": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "active"
              ],
              "properties": {
                "law": {
                  "type": "string"
                },
                "active": {
                  "type": "boolean"
                },
                "status": {
                  "type": "string"
                },
                "ends_on": {
                  "type": "string"
                },
                "begins_on": {
                  "type": "string"
                },
                "institution": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          },
          "checked_at": {
            "type": "string"
          },
          "closed_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "business_number": {
            "type": "string"
          },
          "status_code_raw": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "summary": {
      "type": "object",
      "required": [
        "total",
        "active",
        "suspended",
        "closed",
        "not_registered"
      ],
      "properties": {
        "total": {
          "type": "number"
        },
        "active": {
          "type": "number"
        },
        "closed": {
          "type": "number"
        },
        "suspended": {
          "type": "number"
        },
        "sanctioned": {
          "type": "number"
        },
        "not_registered": {
          "type": "number"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}
check_korean_business_batch annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
find_korean_business — Find a Korean business by name
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Find a Korean company by name (English or Korean) when you do not know its 10-digit business registration number — the number every other tool here needs. Returns ranked candidates with a confidence score and discriminating evidence (registration status, tax type, region), because a name can match several distinct companies: "Samsung Electronics" matches four. Sources: DART (disclosure filers, English names) and the Public Procurement Service registry (small businesses).

find_korean_business input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Company name in English or Korean, e.g. \"Samsung Electronics\" or \"삼성전자\""
    },
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum candidates to return (default 5)"
    }
  }
}
find_korean_business annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
verify_korean_business — Verify Korean business identity
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Verify that a Korean business registration number matches the provided representative name and opening date. Use for KYB / due-diligence before transacting with a Korean company. Returns match result plus current status.

verify_korean_business input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "business_number",
    "representative_name",
    "opening_date"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "Optional business address to include in the match (maps to NTS b_adr)"
    },
    "opening_date": {
      "type": "string",
      "description": "Business opening date in YYYY-MM-DD format, e.g. \"2015-03-02\""
    },
    "business_number": {
      "type": "string",
      "description": "10-digit Korean business registration number; hyphens/spaces allowed"
    },
    "representative_name": {
      "type": "string",
      "minLength": 1,
      "description": "Representative (CEO) name as registered, e.g. \"홍길동\""
    }
  }
}
verify_korean_business output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "business_number",
    "status",
    "status_code_raw",
    "tax_type",
    "closed_date",
    "checked_at",
    "source",
    "cache",
    "identity_match"
  ],
  "properties": {
    "cache": {
      "type": "boolean"
    },
    "source": {
      "type": "string",
      "const": "Korea National Tax Service (NTS)"
    },
    "status": {
      "enum": [
        "active",
        "suspended",
        "closed",
        "not_registered"
      ],
      "type": "string"
    },
    "tax_type": {
      "enum": [
        "general",
        "simplified",
        "exempt",
        "non_profit",
        "unknown"
      ],
      "type": "string"
    },
    "checked_at": {
      "type": "string"
    },
    "closed_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "identity_match": {
      "type": "boolean"
    },
    "business_number": {
      "type": "string"
    },
    "status_code_raw": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
verify_korean_business annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
check_korea_import_requirements — Check Korean import/export clearance requirements by HS code
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Check what Korean customs clearance requirements apply to a product by its 10-digit HS code. Goods that need an unmet approval are held or returned at Korean customs. Returns which statutes require clearance, which agencies can approve (often several, any one of which suffices), the certificate to obtain, and each requirement's condition quoted from the governing notice (Korean original, which is authoritative) — plus tariff rates for imports. Data: Korea Customs Service and the Ministry of Government Legislation. Fact lookup only — not a legal customs determination; whether a condition applies to your product is not decided here. Test code 8516710000 (coffee makers) is free.

check_korea_import_requirements input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "hs_code"
  ],
  "properties": {
    "hs_code": {
      "type": "string",
      "description": "10-digit Korean HS (HSK) code, dots/hyphens allowed. 6 digits returns the 10-digit candidates."
    },
    "direction": {
      "enum": [
        "import",
        "export"
      ],
      "type": "string",
      "description": "Default \"import\" (goods entering Korea)"
    }
  }
}
check_korea_import_requirements annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
check_korea_import_requirements_batch — Screen a product catalog for Korean import restrictions
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Screen a product catalog for Korean import restrictions in one call. Submit up to 100 HS codes and get back what is restricted, with the statute, the approving agencies and the certificate required for each. Restricted codes come first, then codes that could not be checked, then clear ones. Invalid codes are listed in summary.invalid_hs and not counted. Use before opening a Korea shipping lane or listing a catalog for Korean buyers. Fact lookup only — not a legal customs determination.

check_korea_import_requirements_batch input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "hs_codes"
  ],
  "properties": {
    "hs_codes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "1-100 Korean 10-digit HS (HSK) codes; dots/hyphens allowed"
    },
    "direction": {
      "enum": [
        "import",
        "export"
      ],
      "type": "string",
      "description": "Default \"import\" (goods entering Korea)"
    }
  }
}
check_korea_import_requirements_batch annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (2 of 2 answered).

  1. 2026-11-06: 1 of 1 checks answered
  2. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
801 ms
95th percentile latency
801 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 801 ms · metadata changed · 6 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http korea-business-verify-mcp-run https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add korea-business-verify-mcp-run --url https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable korea-business-verify-mcp-run in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "korea-business-verify-mcp-run": {
      "url": "https://kbv-server-f7vfitmlkq-du.a.run.app/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "korea-business-verify-mcp-run": {
      "type": "streamableHttp",
      "url": "https://kbv-server-f7vfitmlkq-du.a.run.app/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start korea-business-verify-mcp-run and inspect its tools.
VS Code configuration
{
  "servers": {
    "korea-business-verify-mcp-run": {
      "type": "http",
      "url": "https://kbv-server-f7vfitmlkq-du.a.run.app/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http korea-business-verify-mcp-run https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "korea-business-verify-mcp-run": {
      "serverUrl": "https://kbv-server-f7vfitmlkq-du.a.run.app/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Korea Business Verify MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 6,295