Huntflow Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.0Updated Oct 24, 2026

MCP server for HuntFlow ATS API — vacancies, candidates, applicants for recruiting.

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the HuntFlow recruiting ATS that lets an assistant browse vacancies, search candidates, read resumes and look up funnel stages.

What you can do
List accounts, vacancies and full vacancy details, with filters and pagination for open or owned roles. Search candidates and list applicants attached to a vacancy, then read a candidate's profile and their resumes. Look up recruiting funnel stages, coworkers and reference lists such as sources, rejection reasons, divisions and tags. Run two bundled prompts that build a candidate table for a vacancy and vacancy funnel statistics. List tools return a trimmed field set unless raw output is requested.
When to use it
Useful when recruiting work happens in HuntFlow and you want to ask questions in plain language, such as who is stuck at a given stage, or read a candidate's resume without opening cards in the ATS. Meant for read-oriented lookup rather than editing records.
Requirements
Runs locally via npx with Node.js, or as a local HTTP server on 127.0.0.1:3000. Needs a HuntFlow API access token in HUNTFLOW_TOKEN; an optional refresh token in HUNTFLOW_REFRESH_TOKEN enables automatic renewal. Optional settings cover the token state file, base URL, user agent, timeout, rate limit, port, bind host, HTTP bearer secret and allowed hosts. Network access to the HuntFlow API.
Before you install
Requires a HuntFlow API token, a credential granting access to recruiting data. With a refresh token the server writes the rotated token pair to a state file on disk, by default under the user's home directory. Resume and candidate data are personal recruiting information sent to the model provider. The optional HTTP mode can be protected with HUNTFLOW_HTTP_SECRET; without it, anyone who can reach the port may use the token.

Installation

In SourceWeft

  1. Open Huntflow Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

MCP-сервер для Huntflow — вакансии, кандидаты и резюме ATS через ИИ

Если вы искали, как подключить Huntflow к нейросети, найти кандидата и прочитать его резюме не листая карточки в ATS — это оно. 14 инструментов и 2 скилла: вакансии, кандидаты, резюме, этапы подбора, справочники, аккаунты. Спрашиваете «кто застрял на этапе техинтервью» — получаете список, а не выгрузку в CSV.

[npm] [CI] [License: MIT]

Часть серии WWmcp (46 серверов).

Установка

Claude Desktop (stdio)

json
{  "mcpServers": {    "huntflow": {      "command": "npx",      "args": ["-y", "@theyahia/huntflow-mcp"],      "env": {        "HUNTFLOW_TOKEN": "ваш-access-token",        "HUNTFLOW_REFRESH_TOKEN": "ваш-refresh-token"      }    }  }}

Streamable HTTP

bash
HUNTFLOW_TOKEN=ваш-токен npx @theyahia/huntflow-mcp --http# POST /mcp, GET /health на 127.0.0.1:3000 (PORT=...)

Smithery

bash
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Статистика по вакансии — воронка, сроки, конверсия

Разработка

bash
npm installnpm test           # vitestnpm run typecheck  # tsc --noEmitnpm run lint       # eslintnpm run format     # prettier --writenpm run dev        # tsx src/index.tsnpm run build      # tsc

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

Source: README.md at commit 11b3f3e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts