# APICK MCP server

> Gives AI clients Korean business, identity, OCR, parcel, media, web-search and LLM tools through one hosted MCP endpoint.

- Repository: https://github.com/lead788/apick-mcp
- Page: https://hostedmcp.org/servers/lead788/all
- Transport: stdio, remote
- Stars: 1
- License: MIT
- Latest version: 5.10.0

## Install

### Claude Code

```sh
claude mcp add --env APICK_API_KEY=<YOUR_APICK_API_KEY> all -- npx -y apick-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "all": {
      "command": "npx",
      "args": [
        "-y",
        "apick-mcp"
      ],
      "env": {
        "APICK_API_KEY": "<YOUR_APICK_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "all": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "apick-mcp"
      ],
      "env": {
        "APICK_API_KEY": "<YOUR_APICK_API_KEY>"
      }
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "all": {
      "command": "npx",
      "args": [
        "-y",
        "apick-mcp"
      ],
      "env": {
        "APICK_API_KEY": "<YOUR_APICK_API_KEY>"
      }
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.all]
command = "npx"
args = ["-y", "apick-mcp"]

[mcp_servers.all.env]
APICK_API_KEY = "<YOUR_APICK_API_KEY>"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "all": {
      "command": "npx",
      "args": [
        "-y",
        "apick-mcp"
      ],
      "env": {
        "APICK_API_KEY": "<YOUR_APICK_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `APICK_API_KEY` | no | yes | Bearer <APICK license key>. Get a free key with 1,000 free points at https://apick.app (tools/list works without a key). |
| `APICK_MCP_SERVER` | no | no | Which APICK server to expose: all, business, identity, ocr, finance, web, convert, vision, ai. |

## Tools (39)

- `task`
- `limit`
- `req_employment`
- `get_employment`
- `req_personal_income`
- `get_personal_income`
- `req_nps_join_history`
- `get_nps_join_history`
- `req_nps_deduction_cert`
- `get_nps_deduction_cert`
- `req_nps_career_history`
- `get_nps_career_history`
- `req_driving_license`
- `get_driving_license`
- `req_health_checkup`
- `get_health_checkup`
- `req_cash_receipt_deduction`
- `get_cash_receipt_deduction`
- `req_tax_return_history`
- `get_tax_return_history`
- `req_income_cert_bundle`
- `get_income_cert_bundle`
- `req_business_cert_bundle`
- `get_business_cert_bundle`
- `req_nps_bundle`
- `get_nps_bundle`
- `req_hometax_bundle`
- `get_hometax_bundle`
- `req_hometax_biz_bundle`
- `get_hometax_biz_bundle`
- `transfer_1won`
- `req_pccc`
- `get_pccc`
- `tts_jobs_cancel`
- `tts_jobs_result`
- `tts_jobs_subtitles`
- `seedance_jobs_create`
- `veo_jobs_create`
- `kling_jobs_create`

## FAQ

### Do I need an API key to list APICK MCP tools?

No. Tool discovery works without a key, but calling any tool requires a valid license key from apick.app.

### How do I connect APICK MCP to Claude Code?

Run the claude mcp add command with the HTTP transport, the all endpoint and a Bearer token header, then restart Claude Code.

### How many tools does APICK MCP provide?

The all server exposes 224 tools covering business, identity, OCR, convert, web, vision, AI and finance domains.

### What MCP timeout should I set for slow APICK tools?

Set at least 120 seconds, and 660 seconds if you use speech-to-text, long chats, image generation or registry issuance tools.

### Is there a way to find the right APICK tool for a task?

Yes, the find_tools tool recommends matching APICK tools for a natural-language task description free of charge.