@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.
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
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
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.
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.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
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.
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.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
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.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.