apick-mcp

<div align="center">

<img src="https://raw.githubusercontent.com/lead788/apick-mcp/main/assets/logo-400.png" alt="APICK" width="88" height="88">

# APICK MCP — 97 Korean Data, AI, Image & Video Tools

**Korean business registry, ID verification, OCR, parcel tracking, file conversion, web intelligence and LLM — as MCP tools for any AI agent.**

**대한민국 사업자조회 · 신분증 진위확인 · OCR · 택배 배송조회 · 파일변환 · 웹조회 · LLM을 MCP Tool로.**

[![npm](https://img.shields.io/npm/v/apick-mcp?color=%230a7cff&label=npm%20apick-mcp)](https://www.npmjs.com/package/apick-mcp)
[![npm downloads](https://img.shields.io/npm/dm/apick-mcp?color=%230a7cff)](https://www.npmjs.com/package/apick-mcp)
[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-app.apick-black)](https://registry.modelcontextprotocol.io/v0/servers?search=app.apick)
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)

### **[apick.app](https://apick.app)** — Official site 공식 사이트
**[Integration guide 연동 가이드](https://apick.app/dev_guide/mcp)** · **[Full tool catalog 전체 Tool 목록](TOOLS.md)** · **[API list API 목록](https://apick.app/api_list)**

</div>

---

## What is this? / 이게 뭔가요?

**EN** — APICK is a Korean data and AI API platform. This MCP server exposes **97 tools** for Korean business data, identity verification, OCR, parcel tracking, image and video generation, file conversion, web intelligence, and LLM calls.

**KO** — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 **Tool 97개**로 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 이미지·영상 생성, 파일 변환, 웹 검색과 LLM 호출을 **인증키 하나로** 제공합니다.

**The server is hosted by APICK. Nothing to install, build, or keep running.**
**서버는 에이픽이 운영합니다. 설치할 것도, 띄워둘 것도 없습니다.**

```
https://apick.app/mcp/all
```

---

## Quick start / 빠른 시작

### 1. Get an API key / 인증키 발급

Sign up at **[apick.app](https://apick.app)** and copy your license key from the dashboard. New accounts get **1,000 free points**.
**[apick.app](https://apick.app)** 에서 가입하고 대시보드에서 인증키를 복사하세요. 신규 가입 시 **1,000포인트 무료**.

> `tools/list` works **without** a key — a client can connect and discover all 97 tools before you sign up. Only `tools/call` validates the key and allowed IP.
> `tools/list`는 **인증 없이** 동작합니다. 가입 전에도 클라이언트가 연결해 97개 Tool을 확인할 수 있고, 키와 허용 IP는 `tools/call`부터 검증합니다.

Leave the allowed-IP list blank for unrestricted access. To restrict access, register the public IPv4 address seen by APICK as an exact address or CIDR such as `/32`. Changes apply immediately with no separate synchronization.
마이페이지의 허용 IP가 공란이면 제한 없이 사용할 수 있습니다. 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(`/32` 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화는 필요하지 않습니다.

### 2. Connect / 연결

<table>
<tr><th>Client</th><th>How / 방법</th></tr>
<tr><td><b>Claude Code</b></td><td>

```bash
claude mcp add --transport http apick https://apick.app/mcp/all --header "Authorization: Bearer YOUR_KEY"
```
Restart Claude Code so the tools load. 툴이 로드되도록 재시작하세요.
</td></tr>
<tr><td><b>Claude Desktop</b><br><code>claude_desktop_config.json</code></td><td>

```json
{
  "mcpServers": {
    "apick": {
      "type": "http",
      "url": "https://apick.app/mcp/all",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
```
</td></tr>
<tr><td><b>Cursor</b><br><code>~/.cursor/mcp.json</code></td><td>

```json
{
  "mcpServers": {
    "apick": {
      "url": "https://apick.app/mcp/all",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
```
</td></tr>
<tr><td><b>Windsurf</b><br><code>~/.codeium/windsurf/mcp_config.json</code></td><td>

```json
{
  "mcpServers": {
    "apick": {
      "serverUrl": "https://apick.app/mcp/all",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
```
</td></tr>
<tr><td><b>VS Code</b><br><code>.vscode/mcp.json</code></td><td>

```json
{
  "servers": {
    "apick": {
      "type": "http",
      "url": "https://apick.app/mcp/all",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
```
</td></tr>
<tr><td><b>Cline</b> / any client without<br>remote MCP support<br>원격 MCP 미지원 클라이언트</td><td>

```json
{
  "mcpServers": {
    "apick": {
      "command": "npx",
      "args": ["-y", "apick-mcp", "--server", "all"],
      "env": { "APICK_API_KEY": "YOUR_KEY" }
    }
  }
}
```
Zero-dependency stdio bridge, Node 18+. 의존성 0개 stdio 브릿지.
</td></tr>
</table>

### 3. Ask / 물어보기

```
사업자번호 439-87-00761 정상 사업자인지 확인하고 회사 정보 정리해줘
Check whether Korean business number 439-87-00761 is active and summarize the company
```

The agent picks `biz_detail`, calls it, and reads back the result.
AI가 알맞은 Tool(`biz_detail`)을 골라 호출하고 결과를 정리해 줍니다.

---

## Servers / 서버 목록

Connect to `all` for everything, or to one server to keep the tool list short and the agent's choices focused.
전부 쓰려면 `all`, 특정 분야만 쓰려면 해당 서버에 연결하면 Tool 목록이 짧아져 AI가 더 정확히 고릅니다.

| Server 서버 | Endpoint | Tools | Coverage 범위 |
| --- | --- | --- | --- |
| **All 통합** | `https://apick.app/mcp/all` | **97** | 아래 전부 |
| [Business 사업자·커머스](TOOLS.md#business) | `https://apick.app/mcp/business` | 16 | 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사 |
| [Identity 신분증](TOOLS.md#identity) | `https://apick.app/mcp/identity` | 16 | 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹 |
| [Convert 파일변환](TOOLS.md#convert) | `https://apick.app/mcp/convert` | 22 | PDF·DOCX·엑셀 변환, STT, 비동기 TTS, 워터마크 |
| [Web 웹·검색](TOOLS.md#web) | `https://apick.app/mcp/web` | 13 | 도메인·IP·WHOIS, 웹페이지 수집, 구글 검색, 유튜브 |
| [Vision 이미지·영상](TOOLS.md#vision) | `https://apick.app/mcp/vision` | 6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출 |
| [OCR 문자인식](TOOLS.md#ocr) | `https://apick.app/mcp/ocr` | 6 | 이미지 텍스트 추출, 신분증 항목 추출 |
| [AI · LLM](TOOLS.md#ai) | `https://apick.app/mcp/ai` | 15 | LLM 챗, 텍스트 요약·교정, 이미지 생성·편집·대량 작업, 비동기 영상 생성 |
| [Finance 금융](TOOLS.md#finance) | `https://apick.app/mcp/finance` | 3 | 계좌 예금주 조회, 1원 인증 |

### Every tool / 전체 Tool

**[→ TOOLS.md](TOOLS.md)** — all 97 tools with parameters, types, and copy-paste JSON-RPC examples.
**[→ TOOLS.md](TOOLS.md)** — 97개 전체를 파라미터·타입·호출 예시까지 정리했습니다.

<details>
<summary><b>Tool names at a glance / Tool 이름 한눈에 보기</b></summary>

**Business** `biz_detail` `venture_biz_info` `land_rt_price` `req_pccc` `get_pccc` `check_pccc` `get_car_flooding` `get_car_scrap` `parcel_tracking` `parcel_tracking_auto` `check_email_valid` `check_phone_valid` `check_spam_number` `holiday_info` `search_juso` `info`

**Identity** `identi_card1`–`identi_card5` `identi_card_image1`–`identi_card_image5` `name_rrn_auth` `hide_rrn` `identity_document_id_card` `identity_document_driver_license` `identity_document_passport` `identity_document_residence_card`

**OCR** `ocr` `ocr_identi1` `ocr_identi2` `ocr_identi3` `ocr_identi4` `ocr_identi5`

**Finance** `transfer_1won` `account_realname` `bank_code`

**Web** `nslookup` `reverse_ip` `location` `ip_history` `whois` `url_html` `url_screenshot` `url_similarity` `google_search` `google_image_search` `google_lens_search` `crawl_youtube` `download_youtube_video`

**Convert** `stt` `tts_jobs_create` `tts_jobs_status` `tts_jobs_cancel` `tts_jobs_result` `tts_jobs_subtitles` `tts_jobs_quality` `tts_jobs_retry` `tts_jobs_candidate_audio` `voice_change` `face_blur` `pdf_to_docx` `pdf_to_image` `pdf_merge` `html_to_pdf` `docx_to_pdf` `json_to_excel` `base64_to_image` `set_watermark` `get_watermark` `draw_watermark_pdf` `draw_watermark_image`

**Vision** `nsfw_detection` `image_similarity` `video_to_mp3` `extract_video_thumbnail` `word_cloud` `face_detection`

**AI** `llm_models` `llm_chat` `text_summary` `text_polish` `image_generate` `image_edit` `image_batch_create` `image_batch_status` `image_batch_result` `seedance_jobs_create` `seedance_jobs_status` `veo_jobs_create` `veo_jobs_status` `kling_jobs_create` `kling_jobs_status`

</details>

---

## Use cases / 주요 활용 사례

### 1. B2B onboarding & KYB — 거래처 실사 자동화

> "거래처 사업자번호 목록 검증하고, 폐업이나 휴업 있으면 표로 정리해줘"
> "Validate this list of Korean business numbers and flag any that are closed or suspended"

`biz_detail` → `venture_biz_info` → `check_email_valid` · `check_phone_valid`

Pull registry status, representative, industry code and address for each business number, cross-check the contact email and phone, and get one table back. Replaces manual 국세청/공정위 lookups.
사업자번호마다 국세청 상태·대표자·업종·주소를 끌어오고 담당자 이메일·전화 유효성까지 교차검증해 표 하나로 받습니다.

### 2. Identity verification pipeline — 비대면 신원확인

> "이 신분증 이미지 진위확인하고 주민번호 뒷자리 마스킹한 사본 만들어줘"
> "Verify this ID document image and produce a copy with the registration number masked"

`identi_card_image1` → `ocr_identi1` → `identity_document_id_card`

Checks the document against the government registry, extracts the fields, then returns a masked image safe to store. Covers 주민등록증 · 운전면허증 · 여권 · 외국인등록증 · 주민등록등본.
정부 registry 대조로 진위를 확인하고, 항목을 추출한 뒤, 보관 가능한 마스킹 사본까지 한 번에 만듭니다.

`identity_document_residence_card`는 외국인등록증·영주증·외국국적동포 국내거소신고증의 개인정보 마스킹을 지원합니다. 영주증과 외국국적동포 국내거소신고증은 마스킹만 지원하며 외국인등록증 진위확인 Tool의 범위에는 포함되지 않습니다.
`identity_document_residence_card` masks residence cards, permanent resident cards, and overseas Korean resident cards. The latter two are masking-only and are not accepted by the alien registration card authenticity-check tools.

### 3. Logistics & CS automation — 배송 문의 자동응답

> "운송장 123456789012 지금 어디야? 지연되면 고객 안내문도 써줘"
> "Where is tracking number 123456789012? Draft a customer notice if it's delayed"

`parcel_tracking_auto` → `text_polish`

Auto-detects the carrier from the number alone across **33 Korean carriers** (CJ대한통운, 한진, 롯데, 우체국, 로젠, 쿠팡로지스틱스 …), then drafts the customer message.
운송장 번호만으로 **33개 택배사**를 자동 판별해 조회하고, 고객 안내문 초안까지 씁니다.

### 4. Document processing — 문서 파이프라인

> "이 PDF들 하나로 합치고 워터마크 넣은 다음 DOCX로도 뽑아줘"
> "Merge these PDFs, add a watermark, and also give me a DOCX"

`pdf_merge` → `draw_watermark_pdf` → `pdf_to_docx`

Also: `html_to_pdf` for invoices and reports, `json_to_excel` for data exports, and `stt` for speech recognition.
견적서·리포트는 `html_to_pdf`, 데이터 내보내기는 `json_to_excel`, 음성 인식은 `stt`를 사용합니다.

### 5. Domain & fraud investigation — 도메인·사기 조사

> "이 사이트 IP, 위치, WHOIS 조사하고 우리 사이트랑 얼마나 비슷한지 봐줘"
> "Investigate this site's IP, location