Skip to main content
Glama
slantis

@slantis/mcp-teamtailor

by slantis
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

@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

Related MCP server: Greenhouse MCP

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Teamtailor

    crunchloop
    A
    license
    C
    quality
    C
    maintenance
    A Model Context Protocol server that enables integration with the Teamtailor API, allowing users to list, filter, and retrieve candidate information from their Teamtailor recruitment platform.
    2
    15 npm
    5
    MIT

  • Greenhouse MCP

    benmonopoli
    A
    license
    B
    quality
    D
    maintenance
    Production-ready MCP server for Greenhouse ATS with 175 tools for recruiting teams — manage candidates, applications, jobs, interviews, and hiring pipelines. Role-based profiles (full/recruiter/read-only), composite workflow tools for pipeline views, analytics, candidate search, and bulk operations.
    100
    17 PyPI
    5
    MIT
  • 100Hires MCP Server by 100Hires

    100Hires MCP Serverofficial

    100Hires
    A
    license
    B
    quality
    F
    maintenance
    Official Model Context Protocol server for 100Hires — the applicant tracking system for recruiting teams. Exposes the full 100Hires API v2 as 130 MCP tools, enabling AI assistants to manage candidates, jobs, applications, interviews, messages, and more.
    100
    7 npm
    1
    MIT