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, job opportunities, activities, and call queues.

🚀 Quick Start

📦 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 and rename it to .env, then fill in the values:

cp .env.example .env

Then update the configuration in the .env file:

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

Required environment variables:

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

✨ Features

📋 Activity Management

• get-activity-types: Get all 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 future activities (calls, meetings, etc.)
• log-activity: Log activities for candidates or job opportunities

📞 Call Queue Management

• get-call-queue: View the current call queue
• add-to-call-queue: Add candidates or contacts 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 Opportunity Management

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

💻 Usage Examples

🛠️ Development

# Run in development mode with monitoring
npm run dev

# Build the project
npm run build

# Start the server
npm start

🔒 Type Safety

This server uses Zod for runtime type validation:

• Environment variables
• Tool input parameters
• API responses

🚫 Error Handling

The server includes comprehensive error handling capabilities:

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

🔧 Technical Details

• Built using the Model Context Protocol SDK
• Communicates via stdio for seamless integration with AI assistants
• Implemented in TypeScript for type safety and a better development experience
• Implements RESTful API calls to the Loxo platform