Huntflow MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Порт HTTP-сервера. | 3000 |
| NODE_OPTIONS | No | --use-system-ca — если запросы падают с ошибкой сертификата (корпоративный прокси). | |
| HUNTFLOW_TOKEN | Yes | Access-токен (Настройки → API-токены). | |
| HUNTFLOW_BASE_URL | No | Базовый URL API Huntflow. | https://api.huntflow.ru/v2 |
| HUNTFLOW_HTTP_HOST | No | Хост привязки HTTP. | 127.0.0.1 |
| HUNTFLOW_READ_ONLY | No | 1 — отключить инструменты записи (останутся 14 инструментов чтения). | |
| HUNTFLOW_TIMEOUT_MS | No | Таймаут запроса, мс. | 10000 |
| HUNTFLOW_TOKEN_FILE | No | Файл для хранения ротированной пары. | ~/.huntflow-mcp/token.json |
| HUNTFLOW_USER_AGENT | No | User-Agent (обязателен для API; есть дефолт). | |
| HUNTFLOW_HTTP_SECRET | No | Если задан — требует Authorization: Bearer <secret> на /mcp. | |
| HUNTFLOW_ALLOWED_HOSTS | No | Список host:port для защиты от DNS-rebinding. | |
| HUNTFLOW_REFRESH_TOKEN | No | Refresh-токен — включает авто-обновление при 401. | |
| HUNTFLOW_DISABLE_RATELIMIT | No | 1 — отключить клиентский лимит 10 req/s. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_accountsC | Список доступных аккаунтов HuntFlow. |
| list_vacanciesB | Список вакансий в HuntFlow (по умолчанию открытые). |
| search_applicantsA | Поиск кандидатов по имени/email/телефону и фильтрам (вакансия, этап, тег). |
| list_vacancy_applicantsC | Кандидаты, прикреплённые к конкретной вакансии. |
| get_applicant_resumesC | Резюме кандидата (все прикреплённые external). |
| list_stagesC | Этапы воронки подбора (статусы вакансий). |
| list_coworkersC | Сотрудники/рекрутеры аккаунта. |
| list_sourcesC | Справочник источников кандидатов. |
| list_rejection_reasonsC | Справочник причин отказа. |
| list_divisionsC | Справочник подразделений (отделов). |
| list_tagsC | Справочник тегов аккаунта. |
| get_vacancyC | Полная информация о вакансии. |
| get_applicantC | Полная информация о кандидате. |
| get_resumeB | Полное тело конкретного резюме (external) кандидата. |
| create_applicantA | Создать кандидата в базе. Перед созданием проверьте через search_applicants, что его ещё нет. |
| update_applicantB | Изменить поля кандидата (имя, контакты, должность, зарплата). Меняются только переданные поля. |
| add_applicant_to_vacancyC | Прикрепить кандидата к вакансии на указанный этап подбора. |
| change_applicant_statusA | Перевести кандидата на другой этап подбора по вакансии (в т.ч. отказ с причиной или найм). |
| add_applicant_commentA | Добавить комментарий в ленту кандидата (по вакансии или личную заметку). |
| set_applicant_tagsA | Задать теги кандидата. Заменяет весь список тегов — передавайте и те, что нужно сохранить. |
| create_vacancyD | Создать вакансию. |
| update_vacancyA | Изменить поля вакансии (название, зарплата, описание, приоритет). Меняются только переданные поля. |
| set_vacancy_stateC | Закрыть, приостановить или возобновить вакансию. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| skill-applicants | Кандидаты на вакансию — показать всех кандидатов, прикреплённых к указанной вакансии. |
| skill-vacancy-stats | Статистика по вакансии — воронка, сроки, конверсия. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 23 tools
Most tools target clearly distinct resources/actions, and descriptions clarify overlaps such as search_applicants versus list_vacancy_applicants. A few pairs (get_applicant_resumes vs get_resume, list_vacancies vs get_vacancy) are close but still distinguishable.
Tool names consistently use snake_case with predictable verb_noun patterns: list_, get_, search_, create_, update_, add_, change_, set_. The few noun-only variants still fit the same readable convention.
At 23 tools the surface is somewhat heavy, but the ATS domain has many legitimate entities and reference lists. Each tool appears to serve a distinct workflow rather than being redundant.
Core applicant and vacancy workflows are well covered: search, get, create, update, attach to vacancy, move stage, comment, tags, and vacancy state. Gaps exist around deletion and richer comment/resume management, but the main lifecycle is usable.