MCP server for HuntFlow ATS API — vacancies, candidates, applicants for recruiting.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"huntflow": {
"env": {
"HUNTFLOW_TOKEN": "ваш-токен"
},
"args": [
"-y",
"@theyahia/huntflow-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
MCP-сервер для HuntFlow ATS API — вакансии, кандидаты, резюме, этапы, аккаунты. 7 инструментов, 2 скилла.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@theyahia/huntflow-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked @theyahia/huntflow-mcp against OSV.dev.
Click any tool to inspect its schema.
skill-applicantsКандидаты на вакансию — таблица с этапами и сводкой
skill-vacancy-statsСтатистика по вакансии — воронка, сроки, конверсия
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in productivity
Dynamic problem-solving through sequential thought chains
Persistent memory using a knowledge graph
mini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local
Official Notion MCP Server
MCP Security Weekly
Get CVE alerts and security updates for Huntflow MCP Server and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
MCP-сервер для HuntFlow ATS API — вакансии, кандидаты, резюме, этапы, справочники, аккаунты. 14 инструментов, 2 скилла.
Часть серии Russian API MCP (50 серверов).
{
"mcpServers": {
"huntflow": {
"command": "npx",
"args": ["-y", "@theyahia/huntflow-mcp"],
"env": {
"HUNTFLOW_TOKEN": "ваш-access-token",
"HUNTFLOW_REFRESH_TOKEN": "ваш-refresh-token"
}
}
}
}
HUNTFLOW_TOKEN=ваш-токен npx @theyahia/huntflow-mcp --http
# POST /mcp, GET /health на 127.0.0.1:3000 (PORT=...)
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 |
| Инструмент | Описание |
|---|---|
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.
| Скилл | Описание |
|---|---|
skill-applicants | Кандидаты на вакансию — таблица с этапами и сводкой |
skill-vacancy-stats | Статистика по вакансии — воронка, сроки, конверсия |
npm install
npm test # vitest
npm
... [View full README on GitHub](https://github.com/theYahia/huntflow-mcp#readme)