Overview
What is Recruitee MCP Server?
Recruitee MCP Server is a Model Context Protocol (MCP) server for Recruitee that enables advanced, AI-powered search, filtering, reporting, and analytics on recruitment data. It is designed for developers and recruiters who want to connect MCP-compatible AI agents to Recruitee for structured, agent-friendly data access.
How to use Recruitee MCP Server?
Configure your MCP client with the server command or remote URL. For local development, use stdio transport and run with mcp-cli. For production deployments, use streamable-http transport (e.g., to https://recruitee-mcp-server.fly.dev/mcp). Remote access requires a bearer token set via MCP_BEARER_TOKEN.
Key features of Recruitee MCP Server
- Advanced candidate search and filtering by skills, status, talent pool, job, tags
- Recruitment summary reports (time in stage, total process duration)
- Recruitment statistics (average salary, time to hire, contract type stats)
- General search across candidates, recruitments, and talent pools
- Prompt templates for consistent LLM-based summaries
- Supports stdio, streamable-http, and SSE transport methods
Use cases of Recruitee MCP Server
- Find candidates with specific skills who were rejected for salary expectations
- Generate summary reports of recruitment lifecycle duration per stage
- Calculate average expected salary for backend roles
- Quickly locate candidates or talent pools by name or attribute
- Automate recruitment analytics and reporting via AI agents
FAQ from Recruitee MCP Server
What transport methods does the server support?
The server supports stdio (local), streamable-http (recommended for remote/production), and SSE (deprecated in some frameworks).
How do I deploy to Fly.io?
Set secrets in a .env file, then run flyctl auth login and make deploy. The server will be live at https://recruitee-mcp-server.fly.dev/.
What API does it use?
It uses the Recruitee Careers Site API, documented at https://docs.recruitee.com/reference/intro-to-careers-site-api.
What programming language and framework is it built with?
The server is written in Python using the FastMCP framework.
Is there authentication for remote access?
Yes, remote access via streamable-http requires a bearer token passed as an environment variable (MCP_BEARER_TOKEN) or as a header.
