mcp-teamtailor

What is mcp-teamtailor?

mcp-teamtailor is a Model Context Protocol (MCP) server that provides a simple integration with the Teamtailor API. It is designed for developers and teams who want to access Teamtailor candidate data through an MCP client like Claude Desktop.

How to use mcp-teamtailor?

Configure the server in your MCP client (e.g., Claude Desktop) with the command npx -y @crunchloop/mcp-teamtailor and set environment variables TEAMTAILOR_URL (e.g., https://api.teamtailor.com/v1) and TEAMTAILOR_API_KEY. Then use the provided tools to list, filter, or retrieve candidates.

Key features of mcp-teamtailor

• List candidates with optional filters and pagination
• Get a single candidate by ID
• No additional dependencies required
• Lightweight, stdio-based transport

Use cases of mcp-teamtailor

• Querying candidate records from Teamtailor inside an AI assistant
• Filtering candidates by creation or update dates
• Retrieving detailed candidate information by ID

FAQ from mcp-teamtailor

What does this server do that alternatives don't?

This server is a lightweight MCP wrapper around the Teamtailor API, requiring zero additional dependencies and using a simple stdio transport for easy integration with any MCP client.

What are the runtime dependencies?

No other dependencies are required beyond Node.js and the package itself.

Where does the data live?

Data is fetched directly from the Teamtailor API using the credentials you provide. No data is stored locally by the server.

What transport does it use?

Only stdio transport has been implemented at this time.

How is authentication handled?

You provide a TEAMTAILOR_API_KEY environment variable. The server uses this key to authenticate requests to the Teamtailor API.