Happy slice of mcp pizzaMCP.pizza
Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

loxo-mcp-server

MCP.Pizza Chef: tbensonwest

The Loxo MCP Server is a Model Context Protocol server designed to integrate AI assistants with the Loxo recruitment platform API. It provides structured tools that allow AI models to manage recruitment workflows such as handling candidates, jobs, activities, and call queues. This server facilitates seamless automation and real-time interaction with Loxo's recruitment data, enabling enhanced productivity and smarter hiring processes. It supports configuration via environment variables for API keys and agency details, making it adaptable to different Loxo accounts. Developers can install, build, and deploy this server to empower AI-driven recruitment assistants with direct access to Loxo's platform capabilities.

Use This MCP server To

Automate candidate data retrieval and updates Manage job postings and status changes Track and log recruitment activities Handle call queue management for recruiters Integrate recruitment workflows into AI assistants

README

Loxo MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with the Loxo recruitment platform API. This server enables AI assistants to perform various recruitment-related tasks such as managing candidates, jobs, activities, and call queues.

Installation

# Clone the repository
git clone [repository-url]
cd loxo-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Copy the provided .env.example file to .env and fill in your values:

cp .env.example .env

Then update the .env file with your configuration:

LOXO_API_KEY=your_api_key
LOXO_DOMAIN=app.loxo.co
LOXO_AGENCY_SLUG=your_agency_slug

Required environment variables:

  • LOXO_API_KEY: Your Loxo API key
  • LOXO_AGENCY_SLUG: Your agency's slug in Loxo
  • LOXO_DOMAIN: (Optional) Defaults to 'app.loxo.co'

Available Tools

Activity Management

  • get-activity-types: Retrieve list of available activity types
  • spark-search-activity-types: Get activity types from Spark Search
  • get-todays-tasks: Get all tasks and scheduled activities for today
  • schedule-activity: Schedule a future activity (call, meeting, etc.)
  • log-activity: Log an activity for a candidate or job

Call Queue Management

  • get-call-queue: View the current call queue
  • add-to-call-queue: Add a candidate or contact to the call queue

Candidate Management

  • search-candidates: Search for candidates in Loxo
  • get-candidate: Get detailed information about a specific candidate
  • add-note: Add a note to a candidate

Job Management

  • search-jobs: Search for jobs in Loxo
  • get-job: Get detailed information about a specific job
  • add-note: Add a note to a job

Development

# Run in development mode with watch mode
npm run dev

# Build the project
npm run build

# Start the server
npm start

Type Safety

The server uses Zod for runtime type validation of:

  • Environment variables
  • Tool input parameters
  • API responses

Error Handling

The server includes comprehensive error handling for:

  • Environment validation
  • API request failures
  • Invalid tool parameters
  • Unknown tool requests

Architecture

  • Built using the Model Context Protocol SDK
  • Communicates over stdio for seamless integration with AI assistants
  • Uses TypeScript for type safety and better developer experience
  • Implements RESTful API calls to Loxo's platform

loxo-mcp-server FAQ

How do I configure the Loxo MCP Server?
Copy the .env.example file to .env and set your LOXO_API_KEY, LOXO_AGENCY_SLUG, and optionally LOXO_DOMAIN.
What environment variables are required?
LOXO_API_KEY, LOXO_AGENCY_SLUG, and optionally LOXO_DOMAIN (defaults to 'app.loxo.co').
How do I install and build the server?
Clone the repo, run npm install, then npm run build to prepare the server.
Can this server be used with multiple LLM providers?
Yes, it supports integration with OpenAI, Anthropic Claude, and Google Gemini models via MCP.
Is the Loxo MCP Server customizable?
Yes, you can extend or modify the server tools to fit specific recruitment workflows.
Does the server handle authentication?
Authentication is managed via the LOXO_API_KEY environment variable for secure API access.
What recruitment features does the server expose?
Candidate management, job management, activity tracking, and call queue handling are included.
How does the server improve recruitment automation?
By enabling AI assistants to interact directly with Loxo's API, it streamlines repetitive tasks and data access.