@Slantis/ 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