Loxo Platform Integration Service (MCP Node)

This Model Context Protocol (MCP) server functions as a dedicated gateway for systems interfacing with the Loxo talent management platform's Application Programming Interface (API). It equips intelligent agents with functionalities to execute critical HR/recruitment workflows, specifically concerning the maintenance of applicant data, job definitions, interaction history, and prioritized contact lists.

Setup Procedure

To deploy this service, follow these steps:

# Obtain source code
git clone [repository-url]
cd loxo-mcp-server

# Install necessary packages
npm install

# Compile TypeScript to JavaScript
npm run build

Configuration Directives

Duplicate the template configuration file (.env.example) into a local .env file and populate the required credentials:

cp .env.example .env

Mandatory values within .env:

LOXO_API_KEY=your_secret_credential
LOXO_DOMAIN=app.loxo.co
LOXO_AGENCY_SLUG=your_organizational_identifier

Environment Variables Checklist: - LOXO_API_KEY: Essential authentication token for API access. - LOXO_AGENCY_SLUG: Identifies the specific tenant/agency within Loxo. - LOXO_DOMAIN: (Optional) Specifies the Loxo deployment endpoint; defaults to 'app.loxo.co'.

Exposed Functionality Set

Interaction Record Management

• get-activity-types: Retrieves the standardized catalogue of interaction categories.
• spark-search-activity-types: Fetches interaction definitions sourced from the Spark Search module.
• get-todays-tasks: Fetches all pending obligations and scheduled engagements for the present day.
• schedule-activity: Creates a record for a future planned engagement (e.g., interview, follow-up call).
• log-activity: Persists a completed interaction record against a specific candidate or role.

Contact Prioritization Queue Control

• get-call-queue: Displays the existing sequence of contacts awaiting outreach.
• add-to-call-queue: Inserts an individual (candidate or contact) into the outreach rotation.

Applicant Data Orchestration

• search-candidates: Executes searches across the candidate repository.
• get-candidate: Fetches comprehensive details for an individual applicant record.
• add-note: Appends unstructured commentary to an applicant's profile.

Job Requisition Handling

• search-jobs: Queries the active list of open job requisitions.
• get-job: Retrieves exhaustive details for a specified job opening.
• add-note: Attaches contextual comments to a job description.

Operational Mode

For active development and iterative testing:

# Initiate development environment with file watching
npm run dev

# Perform a clean production build
npm run build

# Launch the running service instance
npm start

Integrity Assurance (Type Safety)

The service employs the Zod schema validation library to ensure runtime type correctness for: - Environment variable integrity checks - Definitions of input parameters for each tool invocation - Structure validation of incoming data from the Loxo API

Failure Management

Robust exception handling is implemented across several critical points: - Failures during environment variable parsing and setup - Errors encountered during external API communications - Validation failures for supplied tool arguments - Requests targeting undefined or non-existent capabilities

System Structure

• Developed utilizing the Model Context Protocol SDK framework.
• Communication backbone relies on standard input/output (stdio) streams for seamless integration with AI orchestration layers.
• Written in TypeScript to enforce strong typing and enhance developer maintainability.
• Interaction layer built upon conventional RESTful methodology targeting Loxo's backend.