mcp-teamtailor

The MCP Teamtailor is a Model Context Protocol (MCP) server that provides a simple integration with the teamtailor api.

Dependencies

No other dependencies are required to use the MCP Teamtailor server.

Usage

MCP servers are configured differently depending on the client that you are using. For reference, this is how you would configure it using Claude Desktop.

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

MCP Transport

At the moment, only stdio transport has been implemented.

Tools

• teamtailor_list_candidates - List and filter candidates.

  • pageSize: The size of the page response (string, optional)
  • page: The page number to retrieve (string, optional)
  • filter.createdAfter: Filter candidates created after a specific date (string, optional)
  • filter.createdBefore: Filter candidates created before a specific date (string, optional)
  • filter.updatedAfter: Filter candidates updated after a specific date (string, optional)
  • filter.updatedBefore: Filter candidates updated before a specific date (string, optional)

• teamtailor_get_candidate - Get a single candidate by their id.

  • candidateId: The id of the candidate to retrieve (number, required)

License

Released under the MIT License. See the LICENSE file for further details.