Loxo MCP Server

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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Enables interaction with the Loxo recruitment platform API, facilitating tasks such as candidate and job management, activity logging, and call queue management through AI assistants.

  1. Installation
    1. Configuration
      1. Available Tools
        1. Activity Management
          1. Call Queue Management
            1. Candidate Management
              1. Job Management
              2. Development
                1. Type Safety
                  1. Error Handling
                    1. Architecture