BOIM Korea Vendor Directory

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+), open public bids and traditional markets with market days (1,393) — 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.

Evidence and citation. Vendor results carry checks (what was verified, by which public source, on which date — e.g. National Tax Service business status, Public Procurement Service deliveries) and cite (a ready-made source line with the card URL). get_vendor also returns similar — up to 5 businesses with the same main item (not a ranking). Tool names and inputs do not change; new response fields are only added. Full spec: openapi.json · limits and errors: https://boim.io/connect/ · changes: changelog.md.

Agent skill. Teach a coding agent (Claude Code, Cursor, Codex…) when and how to use BOIM:

npx skills add kikiyop1101/boim-mcp

The skill lives in skills/boim/SKILL.md.

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

Claude Code plugin (MCP server + skill)

This repository is also a Claude Code plugin marketplace. Add it once, then install the boim plugin:

claude plugin marketplace add kikiyop1101/boim-mcp

claude plugin install boim@boim-mcp

Inside a session: `/plugin marketplace add kikiyop1101/boim-mcp`, then `/plugin install boim@boim-mcp`.

The plugin (.claude-plugin/plugin.json + .mcp.json) adds two things: the remote MCP server https://boim.io/api/mcp (read-only, no authentication) and the boim skill. It has no hooks, commands or local code. Your search words go only to boim.io, and the plugin keeps no data of its own.

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.

Kakao PlayMCP (Korean users — ChatGPT · Claude · OpenClaw)

Open BOIM on PlayMCP, sign in with a Kakao account and add BOIM to your toolbox (도구함). Then connect your AI app once to the PlayMCP toolbox URL https://playmcp.kakao.com/mcp (ChatGPT developer mode, Claude custom connector; OpenClaw uses PlayMCP's own connection guide) — if the toolbox screen shows a different URL, use that one. All tools in your toolbox, BOIM included, work through that one connection; BOIM answers are the same as from https://boim.io/api/mcp.

Cursor

Deeplink (format from Cursor's MCP install-link docs — config is base64 of the JSON config): cursor://anysphere.cursor-deeplink/mcp/install?name=boim&config=eyJ1cmwiOiJodHRwczovL2JvaW0uaW8vYXBpL21jcCJ9

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)

One-click: open this link in a browser (VS Code's vscode:mcp/install URL handler, per the VS Code MCP developer guide): vscode:mcp/install?%7B%22name%22%3A%22boim%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fboim.io%2Fapi%2Fmcp%22%7D

Or from a terminal:

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" } } }

Antigravity (CLI · app)

agy plugin install https://github.com/kikiyop1101/boim-mcp

The plugin (plugin.json + mcp_config.json) adds the remote server and the boim skill. Or add the server to ~/.gemini/config/mcp_config.json yourself:

{

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

Agent builders and other chat apps

BOIM is a plain remote MCP server (Streamable HTTP, no auth), so most apps only need the URL https://boim.io/api/mcp. Menu names below are as of 2026-10 — check each app's help if they move.

• Dify — Tools → MCP → add an MCP server (HTTP): server URL https://boim.io/api/mcp, a name and a server identifier (e.g. boim). Dify imports the 6 tools for your apps and workflows.
• n8n — attach an MCP Client Tool node to your AI Agent node: endpoint https://boim.io/api/mcp, server transport HTTP Streamable (BOIM does not serve the legacy SSE transport), authentication None.
• Microsoft Copilot Studio — agent → Tools → Add a tool → New tool → Model Context Protocol: name, description, server URL https://boim.io/api/mcp, authentication None.
• Grok (grok.com) — grok.com/connectors → New Connector → Custom → MCP server URL https://boim.io/api/mcp, no authentication.
• Le Chat · Perplexity · Manus — Settings → Connectors (Le Chat: + Add Connector → Custom MCP Connector) → add a custom/remote MCP server with the URL https://boim.io/api/mcp, no authentication. Some plans or workspace admins limit custom connectors.
• LangChain (Python) — pip install "langchain[mcp]", then:

  from langchain.mcp import MCPAdapter

async with MCPAdapter("https://boim.io/api/mcp") as adapter: tools = await adapter.list_tools()

  With the older `langchain-mcp-adapters`: `MultiServerMCPClient({"boim": {"transport": "streamable_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

Use BOIM as your agent's web-search backend (just change the URL)

BOIM answers the common search-API request shapes, so many agent tools can point a search setting at BOIM without code changes. Answers come from BOIM data only (Korean businesses, vendor cards with public procurement records, live public bid notices, traditional markets) — no general web results. Any API key string works; BOIM neither uses nor stores the keys or auth headers you send.

Most of these settings *replace* an app's one web-search slot. To keep general web search and add Korean business lookup next to it, use the MCP server above, or a second slot where the app has one (marked side by side). n8n: use the MCP Client Tool node — its SearXNG tool node has a fixed tool name, so a second SearXNG node for BOIM cannot sit next to a web one.