Teamtailor

The MCP Teamtailor server provides a lightweight integration with the Teamtailor API, exposing candidate data and simple filters through a Model Context Protocol (MCP) interface so you can connect your client applications and automate recruitment workflows.

How to use

You integrate with a client by configuring an MCP server entry that runs locally through a standard MCP transport. The supported transport for this server is stdio, which means the server runs as a process that communicates with your MCP client via standard input and output.

Key capabilities you gain from this server are two tools you can invoke: teamtailor_list_candidates to list and filter candidates, and teamtailor_get_candidate to fetch a single candidate by their ID. Use these endpoints to build flows like listing active applicants, applying date range filters, or retrieving full candidate profiles for review.

To start using it, you provide an MCP configuration that specifies the runtime command and any required environment variables. The runtime is executed by your MCP client via a stdio channel, so your client can send requests and receive responses through the established stream.

How to install

Prerequisites you need before installing:
- Node.js and npm installed on your machine.

Create a configuration file that defines the MCP server you will run through your MCP client. Use the following structure and values as shown.

{
  "mcpServers": {
    "teamtailor": {
      "command": "npx",
      "args": [
        "-y",
        "@crunchloop/mcp-teamtailor"
      ],
      "env": {
        "TEAMTAILOR_URL": "https://api.teamtailor.com/v1",
        "TEAMTAILOR_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Additional notes

Environment variables shown are required for authenticating with the Teamtailor API. Keep your API key secure and avoid committing it to public repositories.

MCP tools available from this server are:

• teamtailor_list_candidates: List and filter candidates with optional parameters for page size, page number, and date-based filters.
• teamtailor_get_candidate: Retrieve details for a single candidate by their ID.

Available tools

teamtailor_list_candidates

List candidates with pagination and date-based filters to help you browse applicant pools.

teamtailor_get_candidate

Fetch detailed information for a single candidate by their ID.