Summary
Connects Claude to the HuntFlow ATS API with seven tools covering the core recruiting workflow. You can list vacancies and accounts, search for applicants by name or email, pull full candidate profiles with attached resumes, and retrieve recruitment funnel stages. Two built-in prompts give you formatted candidate tables with pipeline status and vacancy statistics including conversion metrics. Useful if you're managing hiring in HuntFlow and want to query candidate data, generate reports, or check vacancy status without leaving your Claude conversation. Requires a HuntFlow API token from your account settings. Part of a larger Russian API MCP series.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
@theyahia/huntflow-mcp
MCP-сервер для HuntFlow ATS API — вакансии, кандидаты, резюме, этапы, справочники, аккаунты. 14 инструментов, 2 скилла.
Часть серии Russian API MCP (50 серверов).
Установка
Claude Desktop (stdio)
{
"mcpServers": {
"huntflow": {
"command": "npx",
"args": ["-y", "@theyahia/huntflow-mcp"],
"env": {
"HUNTFLOW_TOKEN": "ваш-access-token",
"HUNTFLOW_REFRESH_TOKEN": "ваш-refresh-token"
}
}
}
}
Streamable HTTP
HUNTFLOW_TOKEN=ваш-токен npx @theyahia/huntflow-mcp --http
# POST /mcp, GET /health на 127.0.0.1:3000 (PORT=...)
Smithery
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 <secret> на /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 | Статистика по вакансии — воронка, сроки, конверсия |
Разработка
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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
HUNTFLOW_TOKEN*secretAPI key for the service
Registryactive
Package@theyahia/huntflow-mcp
TransportSTDIO
AuthRequired
UpdatedMar 31, 2026