Skip to Content
MCP ServersCommunityLoxo MCP Server

Loxo MCP Server

View original on GitHub 

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
Last updated on
Potential ContributionsLSD MCP server