apick-mcp 2.5.0 → 3.0.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 변경 기록
 
+## 3.0.0 - 2026-09-05
+
+- 이미지 프롬프트 입력 한도를 최대 28,000자로 확대했습니다.
+- 대량 이미지 작업의 접수 시 선차감·실패 이미지 즉시 환급 계약을 반영했습니다.
+- 접수 후 취소할 수 없는 계약에 맞춰 `image_batch_cancel`을 제거하고 전체 88개, AI 그룹 9개로 갱신했습니다.
+
 ## 2.5.0 - 2026-09-05
 
 - 이미지 대량 수량 필드를 `image_count`로 명확히 하고 압축 조정 필드를 제거했습니다.

package/README.md

@@ -2,7 +2,7 @@
 
 <img src="https://raw.githubusercontent.com/lead788/apick-mcp/main/assets/logo-400.png" alt="APICK" width="88" height="88">
 
-# APICK MCP — 89 Korean Data, AI & Image Tools
+# APICK MCP — 88 Korean Data, AI & Image Tools
 
 **Korean business registry, ID verification, OCR, parcel tracking, file conversion, web intelligence and LLM — as MCP tools for any AI agent.**
 
@@ -22,9 +22,9 @@
 
 ## What is this? / 이게 뭔가요?
 
-**EN** — APICK is a Korean data and AI API platform. This MCP server exposes **89 tools** for Korean business data, identity verification, OCR, parcel tracking, image generation and editing, file conversion, web intelligence, and LLM calls.
+**EN** — APICK is a Korean data and AI API platform. This MCP server exposes **88 tools** for Korean business data, identity verification, OCR, parcel tracking, image generation and editing, file conversion, web intelligence, and LLM calls.
 
-**KO** — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 **Tool 89개**로 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 이미지 생성·편집, 파일 변환, 웹 검색과 LLM 호출을 **인증키 하나로** 제공합니다.
+**KO** — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 **Tool 88개**로 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 이미지 생성·편집, 파일 변환, 웹 검색과 LLM 호출을 **인증키 하나로** 제공합니다.
 
 **The server is hosted by APICK. Nothing to install, build, or keep running.**
 **서버는 에이픽이 운영합니다. 설치할 것도, 띄워둘 것도 없습니다.**
@@ -42,8 +42,8 @@ https://apick.app/mcp/all
 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 89 tools before you sign up. Only `tools/call` validates the key and allowed IP.
-> `tools/list`는 **인증 없이** 동작합니다. 가입 전에도 클라이언트가 연결해 89개 Tool을 확인할 수 있고, 키와 허용 IP는 `tools/call`부터 검증합니다.
+> `tools/list` works **without** a key — a client can connect and discover all 88 tools before you sign up. Only `tools/call` validates the key and allowed IP.
+> `tools/list`는 **인증 없이** 동작합니다. 가입 전에도 클라이언트가 연결해 88개 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` 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화는 필요하지 않습니다.
@@ -149,20 +149,20 @@ Connect to `all` for everything, or to one server to keep the tool list short an
 
 | Server 서버 | Endpoint | Tools | Coverage 범위 |
 | --- | --- | --- | --- |
-| **All 통합** | `https://apick.app/mcp/all` | **89** | 아래 전부 |
+| **All 통합** | `https://apick.app/mcp/all` | **88** | 아래 전부 |
 | [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` | 19 | 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` | 10 | LLM 챗, 텍스트 요약·교정, 이미지 생성·편집·대량 작업 |
+| [AI · LLM](TOOLS.md#ai) | `https://apick.app/mcp/ai` | 9 | LLM 챗, 텍스트 요약·교정, 이미지 생성·편집·대량 작업 |
 | [Finance 금융](TOOLS.md#finance) | `https://apick.app/mcp/finance` | 3 | 계좌 예금주 조회, 1원 인증 |
 
 ### Every tool / 전체 Tool
 
-**[→ TOOLS.md](TOOLS.md)** — all 89 tools with parameters, types, and copy-paste JSON-RPC examples.
-**[→ TOOLS.md](TOOLS.md)** — 89개 전체를 파라미터·타입·호출 예시까지 정리했습니다.
+**[→ TOOLS.md](TOOLS.md)** — all 88 tools with parameters, types, and copy-paste JSON-RPC examples.
+**[→ TOOLS.md](TOOLS.md)** — 88개 전체를 파라미터·타입·호출 예시까지 정리했습니다.
 
 <details>
 <summary><b>Tool names at a glance / Tool 이름 한눈에 보기</b></summary>
@@ -181,7 +181,7 @@ Connect to `all` for everything, or to one server to keep the tool list short an
 
 **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_cancel` `image_batch_result`
+**AI** `llm_models` `llm_chat` `text_summary` `text_polish` `image_generate` `image_edit` `image_batch_create` `image_batch_status` `image_batch_result`
 
 </details>
 
@@ -268,7 +268,7 @@ Built for phishing and copycat-site investigation: resolve the host, trace its I
 | **Transport** | Streamable HTTP — one endpoint per server, JSON-RPC 2.0 over HTTPS POST, stateless | 서버당 단일 엔드포인트, HTTPS POST로 JSON-RPC 2.0, 세션 없이 요청 단위 |
 | **Protocol** | MCP `2026-07-28`, auto-compatible with earlier client versions | MCP `2026-07-28` 기본, 이전 규격 클라이언트 자동 호환 |
 | **Discovery** | `tools/list` returns every tool with JSON Schema, description and live price — no key needed | `tools/list`가 스키마·설명·실시간 단가를 반환, 인증 불필요 |
-| **Annotations** | Every tool declares `title`, `readOnlyHint`, `openWorldHint`. 11 of 89 are not read-only | 전 Tool이 `title`·`readOnlyHint`·`openWorldHint` 선언. 89개 중 상태 변경 Tool은 11개 |
+| **Annotations** | Every tool declares `title`, `readOnlyHint`, `openWorldHint`. 10 of 88 are not read-only | 전 Tool이 `title`·`readOnlyHint`·`openWorldHint` 선언. 88개 중 상태 변경 Tool은 10개 |
 | **Results** | Text (JSON) + `structuredContent`. Images as image content; files up to 8MB as base64 | 텍스트(JSON)와 `structuredContent` 동시 반환. 이미지는 이미지 콘텐츠, 8MB 이하 파일은 base64 |
 | **File input** | File-taking tools accept a public `https` URL (`image_url`, `pdf_url`, …) — APICK downloads and processes it | 파일 Tool은 공개 `https` URL을 받습니다. 에이픽 서버가 내려받아 처리합니다 |
 | **Errors** | Delivered via `isError`; identity masking also preserves `structuredContent.error_code` | `isError`로 전달되며 신분증 마스킹은 `structuredContent.error_code`도 보존합니다 |
@@ -276,8 +276,8 @@ Built for phishing and copycat-site investigation: resolve the host, trace its I
 
 ### Tools with side effects / 부작용이 있는 Tool
 
-78 of 89 tools are read-only. The other 11 change state, charge points, cancel work, or consume a result and carry `readOnlyHint: false` so your client can require approval:
-89개 중 78개는 조회입니다. 나머지 11개는 과금·취소·결과 생성 등 상태를 바꾸므로 `readOnlyHint: false`가 붙습니다.
+78 of 88 tools are read-only. The other 10 change state, charge points, cancel work, or consume a result and carry `readOnlyHint: false` so your client can require approval:
+88개 중 78개는 조회입니다. 나머지 10개는 과금·취소·결과 생성 등 상태를 바꾸므로 `readOnlyHint: false`가 붙습니다.
 
 | Tool | What it does / 하는 일 |
 | --- | --- |

package/TOOLS.md

@@ -1,7 +1,7 @@
 # APICK MCP — Full Tool Catalog / 전체 Tool 목록
 
-**89 tools** across **8 domain servers**, plus the combined `all` server.
-**Tool 89개**, 분야별 서버 8개와 통합 서버 `all`.
+**88 tools** across **8 domain servers**, plus the combined `all` server.
+**Tool 88개**, 분야별 서버 8개와 통합 서버 `all`.
 
 Official site 공식 사이트: **<https://apick.app>** · Docs 연동 가이드: **<https://apick.app/dev_guide/mcp>**
 
@@ -20,9 +20,9 @@ Endpoint pattern: `https://apick.app/mcp/{server}` — connect to `all` for ever
 | [File Conversion · 파일 변환 · 워터마크](#convert) | `/mcp/convert` | 19 | PDF·DOCX·엑셀 변환, 음성인식(STT), 비동기 TTS, 워터마크. |
 | [Vision · 이미지 · 영상 분석](#vision) | `/mcp/vision` | 6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출. |
 | [AI & LLM · AI · LLM](#ai) | `/mcp/ai` | 10 | LLM 챗, 텍스트 도구, 이미지 생성·편집·대량 작업. |
-| **All 통합** | `/mcp/all` | **89** | 아래 전부 |
+| **All 통합** | `/mcp/all` | **88** | 아래 전부 |
 
-<details><summary><b>All 89 tool names / 전체 Tool 이름</b></summary>
+<details><summary><b>All 88 tool names / 전체 Tool 이름</b></summary>
 
 `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`
 
@@ -38,7 +38,7 @@ Endpoint pattern: `https://apick.app/mcp/{server}` — connect to `all` for ever
 
 `nsfw_detection` · `image_similarity` · `video_to_mp3` · `extract_video_thumbnail` · `word_cloud` · `face_detection`
 
-`llm_models` · `llm_chat` · `text_summary` · `text_polish` · `image_generate` · `image_edit` · `image_batch_create` · `image_batch_status` · `image_batch_cancel` · `image_batch_result`
+`llm_models` · `llm_chat` · `text_summary` · `text_polish` · `image_generate` · `image_edit` · `image_batch_create` · `image_batch_status` · `image_batch_result`
 
 </details>
 
@@ -1723,7 +1723,7 @@ Detect faces in an image and return their coordinates.
 
 ## AI & LLM · AI · LLM
 
-`https://apick.app/mcp/ai` — 10 tools
+`https://apick.app/mcp/ai` — 9 tools
 
 LLM chat across multiple models, text summarization, and polishing.
 
@@ -1739,10 +1739,9 @@ LLM 챗(다중 모델), 텍스트 요약·교정.
 | `image_edit` | 이미지 한 장 편집 | `image_url`, `prompt` 및 출력 옵션 |
 | `image_batch_create` | 이미지 대량 작업 생성 | `mode`, `prompt`, `image_count`, 참고·편집 파일 및 출력 옵션 |
 | `image_batch_status` | 대량 작업 상태 조회 | `job_id` |
-| `image_batch_cancel` | 대량 작업 취소 | `job_id` |
 | `image_batch_result` | 대량 작업 개별 결과 | `job_id`, `index` |
 
-이미지 생성·편집은 성공 결과 한 장당 25포인트입니다. `image_generate`에 `reference_image_url`을 더하면 참고 이미지의 구도·색감·제품 형태와 프롬프트를 함께 반영할 수 있습니다. 편집은 원본 이미지 한 장과 프롬프트만 받으며 마스크 파일은 지원하지 않습니다. 동기 Tool은 응답 크기를 위해 한 장만 반환하며, 대량 작업은 `image_count`에 1~50을 지정한 뒤 `image_batch_result`로 한 장씩 가져옵니다. 크기는 `1024x1024`, `1536x1024`, `1024x1536`, `1152x864`, `864x1152` 중에서 고릅니다. PNG·JPEG·WebP와 PNG/WebP 투명 배경 미리보기를 지원합니다. 프롬프트는 최대 6,000자이고 완료 결과는 24시간 동안 반복 조회할 수 있습니다. `idempotency_key`는 같은 요청의 중복 생성·과금을 막는 8~128자 안전번호이며, 동일 요청을 재전송할 때만 같은 값을 사용합니다.
+이미지 생성·편집은 한 장당 25포인트입니다. 작업 접수 시 요청 장수 전체 금액을 먼저 차감하고, 생성에 실패한 이미지가 있으면 해당 장수의 포인트를 즉시 환급합니다. 접수된 작업은 취소할 수 없습니다. `image_generate`에 `reference_image_url`을 더하면 참고 이미지의 구도·색감·제품 형태와 프롬프트를 함께 반영할 수 있습니다. 편집은 원본 이미지 한 장과 프롬프트만 받으며 마스크 파일은 지원하지 않습니다. 동기 Tool은 응답 크기를 위해 한 장만 반환하며, 대량 작업은 `image_count`에 1~50을 지정한 뒤 `image_batch_result`로 한 장씩 가져옵니다. 크기는 `1024x1024`, `1536x1024`, `1024x1536`, `1152x864`, `864x1152` 중에서 고릅니다. PNG·JPEG·WebP와 PNG/WebP 투명 배경 미리보기를 지원합니다. 프롬프트는 최대 28,000자이고 완료 결과는 24시간 동안 반복 조회할 수 있습니다. `idempotency_key`는 같은 요청의 중복 생성·과금을 막는 8~128자 안전번호이며, 동일 요청을 재전송할 때만 같은 값을 사용합니다.
 
 예: `흰색 대리석 테이블 위의 무광 검정 텀블러, 부드러운 아침 자연광, 제품 전체가 프레임 안에 보이게, 이미지 안 글자 없음`처럼 피사체·배경·조명·구도·금지 요소를 구체적으로 적습니다. 글자를 넣을 때는 `상단 중앙에 '가을 산책'을 또렷한 짙은 남색 한글로, 다른 글자 없음`처럼 실제 문구와 위치를 함께 지정합니다.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "apick-mcp",
-  "version": "2.5.0",
-  "description": "APICK MCP — 89 Korean data, AI, and image tools for AI agents. 사업자조회·신분증·OCR·배송조회·이미지 생성·편집·파일변환·검색·LLM.",
+  "version": "3.0.0",
+  "description": "APICK MCP — 88 Korean data, AI, and image tools for AI agents. 사업자조회·신분증·OCR·배송조회·이미지 생성·편집·파일변환·검색·LLM.",
   "type": "module",
   "license": "MIT",
   "author": "APICK",