BOIM (보임) — Korean Business Directory MCP Server

Remote MCP server for AI agents that need to find businesses in Korea. Korean businesses across all industries (2.7M), public-procurement vendors (75,000+) and open public bids — read-only, no sign-up, no API key for the free tier.

This repository contains documentation and client configuration examples only. The server is hosted at boim.io.

Tools

Ordering is not a ranking. Results are sorted by relevance (region evidence) → AI-readiness band (how complete the business's own information is) → a daily shuffle within each band. No paid placement; the operator's own listing gets no boost.

Free vs. full. Without a key each tool returns up to 5 results, plus not_shown (how many more) and more (a public web list anyone can open). Full results are available with a BOIM API key (Authorization: Bearer … or ?key=) — contact public-id@naver.com.

Related MCP server: narajangteo-pro

Connect

Claude (claude.ai · Claude Desktop — Pro/Max)

Customize → Connectors → + Add → Add custom connector → name BOIM, URL https://boim.io/api/mcp, no authentication. Turn it on from the tools menu in a chat.

Claude Code

claude mcp add --transport http boim https://boim.io/api/mcp

ChatGPT

Settings → Security and login → turn on Developer mode → create an app/connector with the URL https://boim.io/api/mcp, authentication None. Pick it in a new chat.

Cursor

Or add to ~/.cursor/mcp.json (this repository's mcp.json and .cursor-plugin/plugin.json hold the same config):

{
  "mcpServers": {
    "boim": { "url": "https://boim.io/api/mcp" }
  }
}

VS Code (GitHub Copilot agent mode)

code --add-mcp "{\"name\":\"boim\",\"type\":\"http\",\"url\":\"https://boim.io/api/mcp\"}"

or .vscode/mcp.json:

{
  "servers": {
    "boim": { "type": "http", "url": "https://boim.io/api/mcp" }
  }
}

Clients that only speak stdio

{
  "mcpServers": {
    "boim": { "command": "npx", "args": ["-y", "mcp-remote", "https://boim.io/api/mcp"] }
  }
}

No MCP at all

Any agent that can fetch a URL can search: https://boim.io/search/?q=세종 미용실&format=json (also &format=md, or Accept: text/markdown). Site summary for LLMs: https://boim.io/llms.txt

Data sources

All data comes from Korean government open data on data.go.kr (usage terms: no restriction) and is refreshed daily (businesses monthly):

• Small Enterprise and Market Service store data (소상공인시장진흥공단 상가(상권)정보, 15012005) — all-industry businesses

• Public Procurement Service shopping-mall items, delivery requests and contracts (조달청 종합쇼핑몰 품목정보 15129471 · 계약정보 15129427) — vendor cards

• Public bids: KONEPS (15129394), Defense e-Procurement (15158416), LH (15159012), K-water (15101635), Nuri-jangteo (15129456)

• National Tax Service business status (국세청 사업자등록 상태) — closed businesses are removed

Not published: representative names, street addresses, business registration numbers, procurement officers' contact details.

한국어 안내

보임(BOIM)은 AI 에이전트가 한국 업체를 찾을 때 처음 만나는 곳입니다. 전 업종 전국 업체 약 277만 곳, 공공 조달 실적 업체 카드 7만 5천여 곳(조달청 공공데이터 전 품목), 공공기관 입찰 공고 전 분야(나라장터·국방전자조달·LH·한국수자원공사·누리장터)를 MCP 주소 하나로 읽을 수 있습니다.

• MCP 주소: https://boim.io/api/mcp (읽기 전용, 인증 없음, 무료는 도구마다 5건 + 전체 목록 주소)

• 순서는 관련도 → AI 준비 구간 → 같은 구간은 날마다 섞기입니다. 실적 많은 순이나 유료 순위가 아닙니다.

• 업체는 boim.io에서 무료로 등록하고(국세청 사업자 확인 뒤 자동 게시), AI 준비도 점수를 가입 없이 확인할 수 있습니다: https://boim.io/ready/

• 연결 방법(클로드·ChatGPT): https://boim.io/connect/

Terms

• Site terms: https://boim.io/terms/ — automated bulk collection and redistribution of the site are not allowed; use the MCP server or the API.

• This repository (documentation and configuration examples) is released under the MIT License.

Operator

Public identity Co., Ltd. (주식회사 퍼블릭아이디) — Sejong, Republic of Korea · public-id@naver.com · https://www.public-id.co.kr