HuntFlow MCP Server
This server provides integration with the HuntFlow ATS (Applicant Tracking System) API, enabling recruitment and hiring workflow management through 14 tools and 2 skill prompts.
Account & Vacancy Management
list_accounts— Retrieve all accessible HuntFlow accountslist_vacancies— Browse vacancies with filters (open status, state, assigned to current user) and paginationget_vacancy— Fetch full details about a specific vacancy
Candidate & Resume Management
search_applicants— Search candidates by name or email, with filters for vacancy, status, and tagslist_vacancy_applicants— List candidates attached to a specific vacancyget_applicant— Retrieve complete information about a specific candidateget_applicant_resumes— Get all resumes attached to a candidateget_resume— Fetch the full body of a specific external resume
Reference Directories & Pipeline
list_stages— View recruitment pipeline stages (vacancy statuses)list_coworkers— View recruiters and employees in an accountlist_sources— Browse the candidate source reference directorylist_rejection_reasons— View rejection reason reference datalist_divisions— Browse organizational divisionslist_tags— View available candidate tags
Skill Prompts
skill-applicants— Generate a table of candidates for a vacancy with stages and summaryskill-vacancy-stats— Produce vacancy statistics including funnel, timelines, and conversion rates
Key Features: Returns curated fields by default to save tokens (use raw: true for full API responses); supports pagination via page/count parameters; includes automatic token refresh and rate limiting (10 req/s).
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@HuntFlow MCP Serverlist my open vacancies"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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-mcpRelated MCP server: Viterbit MCP Server
Получение токена
Настройки HuntFlow → вкладка «API-токены» (API Tokens) → создать токен. Выданная пара включает access-токен (живёт ~7 дней) и refresh-токен (~14 дней). Сервер автоматически обновляет access-токен через POST /token/refresh при истечении и сохраняет ротированную пару в файл состояния (HUNTFLOW_TOKEN_FILE), переживая рестарты. Если задать только HUNTFLOW_TOKEN без refresh — сервер проработает до истечения access-токена (~7 дней), затем потребуется новый токен.
Переменные окружения
Переменная | Обяз. | Описание |
| да | Access-токен (Настройки → API-токены) |
| нет | Refresh-токен — включает авто-обновление при 401 |
| нет | Файл для хранения ротированной пары (по умолчанию |
| нет | По умолчанию |
| нет | User-Agent (обязателен для API; есть дефолт) |
| нет | Таймаут запроса, мс (по умолчанию 10000) |
| нет |
|
| нет | Порт HTTP-сервера (по умолчанию 3000) |
| нет | Хост привязки HTTP (по умолчанию |
| нет | Если задан — требует |
| нет | Список host:port для защиты от DNS-rebinding |
Инструменты (14)
Инструмент | Описание |
| Список доступных аккаунтов |
| Список вакансий (фильтры |
| Полная информация о вакансии |
| Поиск кандидатов ( |
| Кандидаты, прикреплённые к конкретной вакансии |
| Полная информация о кандидате |
| Список резюме (external) кандидата |
| Полное тело конкретного резюме (external) |
| Этапы воронки подбора (статусы вакансий) |
| Сотрудники/рекрутеры аккаунта |
| Справочник источников кандидатов |
| Справочник причин отказа |
| Справочник подразделений |
| Справочник тегов |
Списочные инструменты возвращают курированный набор полей (экономия токенов) + structuredContent; передайте raw: true для полного сырого ответа. Пагинация — параметры page/count.
Скиллы (Prompts)
Скилл | Описание |
| Кандидаты на вакансию — таблица с этапами и сводкой |
| Статистика по вакансии — воронка, сроки, конверсия |
Разработка
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
Maintenance
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/huntflow-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server