hirelayer-mcp 2.0.0 → 2.1.0

package/README.md

@@ -41,7 +41,7 @@ The official [Model Context Protocol](https://modelcontextprotocol.io) server fo
 ## What you can do
 
 - **Parse resumes and CVs** (Resume Parser). Turn PDF, Word, image and other files into structured JSON: contact details, work experience, education, languages, skills and the full text. Scanned resumes go through OCR, and the resume language is detected.
-- **Turn a job description into criteria** (Job Criteria Extractor). Get typed, weighted criteria, each marked required, preferred or bonus. Free.
+- **Turn a job description into criteria** (Job Criteria Extractor). Get the typed, weighted criteria the posting states, each marked required, preferred or bonus, in English, French, German, Spanish or Portuguese. Free.
 - **Score and rank resumes** (Resume Scorer). Score up to 50 resumes against a job in one call, from 0 to 1, with a verdict, a summary and the evidence for each criterion, best first. Ask for a precise ranking to re-rank the 10 best with a reason each.
 - **Search your talent pool** (Talent Pool Search). Find the resumes already in your HireLayer database closest to a job, around a city if you like.
 - **Recommend jobs** (Job Recommendations). Find your open jobs closest to a candidate.
@@ -218,8 +218,8 @@ In Docker, `parse_resume` only reads files that you mount into the container. Ot
 | Tool | Product | What it does | Typical input |
 |---|---|---|---|
 | `parse_resume` | Resume Parser | Parses a resume or CV into structured JSON: contact details, experience, education, languages, skills and the full text, stored under an `application_id` | A local `file_path`, a public `file_url` or the `resume_text`. Accepts PDF, DOC, DOCX, ODT, RTF, TXT, HTML, Markdown, PPT, PPTX, ODP, XLS, JPG, PNG or BMP files under 4.5 MB. |
-| `extract_job_criteria` | Job Criteria Extractor | Turns a job description into typed criteria, each with a requirement (required, preferred or bonus) and a weight from 0 to 3, and stores the job under a `job_id` | Job description text |
-| `score_resumes` | Resume Scorer | Scores 1 to 50 resumes against one job, best first: a score from 0 to 1, a verdict, a summary, the required criteria missing and the evidence for each criterion. `precise_ranking` re-ranks the 10 best with a reason each | The job as `job_text` (optionally with your own `criteria`) or a `job_id`, and each resume as `text` or an `application_id` |
+| `extract_job_criteria` | Job Criteria Extractor | Turns a job description into the typed criteria it states, each with a requirement (required, preferred or bonus) and a weight from 0 to 3, and stores the job under a `job_id` | Job description text, at least 30 characters |
+| `score_resumes` | Resume Scorer | Scores 1 to 50 resumes against one job, best first: a score from 0 to 1, a verdict, a summary, the required criteria missing and the evidence for each criterion. `precise_ranking` re-ranks the 10 best with a reason each | The job as `job_text` (optionally with your own `criteria`) or a `job_id`, and each resume as `text` or an `application_id`; at least one resume of 30 characters or more |
 | `search_resumes` | Talent Pool Search | Finds the stored resumes closest to a job, with optional city, radius and date filters. Proximity only: score the ones worth it with `score_resumes` | A `job_id` or `job_text` |
 | `search_jobs` | Job Recommendations | Finds the stored open jobs closest to a resume. Proximity only | An `application_id` or `resume_text` |
 | `normalize_skills` | Skills Normalizer | Maps free-text skills to taxonomy skills, with their families and domains, named in French or English | Free text, from one skill to a whole skills section |
@@ -296,7 +296,7 @@ Trimmed to one resume and one criterion:
 }
 ```
 
-Criteria, summaries and explanations are written in the job's language (French or English) unless you pass `language`; evidence quotes the resume in its own language.
+Criteria, summaries and explanations are written in the job's language (English, French, German, Spanish or Portuguese; English for any other) unless you pass `language`; evidence quotes the resume in its own language.
 
 </details>
 
@@ -382,7 +382,7 @@ HIRELAYER_API_KEY=your-api-key npx @modelcontextprotocol/inspector npx -y hirela
 No. HireLayer provides the AI building blocks of recruiting software: resume parsing, scoring and ranking, talent pool search and skills. Use them on their own through MCP, or plug them into your ATS or HR tech product through the [REST API](https://hirelayer.co/api-docs).
 
 **Which language are the results in?**
-The text that HireLayer writes (criteria, summaries, explanations and ranking reasons) is in the job's language, French or English, unless you ask for the other one with `language`. Evidence quotes the resume in its own language. Skills normalization returns French or English labels.
+The text that HireLayer writes (criteria, summaries, explanations and ranking reasons) is in the job's language: English, French, German, Spanish or Portuguese, and English for a job written in another language. Choose it with `language` (`en`, `fr`, `de`, `es` or `pt`). Evidence quotes the resume in its own language. Skills normalization returns French or English labels.
 
 **Which resume languages are supported?**
 The parser detects the main language of each resume and returns it in `resume.info_resume.language`.

package/dist/client.js

@@ -34,6 +34,8 @@ export class HireLayerError extends Error {
         this.name = 'HireLayerError';
     }
 }
+/** The languages a job's criteria, summaries and explanations are written in. */
+export const JOB_LANGUAGES = ['en', 'fr', 'de', 'es', 'pt'];
 export class HireLayerClient {
     apiKey;
     baseUrl;

package/dist/server.js

@@ -1,6 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { HireLayerError, VERSION } from './client.js';
+import { HireLayerError, JOB_LANGUAGES, VERSION } from './client.js';
 // Clients drop calls that stay silent too long (often after 60 s); parsing takes about
 // 30 s, scans needing OCR and scoring 50 resumes longer, so long calls report progress at this interval.
 const PROGRESS_INTERVAL_MS = 10_000;
@@ -19,7 +19,8 @@ Resume input:
 - score_resumes and search_jobs take resume text directly: when you can already read the resume, pass its text instead of parsing it first. For a resume file, parse it with parse_resume and pass the application_id it returns.
 
 Notes:
-- Criteria, summaries and explanations are written in the job's language (French or English) unless language says otherwise; evidence quotes the resume in its own language.
+- Criteria, summaries and explanations are written in the job's language (English, French, German, Spanish or Portuguese; English for any other) unless language says otherwise; evidence quotes the resume in its own language.
+- A job text holds at least 30 characters, and score_resumes needs at least one resume of 30 characters or more.
 - Job and resume texts are accepted up to 50,000 characters each: truncate longer ones. score_resumes takes up to 50 resumes per call.
 - HireLayer keeps the jobs, resumes and scores in the user's account, as the REST API does, unless the workspace runs without storage. A pair already scored is not evaluated again and costs nothing.
 - Pass do_not_store_data: true to parse_resume when the user does not want HireLayer to keep the resume (Enterprise plan). Such a resume gets no application_id: score it by its text.
@@ -45,10 +46,15 @@ const workspaceArg = z
     .optional()
     .describe(`The client company this call belongs to, when the user recruits for several companies: its HireLayer workspace id (${CLIENT_ID_RULE}), e.g. acme-corp. Jobs, resumes and scores stay apart from other clients'. A new id creates a new workspace, so reuse the exact id. Omit it for the user's default workspace.`);
 const languageArg = z
-    .enum(['fr', 'en'])
+    .enum(JOB_LANGUAGES)
     .optional()
-    .describe("Language of the criteria, summaries and explanations: fr or en. Defaults to the job's language.");
-const jobText = z.string().min(1).max(50000);
+    .describe("Language of the criteria, summaries and explanations: en, fr, de, es or pt. Defaults to the language of the job's text (English when it is another).");
+// The API refuses a job text under 30 characters.
+const jobText = z
+    .string()
+    .trim()
+    .min(30, 'A job text holds at least 30 characters: send the full job description.')
+    .max(50000);
 const resumeText = z.string().min(1).max(50000);
 // The format extract_job_criteria returns; criterion_id and source, sent back, are ignored by the API.
 const criterion = z.object({
@@ -122,9 +128,9 @@ export function createServer(client) {
     }, ({ file_path, file_url, resume_text, application_id, do_not_store_data, workspace }, extra) => run(extra, (signal) => client.parseResume({ filePath: file_path, fileUrl: file_url, text: resume_text }, { applicationId: application_id, doNotStoreData: do_not_store_data, workspace, signal })));
     server.registerTool('extract_job_criteria', {
         title: 'Job Criteria Extractor',
-        description: 'Turn a job description (any language) into its typed criteria (usually 4 to 10), each with a criterion_id, a label, a type, a requirement (required, preferred or bonus), a weight from 0 to 3 and an optional threshold. The job is stored under job_id, so score_resumes can reuse it. Free, except a new text sent under the job_id of a job already scored: its scores are evaluated again, 1 credit each.',
+        description: "Turn a job description (any language, at least 30 characters) into the typed criteria it states (usually 4 to 10, fewer for a short posting), in the posting's order, each with a criterion_id, a label, a type, a requirement (required, preferred or bonus), a weight from 0 to 3 and an optional threshold. They are written in the job's language (English, French, German, Spanish or Portuguese; English for any other) unless language says otherwise. The job is stored under job_id, so score_resumes can reuse it. Free, except a new text sent under the job_id of a job already scored: its scores are evaluated again, 1 credit each.",
         inputSchema: {
-            job_text: jobText.describe('Full job description, as published.'),
+            job_text: jobText.describe('Full job description, as published: at least 30 characters.'),
             title: z.string().max(300).optional().describe('Job title.'),
             location: z.string().max(300).optional().describe('Where the job is based.'),
             language: languageArg,
@@ -135,9 +141,9 @@ export function createServer(client) {
     }, ({ job_text, title, location, language, job_id, workspace }, extra) => run(extra, (signal) => client.extractJobCriteria({ text: job_text, title, location, language, job_id }, { workspace, signal })));
     server.registerTool('score_resumes', {
         title: 'Resume Scorer',
-        description: 'Evaluate 1 to 50 resumes against a job, criterion by criterion, and return them best first: for each, a score between 0 and 1, a verdict (highly_relevant, relevant, marginally_relevant or not_relevant), a summary, the required criteria missing or to verify, and the evidence for each criterion. Give the job as job_text (its criteria are extracted on the way, or pass your own criteria) or as the job_id of a stored job. Give each resume as text or as the application_id of a stored resume. With precise_ranking, the 10 best are re-ranked against each other, each with a ranking_reason. The result is decision support for a human recruiter, not an automated hiring decision. Costs 1 HireLayer credit per resume evaluated, and 1 more with precise_ranking; a pair already scored costs 0.',
+        description: "Evaluate 1 to 50 resumes against a job, criterion by criterion, and return them best first: for each, a score between 0 and 1, a verdict (highly_relevant, relevant, marginally_relevant or not_relevant), a summary, the required criteria missing or to verify, and the evidence for each criterion. Give the job as job_text (its criteria are extracted on the way, or pass your own criteria) or as the job_id of a stored job. Give each resume as text or as the application_id of a stored resume; at least one resume of the call holds 30 characters or more. Summaries and explanations are written in the job's language. With precise_ranking, the 10 best are re-ranked against each other, each with a ranking_reason. The result is decision support for a human recruiter, not an automated hiring decision. Costs 1 HireLayer credit per resume evaluated, and 1 more with precise_ranking; a pair already scored costs 0.",
         inputSchema: {
-            job_text: jobText.optional().describe('The job description. Give job_text or job_id.'),
+            job_text: jobText.optional().describe('The job description, at least 30 characters. Give job_text or job_id.'),
             job_id: JOB_ID_RULE.optional().describe('Alone: a job already stored, such as the job_id extract_job_criteria returned. With job_text: store the job under your own id; a new text or new criteria for a job already scored evaluate its stored scores again, 1 credit each.'),
             criteria: z
                 .array(criterion)
@@ -145,7 +151,7 @@ export function createServer(client) {
                 .max(20)
                 .optional()
                 .describe("The job's own criteria, in the format extract_job_criteria returns; they replace the extraction. Only with job_text."),
-            language: languageArg.describe("Language of the criteria, summaries and explanations: fr or en. Only with job_text; defaults to the job's language."),
+            language: languageArg.describe("Language of the criteria, summaries and explanations: en, fr, de, es or pt. Only with job_text; defaults to the language of the job's text (English when it is another)."),
             resumes: z
                 .array(z.object({
                 text: resumeText.optional().describe('The resume as plain text.'),
@@ -177,10 +183,10 @@ export function createServer(client) {
     }));
     server.registerTool('search_resumes', {
         title: 'Talent Pool Search',
-        description: "Find the resumes of the user's resume database closest to a job, by proximity only: application_ids with a similarity between 0 and 1, best first, and whether each is already scored for the job. No evaluation: pass the ones worth it to score_resumes. Give the job as the job_id of a stored job or as job_text (the job is then stored). Costs 1 HireLayer credit per search.",
+        description: "Find the resumes of the user's resume database closest to a job, by proximity only: application_ids with a similarity between 0 and 1, best first, and whether each is already scored for the job. No evaluation: pass the ones worth it to score_resumes. Give the job as the job_id of a stored job or as job_text (at least 30 characters; the job is then stored). Costs 1 HireLayer credit per search.",
         inputSchema: {
             job_id: JOB_ID_RULE.optional().describe('A stored job. Give job_id or job_text.'),
-            job_text: jobText.optional().describe('A job description not stored yet.'),
+            job_text: jobText.optional().describe('A job description not stored yet, at least 30 characters.'),
             limit: z.number().int().min(1).max(500).optional().describe('How many resumes to return, 50 by default.'),
             city: z
                 .string()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hirelayer-mcp",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "mcpName": "co.hirelayer/hirelayer",
   "description": "Official HireLayer MCP server: resume and CV parsing, job criteria extraction, resume scoring and ranking, talent pool search, job recommendations and skills normalization for AI agents in Claude, Cursor, VS Code and other MCP clients.",
   "type": "module",