The Loxo MCP Server enables AI assistants to interact with the Loxo recruitment platform API, allowing management of various recruitment-related entities and tasks:
Activity Management: Retrieve activity types, view today's tasks, schedule future activities, and log completed activities for candidates or jobs
Call Queue Management: View the current call queue and add candidates or contacts to it
Candidate Management: Search for candidates, retrieve detailed candidate information, and add notes
Job Management: Search for jobs, access detailed job information, and add notes
The server employs type safety through Zod for runtime validation and includes comprehensive error handling for API interactions.
Loads environment variables from a .env file for configuration, including Loxo API credentials required for authentication with the Loxo platform.
Provides version control for the codebase, allowing developers to clone the repository and manage their own implementations of the Loxo MCP server.
Used for package management, dependency installation, and running build and development scripts for the Loxo MCP server.
Leverages TypeScript for static typing and improved developer experience when building and extending the Loxo MCP server.
Implements runtime type validation for environment variables, tool input parameters, and API responses to ensure data integrity when communicating with the Loxo API.
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
Related MCP server: LinkedIn Model Context Protocol (MCP) Server
Configuration
Copy the provided .env.example file to .env and fill in your values:
Then update the .env file with your configuration:
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
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