mcpField
M
mcp-teamtailor

mcp-teamtailor

Local
github.com/crunchloopBusiness & Marketing5Updated 79w ago
Repository

About mcp-teamtailor

mcp-teamtailor connects AI clients to the Teamtailor API for candidate lookup. Its tools support filtering candidate lists and retrieving an individual candidate by ID.

Key features

  1. 01List and filter candidates
  2. 02Retrieve a candidate by ID

Use cases

  1. 01Find candidates by creation or update dates
  2. 02Look up a candidate using their ID

MCP support

An MCP server that exposes Teamtailor candidate listing, filtering, and retrieval tools to MCP clients. It currently supports stdio transport.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "teamtailor": {
      "command": "npx",
      "args": [
        "-y",
        "@crunchloop/mcp-teamtailor"
      ],
      "env": {
        "TEAMTAILOR_URL": "<TEAMTAILOR_URL>",
        "TEAMTAILOR_API_KEY": "<TEAMTAILOR_API_KEY>"
      }
    }
  }
}
Run commandnpx -y @crunchloop/mcp-teamtailor
Environment variables to set
TEAMTAILOR_URL
TEAMTAILOR_API_KEYSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@crunchloop/mcp-teamtailor

Tools

2

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
pageSizenumberNo
pagenumberNo
filterobjectNo
filter.createdAfterstringNo
filter.createdBeforestringNo
filter.updatedAfterstringNo
filter.updatedBeforestringNo

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.