Server data from the Official MCP Registry
MCP server for HuntFlow ATS API — vacancies, candidates, applicants for recruiting.
About
MCP server for HuntFlow ATS API — vacancies, candidates, applicants for recruiting.
Security Report
Valid MCP server (2 strong, 3 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
12 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: HUNTFLOW_TOKEN
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-theyahia-huntflow-mcp": {
"env": {
"HUNTFLOW_TOKEN": "your-huntflow-token-here"
},
"args": [
"-y",
"@theyahia/huntflow-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
@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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.