Built by Metorial, the integration platform for agentic AI.

Learn More

Tarran Benson-West/loxo-mcp-server

Loxo Recruitment

    Server Summary

    • Manage candidates

    • Manage jobs

    • Manage activities

    • Manage call queues

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