Loxo MCP Server

What is Loxo MCP Server?

Loxo MCP Server is a Model Context Protocol server that provides tools for interacting with the Loxo recruitment platform API. It enables AI assistants to perform recruitment tasks such as managing candidates, jobs, activities, and call queues.

How to use Loxo MCP Server?

Clone the repository, install dependencies with npm install, and build the project with npm run build. Configure a .env file with your Loxo API key, agency slug, and optional domain (defaults to app.loxo.co). Start the server with npm start or use npm run dev for watch mode.

Key features of Loxo MCP Server

• Activity management: get types, schedule, log activities
• Call queue management: view and add to queue
• Candidate management: search, get details, add notes
• Job management: search, get details, add notes
• Uses Zod for runtime type validation
• Communicates over stdio for seamless AI integration

Use cases of Loxo MCP Server

• Search for candidates in Loxo from an AI assistant
• Schedule future activities for candidates or jobs
• Manage the call queue by adding candidates or contacts
• Add notes to candidates and jobs
• Retrieve today’s tasks and scheduled activities

FAQ from Loxo MCP Server

What environment variables are required?

You must set LOXO_API_KEY (your Loxo API key) and LOXO_AGENCY_SLUG (your agency’s slug). LOXO_DOMAIN is optional and defaults to app.loxo.co.

How do I start the server in development mode?

Use npm run dev to run in watch mode, or npm start for production.

What tools are available for candidate and job management?

For candidates: search-candidates, get-candidate, add-note. For jobs: search-jobs, get-job, add-note.

How does the server handle errors?

It includes comprehensive error handling for environment validation, API request failures, invalid tool parameters, and unknown tool requests.

Is there type safety for inputs and outputs?

Yes, the server uses Zod for runtime type validation of environment variables, tool input parameters, and API responses.