# Huntflow Mcp

> MCP server for Huntflow — ATS, vacancies, candidates, recruiting (Russia)

- **Type:** MCP server
- **Install:** `agentstack add mcp-theyahia-huntflow-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [theYahia](https://agentstack.voostack.com/s/theyahia)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [theYahia](https://github.com/theYahia)
- **Source:** https://github.com/theYahia/huntflow-mcp

## Install

```sh
agentstack add mcp-theyahia-huntflow-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# @theyahia/huntflow-mcp

MCP-сервер для HuntFlow ATS API — вакансии, кандидаты, резюме, этапы, справочники, аккаунты. **14 инструментов, 2 скилла.**

[](https://www.npmjs.com/package/@theyahia/huntflow-mcp)
[](https://github.com/theYahia/huntflow-mcp/actions/workflows/ci.yml)
[](https://opensource.org/licenses/MIT)

Часть серии [Russian API MCP](https://github.com/theYahia/russian-mcp) (50 серверов).

## Установка

### Claude Desktop (stdio)
```json
{
  "mcpServers": {
    "huntflow": {
      "command": "npx",
      "args": ["-y", "@theyahia/huntflow-mcp"],
      "env": {
        "HUNTFLOW_TOKEN": "ваш-access-token",
        "HUNTFLOW_REFRESH_TOKEN": "ваш-refresh-token"
      }
    }
  }
}
```

### Streamable HTTP
```bash
HUNTFLOW_TOKEN=ваш-токен npx @theyahia/huntflow-mcp --http
# POST /mcp, GET /health на 127.0.0.1:3000 (PORT=...)
```

### Smithery
```bash
npx @smithery/cli install @theyahia/huntflow-mcp
```

## Получение токена

Настройки HuntFlow → вкладка **«API-токены» (API Tokens)** → создать токен. Выданная пара включает **access-токен** (живёт ~7 дней) и **refresh-токен** (~14 дней). Сервер автоматически обновляет access-токен через `POST /token/refresh` при истечении и **сохраняет ротированную пару** в файл состояния (`HUNTFLOW_TOKEN_FILE`), переживая рестарты. Если задать только `HUNTFLOW_TOKEN` без refresh — сервер проработает до истечения access-токена (~7 дней), затем потребуется новый токен.

## Переменные окружения

| Переменная | Обяз. | Описание |
|------------|:---:|----------|
| `HUNTFLOW_TOKEN` | да | Access-токен (Настройки → API-токены) |
| `HUNTFLOW_REFRESH_TOKEN` | нет | Refresh-токен — включает авто-обновление при 401 |
| `HUNTFLOW_TOKEN_FILE` | нет | Файл для хранения ротированной пары (по умолчанию `~/.huntflow-mcp/token.json`) |
| `HUNTFLOW_BASE_URL` | нет | По умолчанию `https://api.huntflow.ru/v2` |
| `HUNTFLOW_USER_AGENT` | нет | User-Agent (обязателен для API; есть дефолт) |
| `HUNTFLOW_TIMEOUT_MS` | нет | Таймаут запроса, мс (по умолчанию 10000) |
| `HUNTFLOW_DISABLE_RATELIMIT` | нет | `1` — отключить клиентский лимит 10 req/s |
| `PORT` | нет | Порт HTTP-сервера (по умолчанию 3000) |
| `HUNTFLOW_HTTP_HOST` | нет | Хост привязки HTTP (по умолчанию `127.0.0.1`) |
| `HUNTFLOW_HTTP_SECRET` | нет | Если задан — требует `Authorization: Bearer ` на `/mcp` |
| `HUNTFLOW_ALLOWED_HOSTS` | нет | Список host:port для защиты от DNS-rebinding |

## Инструменты (14)

| Инструмент | Описание |
|------------|----------|
| `list_accounts` | Список доступных аккаунтов |
| `list_vacancies` | Список вакансий (фильтры `opened`/`state`/`mine`, пагинация) |
| `get_vacancy` | Полная информация о вакансии |
| `search_applicants` | Поиск кандидатов (`q` + фильтры vacancy/status/tag) |
| `list_vacancy_applicants` | Кандидаты, прикреплённые к конкретной вакансии |
| `get_applicant` | Полная информация о кандидате |
| `get_applicant_resumes` | Список резюме (external) кандидата |
| `get_resume` | Полное тело конкретного резюме (external) |
| `list_stages` | Этапы воронки подбора (статусы вакансий) |
| `list_coworkers` | Сотрудники/рекрутеры аккаунта |
| `list_sources` | Справочник источников кандидатов |
| `list_rejection_reasons` | Справочник причин отказа |
| `list_divisions` | Справочник подразделений |
| `list_tags` | Справочник тегов |

Списочные инструменты возвращают курированный набор полей (экономия токенов) + `structuredContent`; передайте `raw: true` для полного сырого ответа. Пагинация — параметры `page`/`count`.

## Скиллы (Prompts)

| Скилл | Описание |
|-------|----------|
| `skill-applicants` | Кандидаты на вакансию — таблица с этапами и сводкой |
| `skill-vacancy-stats` | Статистика по вакансии — воронка, сроки, конверсия |

## Разработка

```bash
npm install
npm test           # vitest
npm run typecheck  # tsc --noEmit
npm run lint       # eslint
npm run format     # prettier --write
npm run dev        # tsx src/index.ts
npm run build      # tsc
```

## Лицензия
MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [theYahia](https://github.com/theYahia)
- **Source:** [theYahia/huntflow-mcp](https://github.com/theYahia/huntflow-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-theyahia-huntflow-mcp
- Seller: https://agentstack.voostack.com/s/theyahia
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.