@slantis/mcp-teamtailor

@slantis/mcp-teamtailor

Full-coverage, read-only MCP server for the Teamtailor recruitment API. Exposes 18 tools covering candidates, jobs, applications, offers, stages, departments, locations, users, and activities with strict input validation.

Category
Visit Server

README

@slantis/mcp-teamtailor

Full-coverage, read-only MCP server for the Teamtailor recruitment API.

Exposes 18 tools covering the entire Teamtailor data model — candidates, jobs, applications, offers, stages, departments, locations, users, and activities — with strict input validation and safe error handling.

Read-only by design. This server makes no write calls. No candidates, jobs, or applications can be created, modified, or deleted through this MCP.


Installation

npm install -g @slantis/mcp-teamtailor
# or run directly with npx (no install needed):
npx @slantis/mcp-teamtailor

Configuration

Add to your Claude Code (or Claude Desktop) MCP config:

{
  "mcpServers": {
    "teamtailor": {
      "command": "npx",
      "args": ["-y", "@slantis/mcp-teamtailor"],
      "env": {
        "TEAMTAILOR_API_KEY": "your-admin-api-key",
        "TEAMTAILOR_URL": "https://api.na.teamtailor.com/v1"
      }
    }
  }
}

Environment variables

Variable Required Default Description
TEAMTAILOR_API_KEY Yes Admin API key from Teamtailor → Settings → API Keys
TEAMTAILOR_URL No https://api.teamtailor.com/v1 Base URL. Use https://api.na.teamtailor.com/v1 for North America
TEAMTAILOR_API_VERSION No 20210218 Teamtailor API version date string

Tools Reference

Candidates

Tool Description
list_candidates List candidates with optional date filters and pagination
get_candidate Get full candidate details by ID

Jobs

Tool Description
list_jobs List jobs — filter by status, department, or location
get_job Get full job details by ID

Applications

Tool Description
list_job_applications List applications — filter by job, candidate, or stage
get_job_application Get application details including current stage

Offers

Tool Description
list_job_offers List job offers — filter by application
get_job_offer Get offer details including sent/accepted/rejected dates

Pipeline

Tool Description
list_stages List pipeline stages — filter by job
get_stage Get stage details by ID

Structure

Tool Description
list_departments List all departments
get_department Get department details by ID
list_locations List all office locations
get_location Get location details by ID

Users

Tool Description
list_users List all Teamtailor users (recruiters, hiring managers)
get_user Get user details by ID

Audit

Tool Description
list_activities List activity log — filter by subject type and ID
get_activity Get a specific activity entry by ID

Example prompts

  • "List the first 5 open jobs in Teamtailor"
  • "Find candidates who applied in the last 7 days"
  • "What stages does job 12345 have?"
  • "Show me all applications for job 42 that are still in the first stage"
  • "What's the activity history for candidate 99?"

Development

npm install
npm run dev          # run with tsx (no build needed)
npm run typecheck    # type-check without emitting
npm test             # run vitest
npm run build        # compile to dist/

License

MIT © Slantis

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured