mcpserver.so LogoMCPFly
Submit
Loxo MCP Server logo

Loxo MCP Server

by tbensonwest

Business/Recruitment Automationrecruitmentloxoapiautomationai assistant

The Loxo MCP Server provides tools for AI assistants to interact with the Loxo recruitment platform API. It enables managing candidates, jobs, activities, and call queues.

View on GitHub

Last updated: N/A

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