# APICK Subagent MCP server

> Delegates large-scale document research, extraction, summarization, and comparison tasks to an external agent via Codex or Claude Code.

- Repository: https://github.com/lead788/apick-subagent
- Page: https://hostedmcp.org/servers/lead788/apick-subagent
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 1.0.5

## Install

### Claude Code

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

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

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

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

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

### VS Code CLI

```sh
code --add-mcp '{"name":"apick-subagent","type":"stdio","command":"npx","args":["-y","apick-subagent"],"env":{"APICK_API_KEY":"<YOUR_APICK_API_KEY>"}}'
```

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

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

### Codex

```sh
codex mcp add apick-subagent --env 'APICK_API_KEY=<YOUR_APICK_API_KEY>' -- npx -y apick-subagent
```

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

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

[mcp_servers.apick-subagent.env]
APICK_API_KEY = "<YOUR_APICK_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'APICK_API_KEY=<YOUR_APICK_API_KEY>' apick-subagent npx -- -y apick-subagent
```

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

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

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `APICK_API_KEY` | no | yes | APICK API key. Optional if saved with apick-subagent login (connection code from My Page). |

## Tools (7)

- `apick_status`: 에이픽 서브에이전트의 상태·잔액·지원 작업을 확인합니다. 무료입니다.
- `apick_dispatch`: 현재 작업 공간의 지정 파일을 직접 수집해 조사·추출·요약·비교를 위임합니다. 원문을 먼저 전부 읽을 필요가 없습니다. 결과는 근거와 함께 검수하세요. 성공한 작업만 포인트를 청구하며(사용량 기준, AI 사용 작업은 기본 5P) 검수 승인된 동일 결과 재사용은 1P입니다.
- `apick_collect`: 접수한 작업의 상태와 짧은 결과를 확인합니다. next_cursor가 있으면 결과가 더 있습니다.
- `apick_evidence`: 검수할 결과의 정확한 원문 인용·줄 번호·해시를 확인합니다.
- `apick_review`: 직접 확인한 결과 해시에 승인 또는 반려를 기록합니다. 원본 수정·환불 기능은 없습니다.
- `apick_cancel`: 요청한 작업을 취소합니다. 응답 유실을 이유로 새 작업을 재접수하지 마세요.
- `apick_usage`: 작업·외부 호출·토큰·캐시·청구 포인트를 확인합니다. 미연동 주 모델 비용은 절감액으로 확정하지 않습니다.

## FAQ

### How do I install APICK Subagent?

Install it globally using npm by running 'npm install -g apick-subagent' followed by 'apick-subagent install' in your project folder.

### Are there any subscription fees?

There are no installation, introduction, or subscription fees; you only pay for successful tasks based on usage.
