Loxo MCP Server
by tbensonwest
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
Copy
# 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:
Copy
cp .env.example .env
Then update the .env
file with your configuration:
Copy
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 keyLOXO_AGENCY_SLUG
: Your agency's slug in LoxoLOXO_DOMAIN
: (Optional) Defaults to 'app.loxo.co'
Available Tools
Activity Management
get-activity-types
: Retrieve list of available activity typesspark-search-activity-types
: Get activity types from Spark Searchget-todays-tasks
: Get all tasks and scheduled activities for todayschedule-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 queueadd-to-call-queue
: Add a candidate or contact to the call queue
Candidate Management
search-candidates
: Search for candidates in Loxoget-candidate
: Get detailed information about a specific candidateadd-note
: Add a note to a candidate
Job Management
search-jobs
: Search for jobs in Loxoget-job
: Get detailed information about a specific jobadd-note
: Add a note to a job
Development
Copy
# 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
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.