io.github.work0r-ai/workorai is an MCP server published by io.github.work0r-ai, hosted at workorai.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 29 tools, including request_access, candidate.search_jobs, candidate.get_job, candidate.get_applications, candidate.set_saved_job.
WorkorAI talent marketplace MCP: candidate job search and employer hiring with explainable matching
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Use when someone wants to find work/jobs (candidate) or hire/find candidates (employer) but the authenticated role tools are not usable yet. Explains role-specific onboarding (candidate profile interview, employer key generation), MCP key location, and next steps for both surfaces.
| Parameter | Type | Description |
|---|---|---|
| role | string | one of ["CANDIDATE","EMPLOYER"] |
{
"name": "request_access",
"title": "Request access",
"description": "Use when someone wants to find work/jobs (candidate) or hire/find candidates (employer) but the authenticated role tools are not usable yet. Explains role-specific onboarding (candidate profile interview, employer key generation), MCP key location, and next steps for both surfaces.",
"inputSchema": {
"type": "object",
"properties": {
"role": {
"enum": [
"CANDIDATE",
"EMPLOYER"
],
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"guides": {
"type": "array"
},
"message": {
"type": "string"
},
"capabilityManifest": {
"type": "object",
"properties": {
"auth": {
"type": "string"
},
"endpoint": {
"type": "string"
},
"keyPrefix": {
"type": "string"
},
"transport": {
"type": "string"
},
"sessionRules": {
"type": "array"
},
"referenceDocs": {
"type": "array"
},
"runtimePolicy": {
"type": "string"
},
"activeCapabilities": {
"type": "array"
},
"visibleWithoutAuth": {
"type": "array"
},
"plannedCapabilities": {
"type": "array"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
}Semantically rank published jobs against the authenticated candidate profile (embedding-based fit). Optional tier (best|good|weak) narrows to a match-quality band — start with tier:'best' for the strongest fits and cascade only if needed; omit for the full ranked list (read tierCounts for the band sizes). Each scored row carries matchExplanation (the white-box 'why': fit score, the candidate's skills that match the job's required set, and a rationale). A free-text `q`, or a candidate who has not completed an interview yet, instead browses published jobs by recency — those rows carry NO fit score (`matchScore` is `null`, no bands); treat them as a browse list, not a ranking.
| Parameter | Type | Description |
|---|---|---|
| q | string | |
| tier | string | Match-quality band. Omit for the full ranked list. START with tier:"best" (strongest fits), cascade to "good"/"weak" only if you need more; read tierCounts to decide. Ignored on a free-text q / no-interview browse (no bands). |
| limit | number | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
| offset | number | |
| jobType | string | one of ["FULL_TIME","PART_TIME","CONTRACT","FREELANCE"] |
| seniority | string | one of ["INTERN","JUNIOR","MIDDLE","SENIOR","LEAD","PRINCIPAL"] |
| workModel | string | one of ["REMOTE","HYBRID","ON_SITE"] |
Fetch a single published job by id.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "candidate.get_job",
"title": "Get job",
"description": "Fetch a single published job by id.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object"
}
},
"additionalProperties": false
}
}List the candidate's own job applications (newest first) with status, dates, the originating interview score, and a job summary. Returns only the caller's applications — no jobId input, so it is not an enumeration surface.
| Parameter | Type | Description |
|---|---|---|
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "candidate.get_applications",
"title": "Get applications",
"description": "List the candidate's own job applications (newest first) with status, dates, the originating interview score, and a job summary. Returns only the caller's applications — no jobId input, so it is not an enumeration surface.",
"inputSchema": {
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"applications": {
"type": "array",
"items": {
"type": "object",
"properties": {
"job": {
"type": "object"
},
"jobId": {
"type": "string"
},
"status": {
"type": "string"
},
"appliedAt": {
"type": "string",
"format": "date-time"
},
"withdrawnAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"interviewScore": {
"type": [
"number",
"null"
]
},
"interviewEvaluationStatus": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}Set whether a PUBLISHED job is in the candidate's saved list (idempotent desired-state, NOT a toggle — pass saved:true to bookmark, saved:false to remove). Returns NOT_FOUND for a missing or non-public job.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| saved * | boolean | Desired saved state. true bookmarks the job, false removes the bookmark. Idempotent — a retry never flips the state. |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "candidate.set_saved_job",
"title": "Save / unsave job",
"description": "Set whether a PUBLISHED job is in the candidate's saved list (idempotent desired-state, NOT a toggle — pass saved:true to bookmark, saved:false to remove). Returns NOT_FOUND for a missing or non-public job.",
"inputSchema": {
"type": "object",
"required": [
"jobId",
"saved"
],
"properties": {
"jobId": {
"type": "string"
},
"saved": {
"type": "boolean",
"description": "Desired saved state. true bookmarks the job, false removes the bookmark. Idempotent — a retry never flips the state."
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"saved": {
"type": "boolean"
}
},
"additionalProperties": false
}
}List the candidate's saved (bookmarked) jobs, newest first. Only currently PUBLISHED jobs are returned — a job saved earlier then closed/archived is omitted.
| Parameter | Type | Description |
|---|---|---|
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "candidate.get_saved_jobs",
"title": "Get saved jobs",
"description": "List the candidate's saved (bookmarked) jobs, newest first. Only currently PUBLISHED jobs are returned — a job saved earlier then closed/archived is omitted.",
"inputSchema": {
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"savedJobs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"jobId": {
"type": "string"
},
"title": {
"type": "string"
},
"salary": {
"type": [
"string",
"null"
]
},
"jobType": {
"type": "string"
},
"savedAt": {
"type": "string",
"format": "date-time"
},
"location": {
"type": [
"string",
"null"
]
},
"seniority": {
"type": "string"
},
"workModel": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}Accept an employer's invitation to a job (INVITED -> APPLIED). Idempotent — accepting an already-accepted invite succeeds. Returns NOT_INVITED when there is no open invitation (e.g. already withdrawn/declined), and NOT_FOUND when the job/invite is not found or the job is no longer public.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "candidate.accept_invitation",
"title": "Accept invitation",
"description": "Accept an employer's invitation to a job (INVITED -> APPLIED). Idempotent — accepting an already-accepted invite succeeds. Returns NOT_INVITED when there is no open invitation (e.g. already withdrawn/declined), and NOT_FOUND when the job/invite is not found or the job is no longer public.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
}
}Decline an employer's invitation to a job (INVITED -> DECLINED). TERMINAL — a declined invite blocks any re-invite from the employer, so only decline when the candidate is sure. Idempotent (declining again succeeds). Returns NOT_INVITED when there is no open invitation, NOT_FOUND when the job/invite is not found.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "candidate.decline_invitation",
"title": "Decline invitation",
"description": "Decline an employer's invitation to a job (INVITED -> DECLINED). TERMINAL — a declined invite blocks any re-invite from the employer, so only decline when the candidate is sure. Idempotent (declining again succeeds). Returns NOT_INVITED when there is no open invitation, NOT_FOUND when the job/invite is not found.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
}
}Withdraw the candidate's active application to a job (APPLIED -> WITHDRAWN). Idempotent (withdrawing again succeeds). Returns NOT_APPLIED when there is no active application (e.g. only an open invitation, or already declined), and NOT_FOUND when no application exists for the job.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "candidate.withdraw_application",
"title": "Withdraw application",
"description": "Withdraw the candidate's active application to a job (APPLIED -> WITHDRAWN). Idempotent (withdrawing again succeeds). Returns NOT_APPLIED when there is no active application (e.g. only an open invitation, or already declined), and NOT_FOUND when no application exists for the job.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
}
}Apply the candidate to a PUBLISHED job, reusing their evaluated profile interview as evidence. Idempotent (re-applying succeeds; `reused` is true when an application row already existed). Requires a completed + evaluated interview — otherwise returns GATE_LOCKED / GATE_EVALUATING / GATE_FAILED. A missing or non-public job returns NOT_FOUND.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "candidate.apply_to_job",
"title": "Apply to job",
"description": "Apply the candidate to a PUBLISHED job, reusing their evaluated profile interview as evidence. Idempotent (re-applying succeeds; `reused` is true when an application row already existed). Requires a completed + evaluated interview — otherwise returns GATE_LOCKED / GATE_EVALUATING / GATE_FAILED. A missing or non-public job returns NOT_FOUND.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"reused": {
"type": "boolean"
},
"status": {
"type": "string"
},
"applicationId": {
"type": "string"
}
},
"additionalProperties": false
}
}List jobs owned by the current employer account.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
| offset | number | |
| status | any |
{
"name": "employer.list_jobs",
"title": "List jobs",
"description": "List jobs owned by the current employer account.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"offset": {
"type": "number"
},
"status": {
"oneOf": [
{
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
],
"type": "string"
},
{
"type": "array",
"items": {
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
],
"type": "string"
}
}
]
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"salary": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
],
"type": "string"
},
"jobType": {
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
],
"type": "string"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"location": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
],
"type": "string"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"viewCount": {
"type": "number"
},
"workModel": {
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
],
"type": "string"
},
"dataSource": {
"enum": [
"USER_EDITED",
"AI_PARSED"
],
"type": "string"
},
"employerId": {
"type": "string"
},
"hiredCount": {
"type": "number"
},
"description": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"applicationCount": {
"type": "number"
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"page": {
"type": "object",
"properties": {
"limit": {
"type": "number"
},
"total": {
"type": "number"
},
"offset": {
"type": "number"
},
"hasMore": {
"type": "boolean"
}
}
},
"filters": {
"type": "object",
"properties": {
"limit": {
"type": "number"
},
"offset": {
"type": "number"
},
"status": {
"type": "array",
"items": {
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
],
"type": "string"
}
}
}
}
},
"additionalProperties": false
}
}Fetch a single employer job record by id. Returns NOT_FOUND for missing jobs and for jobs owned by another employer (no existence leak).
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "employer.get_job",
"title": "Get job",
"description": "Fetch a single employer job record by id. Returns NOT_FOUND for missing jobs and for jobs owned by another employer (no existence leak).",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"salary": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
],
"type": "string"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
},
"jobType": {
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
],
"type": "string"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"location": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
],
"type": "string"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"viewCount": {
"type": "number"
},
"workModel": {
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
],
"type": "string"
},
"dataSource": {
"enum": [
"USER_EDITED",
"AI_PARSED"
],
"type": "string"
},
"employerId": {
"type": "string"
},
"hiredCount": {
"type": "number"
},
"description": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"applicationCount": {
"type": "number"
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
}
}Parse raw text via Gemini AI and create a DRAFT job under the current employer. Synchronous: latency 5-30s. The agent can then call employer.update_job to refine fields and employer.publish_job to make it live.
| Parameter | Type | Description |
|---|---|---|
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
| rawText * | string | Free-form job description (up to 10000 characters). Parsed by Gemini AI; the call typically takes 5-30 seconds. On a client-side timeout, recover by calling employer.list_jobs with status=DRAFT and pick the most recent row. |
{
"name": "employer.create_job",
"title": "Create job",
"description": "Parse raw text via Gemini AI and create a DRAFT job under the current employer. Synchronous: latency 5-30s. The agent can then call employer.update_job to refine fields and employer.publish_job to make it live.",
"inputSchema": {
"type": "object",
"required": [
"rawText"
],
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"rawText": {
"type": "string",
"description": "Free-form job description (up to 10000 characters). Parsed by Gemini AI; the call typically takes 5-30 seconds. On a client-side timeout, recover by calling employer.list_jobs with status=DRAFT and pick the most recent row."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"salary": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
],
"type": "string"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
},
"jobType": {
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
],
"type": "string"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"location": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
],
"type": "string"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"viewCount": {
"type": "number"
},
"workModel": {
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
],
"type": "string"
},
"dataSource": {
"enum": [
"USER_EDITED",
"AI_PARSED"
],
"type": "string"
},
"employerId": {
"type": "string"
},
"hiredCount": {
"type": "number"
},
"description": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"applicationCount": {
"type": "number"
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
}
}Update the fields of an existing employer job. Accepts a partial whitelist; rawInput and dataSource are not editable (the wrapper auto-flips dataSource to USER_EDITED on every agent update). Non-owner reads return NOT_FOUND.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
| fields * | object |
{
"name": "employer.update_job",
"title": "Update job",
"description": "Update the fields of an existing employer job. Accepts a partial whitelist; rawInput and dataSource are not editable (the wrapper auto-flips dataSource to USER_EDITED on every agent update). Non-owner reads return NOT_FOUND.",
"inputSchema": {
"type": "object",
"required": [
"jobId",
"fields"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"fields": {
"type": "object",
"properties": {
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"salary": {
"type": "string"
},
"jobType": {
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
],
"type": "string"
},
"location": {
"type": "string"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
],
"type": "string"
},
"workModel": {
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
],
"type": "string"
},
"description": {
"type": "string"
},
"referralBonus": {
"type": "number"
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"salary": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
],
"type": "string"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
},
"jobType": {
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
],
"type": "string"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"location": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
],
"type": "string"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"viewCount": {
"type": "number"
},
"workModel": {
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
],
"type": "string"
},
"dataSource": {
"enum": [
"USER_EDITED",
"AI_PARSED"
],
"type": "string"
},
"employerId": {
"type": "string"
},
"hiredCount": {
"type": "number"
},
"description": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"applicationCount": {
"type": "number"
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
}
}Transition a DRAFT job to PUBLISHED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in DRAFT.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "employer.publish_job",
"title": "Publish job",
"description": "Transition a DRAFT job to PUBLISHED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in DRAFT.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"salary": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
],
"type": "string"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
},
"jobType": {
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
],
"type": "string"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"location": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
],
"type": "string"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"viewCount": {
"type": "number"
},
"workModel": {
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
],
"type": "string"
},
"dataSource": {
"enum": [
"USER_EDITED",
"AI_PARSED"
],
"type": "string"
},
"employerId": {
"type": "string"
},
"hiredCount": {
"type": "number"
},
"description": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"applicationCount": {
"type": "number"
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
}
}Transition a PUBLISHED job to CLOSED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in PUBLISHED.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "employer.close_job",
"title": "Close job",
"description": "Transition a PUBLISHED job to CLOSED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in PUBLISHED.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"salary": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
],
"type": "string"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
},
"jobType": {
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
],
"type": "string"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"location": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
],
"type": "string"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"viewCount": {
"type": "number"
},
"workModel": {
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
],
"type": "string"
},
"dataSource": {
"enum": [
"USER_EDITED",
"AI_PARSED"
],
"type": "string"
},
"employerId": {
"type": "string"
},
"hiredCount": {
"type": "number"
},
"description": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"applicationCount": {
"type": "number"
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
}
}Transition a CLOSED job to ARCHIVED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in CLOSED.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "employer.archive_job",
"title": "Archive job",
"description": "Transition a CLOSED job to ARCHIVED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in CLOSED.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"salary": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
],
"type": "string"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
},
"jobType": {
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
],
"type": "string"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"location": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
],
"type": "string"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"viewCount": {
"type": "number"
},
"workModel": {
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
],
"type": "string"
},
"dataSource": {
"enum": [
"USER_EDITED",
"AI_PARSED"
],
"type": "string"
},
"employerId": {
"type": "string"
},
"hiredCount": {
"type": "number"
},
"description": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"applicationCount": {
"type": "number"
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
}
}Permanently delete a DRAFT job that was never published. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in DRAFT.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously. |
{
"name": "employer.delete_job",
"title": "Delete job",
"description": "Permanently delete a DRAFT job that was never published. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in DRAFT.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobId": {
"type": "string"
}
},
"additionalProperties": false
}
}Semantically rank discoverable (interviewed) candidates against one of the employer's own jobs, with a per-candidate fit score AND a white-box explanation. WORKFLOW for finding the best hire: 1) call with tier:'best' to get the strongest candidates (cover the required skills + proven in interview), cascade to tier:'good' then tier:'weak' only if you need more (read tierCounts to decide; paginate within a band via page.hasMore, not page.total); 2) each row carries matchExplanation — the white-box 'why' (the fit score, the skills the candidate PROVED in their interview, what they're missing, and a plain-English rationale) — use it to explain your shortlist on OUR data, not a black box; 3) for the few you shortlist, call employer.get_candidate_evidence(jobId, userId) for the interview facts + Q&A to write a deeper comparative review. Omit tier for the full ranked pool (back-compat). Returns NOT_FOUND when the job is missing / owned by another employer (no existence leak), or NOT_INDEXED / NO_CATEGORIES when the job is not indexed for semantic search yet (re-save / republish, then retry).
| Parameter | Type | Description |
|---|---|---|
| page | number | |
| sort | string | one of ["bestMatch","newest"] |
| tier | string | Match-quality band (required-skill coverage + fit). Omit to get the full ranked pool. To shortlist, START with tier:"best" — the strongest candidates (cover the required skills, proven in interview); only cascade to "good" then "weak" if you need more. Read tierCounts to decide; paginate within a ba… |
| jobId * | string | |
| apiKey | string | |
| pageSize | number |
Free-form semantic search across discoverable (interviewed) candidates with no job context. The query is embedded and candidates are ranked by semantic similarity — a preliminary search with no per-vacancy fit score (there is no vacancy to fit). For a scored ranking, use employer.search_candidates_for_job with a job id.
| Parameter | Type | Description |
|---|---|---|
| page | number | |
| query * | string | |
| apiKey | string | |
| pageSize | number |
{
"name": "employer.search_candidates_by_query",
"title": "Search candidates by query",
"description": "Free-form semantic search across discoverable (interviewed) candidates with no job context. The query is embedded and candidates are ranked by semantic similarity — a preliminary search with no per-vacancy fit score (there is no vacancy to fit). For a scored ranking, use employer.search_candidates_for_job with a job id.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"page": {
"type": "number"
},
"query": {
"type": "string",
"maxLength": 512
},
"apiKey": {
"type": "string"
},
"pageSize": {
"type": "number"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"page": {
"type": "object",
"properties": {
"page": {
"type": "number"
},
"total": {
"type": "number"
},
"pageSize": {
"type": "number"
}
}
},
"jobId": {
"type": [
"string",
"null"
]
},
"query": {
"type": "string"
},
"reason": {
"enum": [
"NOT_INDEXED",
"NO_CATEGORIES"
],
"type": "string"
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"skills": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": [
"string",
"null"
]
},
"headline": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"avatarUrl": {
"type": [
"string",
"null"
]
},
"invitedAt": {
"type": "string",
"format": "date-time"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL",
null
],
"type": [
"string",
"null"
]
},
"matchScore": {
"type": "number"
},
"displayName": {
"type": "string"
},
"applicationStatus": {
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
],
"type": "string"
},
"matchedMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"missingMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"tierCounts": {
"type": "object",
"properties": {
"matched": {
"type": "number"
},
"unmatched": {
"type": "number"
}
}
}
},
"additionalProperties": false
}
}Fetch a discoverable candidate by user id. Returns search-entry shape plus a light interview slice (overallScore + summary + completedAt + evaluatedAt) and `existingApplications`: every JobApplication this candidate has on any of the employer's jobs (all 4 statuses, all 4 job statuses) so the agent can decide whether re-inviting will succeed. Heavy artefacts (transcript, facts, resume, github, linkedin) live behind employer.get_applicant_detail and require an application.
| Parameter | Type | Description |
|---|---|---|
| apiKey | string | |
| userId * | string |
{
"name": "employer.get_candidate",
"title": "Get candidate",
"description": "Fetch a discoverable candidate by user id. Returns search-entry shape plus a light interview slice (overallScore + summary + completedAt + evaluatedAt) and `existingApplications`: every JobApplication this candidate has on any of the employer's jobs (all 4 statuses, all 4 job statuses) so the agent can decide whether re-inviting will succeed. Heavy artefacts (transcript, facts, resume, github, linkedin) live behind employer.get_applicant_detail and require an application.",
"inputSchema": {
"type": "object",
"required": [
"userId"
],
"properties": {
"apiKey": {
"type": "string"
},
"userId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"candidate": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"skills": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": [
"string",
"null"
]
},
"headline": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"avatarUrl": {
"type": [
"string",
"null"
]
},
"interview": {
"type": [
"object",
"null"
],
"properties": {
"summary": {
"type": [
"string",
"null"
]
},
"completed": {
"type": "boolean",
"description": "false = partial/abandoned interview (early exit); the score is a haircut-discounted partial signal"
},
"completedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"evaluatedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"overallScore": {
"type": [
"number",
"null"
]
}
}
},
"invitedAt": {
"type": "string",
"format": "date-time"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL",
null
],
"type": [
"string",
"null"
]
},
"matchScore": {
"type": "number"
},
"displayName": {
"type": "string"
},
"applicationStatus": {
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
],
"type": "string"
},
"existingApplications": {
"type": "array",
"items": {
"type": "object",
"properties": {
"jobId": {
"type": "string"
},
"status": {
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
],
"type": "string"
},
"jobTitle": {
"type": "string"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"invitedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"jobStatus": {
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
],
"type": "string"
},
"declinedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"withdrawnAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"applicationId": {
"type": "string"
}
}
},
"description": "Every JobApplication this candidate has on any of the employer's jobs (all 4 statuses, all 4 job statuses). Lets the agent decide whether re-inviting will succeed: WITHDRAWN allows re-invite (the service UPDATEs the row back to INVITED), DECLINED is terminal, INVITED is already pending acceptance, APPLIED means the candidate is already in the funnel."
},
"matchedMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"missingMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
}
}Fetch the interview EVIDENCE (facts proven in the interview + their Q&A, the interview summary, the résumé summary, and GitHub/LinkedIn signals) for ONE candidate AGAINST one of your published jobs — the white-box basis to explain WHY a candidate ranks where they do. Use it AFTER search_candidates_for_job: shortlist with the scorecard, then read the evidence here for the few you care about and write your own comparative review. Returns NOT_FOUND if the job is missing / not yours / not published, or the candidate is not in that job's searchable pool.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | One of YOUR published vacancies — the evidence is scoped to it (must-linked facts use its required skills). |
| apiKey | string | |
| userId * | string | A candidate from search_candidates_for_job for THIS jobId. The interview evidence to explain your ranking. |
{
"name": "employer.get_candidate_evidence",
"title": "Get candidate interview evidence",
"description": "Fetch the interview EVIDENCE (facts proven in the interview + their Q&A, the interview summary, the résumé summary, and GitHub/LinkedIn signals) for ONE candidate AGAINST one of your published jobs — the white-box basis to explain WHY a candidate ranks where they do. Use it AFTER search_candidates_for_job: shortlist with the scorecard, then read the evidence here for the few you care about and write your own comparative review. Returns NOT_FOUND if the job is missing / not yours / not published, or the candidate is not in that job's searchable pool.",
"inputSchema": {
"type": "object",
"required": [
"jobId",
"userId"
],
"properties": {
"jobId": {
"type": "string",
"description": "One of YOUR published vacancies — the evidence is scoped to it (must-linked facts use its required skills)."
},
"apiKey": {
"type": "string"
},
"userId": {
"type": "string",
"description": "A candidate from search_candidates_for_job for THIS jobId. The interview evidence to explain your ranking."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"evidence": {
"type": "object",
"properties": {
"facts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"qas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"answer": {
"type": "string"
},
"question": {
"type": "string"
}
}
}
},
"claim": {
"type": "string"
},
"factScore": {
"type": [
"number",
"null"
]
},
"mustLinked": {
"type": "boolean"
}
}
}
},
"github": {
"type": [
"object",
"null"
],
"properties": {
"trustRank": {
"type": "number"
},
"web3Repos": {
"type": "number"
},
"mergedPrestigeLanguages": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"headline": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"object",
"null"
],
"properties": {
"recognizedCerts": {
"type": "number"
},
"historyCoherence": {
"type": "number"
}
}
},
"interview": {
"type": [
"object",
"null"
],
"properties": {
"summary": {
"type": [
"string",
"null"
]
},
"completed": {
"type": "boolean",
"description": "false = partial/abandoned interview (early exit); the score is a haircut-discounted partial signal"
},
"interviewId": {
"type": "number"
},
"overallScore": {
"type": [
"number",
"null"
]
}
}
},
"truncation": {
"type": "array",
"items": {
"type": "string"
}
},
"candidateId": {
"type": "string"
},
"resumeSummary": {
"type": [
"string",
"null"
]
},
"experienceYears": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
}Invite a discoverable candidate to one of the employer's PUBLISHED jobs. Creates a JobApplication with status=INVITED. If a prior WITHDRAWN row exists for this (candidate, job) pair, the row is UPDATEd back to INVITED (re-invite is allowed after the candidate withdrew on their own). INVITED, APPLIED, and DECLINED rows still block with INVITE_BLOCKED: INVITE_NOT_ALLOWED. Inspect `existingApplications` on employer.get_candidate before calling to know which case applies. Returns INVITE_BLOCKED with one of several sub-reasons (JOB_NOT_FOUND, JOB_NOT_PUBLISHED, CANDIDATE_NOT_FOUND, NOT_DISCOVERABLE, INVITE_NOT_ALLOWED) when the invite cannot be created. A missing vacancy and a vacancy owned by another employer both return JOB_NOT_FOUND (you cannot tell them apart — anti-enumeration).
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string | |
| candidateUserId * | string |
{
"name": "employer.invite_candidate",
"title": "Invite candidate",
"description": "Invite a discoverable candidate to one of the employer's PUBLISHED jobs. Creates a JobApplication with status=INVITED. If a prior WITHDRAWN row exists for this (candidate, job) pair, the row is UPDATEd back to INVITED (re-invite is allowed after the candidate withdrew on their own). INVITED, APPLIED, and DECLINED rows still block with INVITE_BLOCKED: INVITE_NOT_ALLOWED. Inspect `existingApplications` on employer.get_candidate before calling to know which case applies. Returns INVITE_BLOCKED with one of several sub-reasons (JOB_NOT_FOUND, JOB_NOT_PUBLISHED, CANDIDATE_NOT_FOUND, NOT_DISCOVERABLE, INVITE_NOT_ALLOWED) when the invite cannot be created. A missing vacancy and a vacancy owned by another employer both return JOB_NOT_FOUND (you cannot tell them apart — anti-enumeration).",
"inputSchema": {
"type": "object",
"required": [
"jobId",
"candidateUserId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string"
},
"candidateUserId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string"
},
"applicationId": {
"type": "string"
}
},
"additionalProperties": false
}
}List the live (APPLIED) applicants on one of the employer's jobs. The candidate showcase + interview overallScore/summary are always returned; contact fields are only included when the application is SHORTLISTED or HIRED.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| apiKey | string |
{
"name": "employer.list_applicants",
"title": "List applicants",
"description": "List the live (APPLIED) applicants on one of the employer's jobs. The candidate showcase + interview overallScore/summary are always returned; contact fields are only included when the application is SHORTLISTED or HIRED.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobId": {
"type": "string"
},
"applicants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"enum": [
"APPLIED",
"INVITED"
],
"type": "string",
"description": "APPLIED = candidate applied directly. INVITED = candidate accepted an invitation the employer had sent earlier (i.e. `invitedById` was set on the row)."
},
"status": {
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
],
"type": "string"
},
"contact": {
"type": [
"object",
"null"
],
"properties": {
"email": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"githubUrl": {
"type": [
"string",
"null"
]
},
"websiteUrl": {
"type": [
"string",
"null"
]
},
"linkedinUrl": {
"type": [
"string",
"null"
]
}
},
"description": "Non-null only when reviewStatus is SHORTLISTED or HIRED (contact gating)."
},
"appliedAt": {
"type": "string",
"format": "date-time"
},
"candidate": {
"type": "object",
"properties": {
"userId": {
"type": "string"
},
"headline": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"avatarUrl": {
"type": [
"string",
"null"
]
},
"displayName": {
"type": "string"
}
}
},
"interview": {
"type": "object",
"properties": {
"summary": {
"type": [
"string",
"null"
]
},
"completed": {
"type": "boolean",
"description": "false = partial/abandoned interview (early exit); the score is a haircut-discounted partial signal"
},
"overallScore": {
"type": [
"number",
"null"
]
}
}
},
"jobFitScore": {
"type": [
"number",
"null"
],
"description": "Live job-fit score (0-100) from the matching combiner — same engine as search_candidates_for_job. null if the job is not indexed yet."
},
"reviewStatus": {
"enum": [
"NEW",
"REVIEWING",
"SHORTLISTED",
"REJECTED",
"HIRED"
],
"type": "string"
},
"applicationId": {
"type": "string"
},
"matchExplanation": {
"type": [
"object",
"null"
],
"properties": {
"score": {
"type": "number",
"description": "The 0-100 job-fit score (same as matchScore)."
},
"rationale": {
"type": "string",
"description": "A ready-to-quote plain-English sentence narrating the score (coverage, proof, any haircut)."
},
"web3Bonus": {
"type": "number"
},
"similarity": {
"type": "number",
"description": "Calibrated semantic similarity to the role (0-100)."
},
"matchedMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate HAS."
},
"matchedNice": {
"type": "array",
"items": {
"type": "string"
},
"description": "Nice-to-have skills the candidate has."
},
"missingMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate is MISSING — the gaps to probe."
},
"missingNice": {
"type": "array",
"items": {
"type": "string"
}
},
"reliability": {
"type": "number",
"description": "How trustworthy the evidence is (0-100): a verified interview + corroborating GitHub/LinkedIn lift it."
},
"mustCoverage": {
"type": "number",
"description": "Fraction (0-1) of the job's REQUIRED skills the candidate covers."
},
"niceCoverage": {
"type": "number"
},
"interviewScore": {
"type": [
"number",
"null"
],
"description": "Their overall interview score (0-100); null = no evaluated interview (use this, not verifiedSkills, to tell if they interviewed)."
},
"verifiedSkills": {
"type": "array",
"items": {
"type": "string"
},
"description": "Job-relevant skills the candidate PROVED in their interview — the strongest signal; lead your explanation with these. Empty if none of their proven skills overlap THIS job (not the same as no interview — check interviewScore)."
},
"verifiedUplift": {
"type": "number",
"description": "Points the verified interview skills added to the score."
},
"reliabilityValue": {
"type": "number",
"description": "The winning spine value (0-100) before corroboration."
},
"matchedNiceGroups": {
"type": "array",
"items": {
"type": "string"
},
"description": "Satisfied N-of-M nice-to-have groups, one label per coverage unit."
},
"missingNiceGroups": {
"type": "array",
"items": {
"type": "string"
},
"description": "Unsatisfied N-of-M nice-to-have groups, one label per coverage unit."
},
"reliabilitySource": {
"type": "string",
"description": "Which proof carried the reliability spine (e.g. 'interview', 'github')."
},
"interviewCompleted": {
"type": "boolean",
"description": "false = the interview score comes from a partial/abandoned (early-exit) interview, already haircut-discounted — flag it when justifying."
}
},
"description": "White-box explanation of WHY this candidate ranks here — quote it to justify your shortlist on our data, not a black box."
}
}
}
}
},
"additionalProperties": false
}
}Update the employer review state on an application (NEW / REVIEWING / SHORTLISTED / REJECTED / HIRED). SHORTLISTED and HIRED unlock the candidate's direct contact in subsequent list_applicants / get_applicant_detail calls. WITHDRAWN applications surface as CONFLICT.
| Parameter | Type | Description |
|---|---|---|
| apiKey | string | |
| reviewStatus * | string | one of ["NEW","REVIEWING","SHORTLISTED","REJECTED","HIRED"] |
| applicationId * | string |
{
"name": "employer.set_review_status",
"title": "Set review status",
"description": "Update the employer review state on an application (NEW / REVIEWING / SHORTLISTED / REJECTED / HIRED). SHORTLISTED and HIRED unlock the candidate's direct contact in subsequent list_applicants / get_applicant_detail calls. WITHDRAWN applications surface as CONFLICT.",
"inputSchema": {
"type": "object",
"required": [
"applicationId",
"reviewStatus"
],
"properties": {
"apiKey": {
"type": "string"
},
"reviewStatus": {
"enum": [
"NEW",
"REVIEWING",
"SHORTLISTED",
"REJECTED",
"HIRED"
],
"type": "string"
},
"applicationId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"reviewStatus": {
"type": "string"
},
"applicationId": {
"type": "string"
}
},
"additionalProperties": false
}
}Full applicant bundle: resume, interview light slice (overallScore + summary + facts), GitHub analysis, LinkedIn analysis. The verbatim transcript is delivered by employer.get_applicant_transcript; the resume's contact fields are blanked unless the application is SHORTLISTED or HIRED.
| Parameter | Type | Description |
|---|---|---|
| apiKey | string | |
| applicationId * | string |
{
"name": "employer.get_applicant_detail",
"title": "Get applicant detail",
"description": "Full applicant bundle: resume, interview light slice (overallScore + summary + facts), GitHub analysis, LinkedIn analysis. The verbatim transcript is delivered by employer.get_applicant_transcript; the resume's contact fields are blanked unless the application is SHORTLISTED or HIRED.",
"inputSchema": {
"type": "object",
"required": [
"applicationId"
],
"properties": {
"apiKey": {
"type": "string"
},
"applicationId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"detail": {
"type": "object",
"properties": {
"jobId": {
"type": "string"
},
"github": {
"type": [
"object",
"null"
],
"description": "GitHub profile analysis blob from the WorkorAI profile-analyzer (~40 fields incl. repo summaries, language distribution, contribution stats). Treat as opaque; consult the workorai-agent-kit catalog or surface fields on demand."
},
"resume": {
"type": "object",
"properties": {
"awards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"issuer": {
"type": "string"
},
"awardDate": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
},
"skills": {
"type": "array",
"items": {
"type": "object",
"properties": {
"skillName": {
"type": "string"
},
"proficiencyLevel": {
"type": "string"
}
}
}
},
"projects": {
"type": "array",
"items": {
"type": "object",
"properties": {
"projectUrl": {
"type": "string"
},
"description": {
"type": "string"
},
"projectName": {
"type": "string"
}
}
}
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"grade": {
"type": "string"
},
"degree": {
"type": "string"
},
"endDate": {
"type": "string"
},
"startDate": {
"type": "string"
},
"schoolName": {
"type": "string"
},
"fieldOfStudy": {
"type": "string"
}
}
}
},
"languages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"proficiency": {
"type": "string"
},
"languageName": {
"type": "string"
}
}
}
},
"personalInfo": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"country": {
"type": "string"
},
"summary": {
"type": "string"
},
"headline": {
"type": "string"
},
"lastName": {
"type": "string"
},
"firstName": {
"type": "string"
},
"githubUrl": {
"type": "string"
},
"websiteUrl": {
"type": "string"
},
"linkedinUrl": {
"type": "string"
}
},
"description": "Contact fields (email, phone, linkedinUrl, githubUrl, websiteUrl) are blank strings when reviewStatus is below SHORTLISTED. firstName/lastName/city/country/headline/summary are always populated when present on the source resume."
},
"publications": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"publisher": {
"type": "string"
},
"description": {
"type": "string"
},
"publicationDate": {
"type": "string"
}
}
}
},
"certifications": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"issueDate": {
"type": "string"
},
"credentialUrl": {
"type": "string"
},
"expirationDate": {
"type": "string"
},
"issuingOrganization": {
"type": "string"
}
}
}
},
"workExperience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"endDate": {
"type": "string"
},
"jobTitle": {
"type": "string"
},
"startDate": {
"type": "string"
},
"companyName": {
"type": "string"
},
"description": {
"type": "string"
},
"isCurrentRole": {
"type": "boolean"
}
}
}
}
},
"description": "Resume data sanitized to remove server-local paths and internal flags. The personalInfo contact fields (email, phone, linkedinUrl, githubUrl, websiteUrl) are blanked when reviewStatus is below SHORTLISTED — same contact-gating rule as the contact field on list_applicants."
},
"status": {
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
],
"type": "string"
},
"jobTitle": {
"type": "string"
},
"linkedin": {
"type": [
"object",
"null"
],
"description": "LinkedIn profile analysis blob from the WorkorAI profile-analyzer (~30 fields incl. headline, experience entries, skill endorsements). Treat as opaque; consult the workorai-agent-kit catalog or surface fields on demand."
},
"appliedAt": {
"type": "string",
"format": "date-time"
},
"interview": {
"type": [
"object",
"null"
],
"properties": {
"facts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"qas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"notes": {
"type": [
"string",
"null"
]
},
"score": {
"type": [
"number",
"null"
]
},
"answer": {
"type": "string"
},
"question": {
"type": "string"
}
}
}
},
"name": {
"type": "string"
},
"notes": {
"type": [
"string",
"null"
]
},
"score": {
"type": [
"number",
"null"
]
},
"summary": {
"type": "string"
},
"expectedAnswer": {
"type": "string"
}
}
}
},
"summary": {
"type": [
"string",
"null"
]
},
"completed": {
"type": "boolean",
"description": "false = partial/abandoned interview (early exit); the score is a haircut-discounted partial signal"
},
"overallScore": {
"type": [
"number",
"null"
]
}
},
"description": "Interview overview minus transcript. Use employer.get_applicant_transcript for the verbatim conversation."
},
"reviewStatus": {
"enum": [
"NEW",
"REVIEWING",
"SHORTLISTED",
"REJECTED",
"HIRED"
],
"type": "string"
},
"applicationId": {
"type": "string"
},
"resumeAvailable": {
"type": "boolean"
}
}
}
},
"additionalProperties": false
}
}Verbatim interview transcript for one applicant. Ownership-only gate (same as the UI Download button — no SHORTLISTED/HIRED requirement). Returns an empty array when the source interview never produced turns.
| Parameter | Type | Description |
|---|---|---|
| apiKey | string | |
| applicationId * | string |
{
"name": "employer.get_applicant_transcript",
"title": "Get applicant transcript",
"description": "Verbatim interview transcript for one applicant. Ownership-only gate (same as the UI Download button — no SHORTLISTED/HIRED requirement). Returns an empty array when the source interview never produced turns.",
"inputSchema": {
"type": "object",
"required": [
"applicationId"
],
"properties": {
"apiKey": {
"type": "string"
},
"applicationId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"transcript": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"enum": [
"assistant",
"user"
],
"type": "string"
},
"text": {
"type": "string"
}
}
}
},
"applicationId": {
"type": "string"
}
},
"additionalProperties": false
}
}List the pending (INVITED) candidates on one of the employer's jobs — candidates who have been invited but have not yet accepted or declined.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | The job to list invitations for |
| apiKey | string | Employer MCP API key |
{
"name": "employer.list_invitations",
"title": "List invitations",
"description": "List the pending (INVITED) candidates on one of the employer's jobs — candidates who have been invited but have not yet accepted or declined.",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string",
"description": "The job to list invitations for"
},
"apiKey": {
"type": "string",
"description": "Employer MCP API key"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobId": {
"type": "string"
},
"invitations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"candidate": {
"type": "object",
"properties": {
"userId": {
"type": "string"
},
"headline": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"avatarUrl": {
"type": [
"string",
"null"
]
},
"displayName": {
"type": "string"
}
}
},
"invitedAt": {
"type": "string",
"format": "date-time"
},
"applicationId": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
}
}Cancel a pending invitation sent to a candidate. The invitation record is deleted; the employer can re-invite the same candidate later.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | The job the invitation belongs to |
| apiKey | string | Employer MCP API key |
| candidateUserId * | string | The candidate whose invitation to cancel |
{
"name": "employer.cancel_invitation",
"title": "Cancel invitation",
"description": "Cancel a pending invitation sent to a candidate. The invitation record is deleted; the employer can re-invite the same candidate later.",
"inputSchema": {
"type": "object",
"required": [
"jobId",
"candidateUserId"
],
"properties": {
"jobId": {
"type": "string",
"description": "The job the invitation belongs to"
},
"apiKey": {
"type": "string",
"description": "Employer MCP API key"
},
"candidateUserId": {
"type": "string",
"description": "The candidate whose invitation to cancel"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobId": {
"type": "string"
},
"candidateUserId": {
"type": "string"
}
},
"additionalProperties": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "candidate.search_jobs",
"title": "Search matched jobs",
"description": "Semantically rank published jobs against the authenticated candidate profile (embedding-based fit). Optional tier (best|good|weak) narrows to a match-quality band — start with tier:'best' for the strongest fits and cascade only if needed; omit for the full ranked list (read tierCounts for the band sizes). Each scored row carries matchExplanation (the white-box 'why': fit score, the candidate's skills that match the job's required set, and a rationale). A free-text `q`, or a candidate who has not completed an interview yet, instead browses published jobs by recency — those rows carry NO fit score (`matchScore` is `null`, no bands); treat them as a browse list, not a ranking.",
"inputSchema": {
"type": "object",
"properties": {
"q": {
"type": "string"
},
"tier": {
"enum": [
"best",
"good",
"weak"
],
"type": "string",
"description": "Match-quality band. Omit for the full ranked list. START with tier:\"best\" (strongest fits), cascade to \"good\"/\"weak\" only if you need more; read tierCounts to decide. Ignored on a free-text q / no-interview browse (no bands)."
},
"limit": {
"type": "number"
},
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"offset": {
"type": "number"
},
"jobType": {
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
],
"type": "string"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
],
"type": "string"
},
"workModel": {
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
],
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"jobId": {
"type": "string"
},
"title": {
"type": "string"
},
"matchScore": {
"type": [
"number",
"null"
]
},
"matchReasons": {
"type": "array",
"items": {
"type": "string"
}
},
"seniorityFit": {
"type": "string"
},
"matchExplanation": {
"type": "object",
"properties": {
"score": {
"type": "number",
"description": "The 0-100 job-fit score (same as matchScore)."
},
"rationale": {
"type": "string",
"description": "A ready-to-quote plain-English sentence narrating the score (coverage, proof, any haircut)."
},
"web3Bonus": {
"type": "number"
},
"similarity": {
"type": "number",
"description": "Calibrated semantic similarity to the role (0-100)."
},
"matchedMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate HAS."
},
"matchedNice": {
"type": "array",
"items": {
"type": "string"
},
"description": "Nice-to-have skills the candidate has."
},
"missingMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate is MISSING — the gaps to probe."
},
"missingNice": {
"type": "array",
"items": {
"type": "string"
}
},
"reliability": {
"type": "number",
"description": "How trustworthy the evidence is (0-100): a verified interview + corroborating GitHub/LinkedIn lift it."
},
"mustCoverage": {
"type": "number",
"description": "Fraction (0-1) of the job's REQUIRED skills the candidate covers."
},
"niceCoverage": {
"type": "number"
},
"interviewScore": {
"type": [
"number",
"null"
],
"description": "Their overall interview score (0-100); null = no evaluated interview (use this, not verifiedSkills, to tell if they interviewed)."
},
"verifiedSkills": {
"type": "array",
"items": {
"type": "string"
},
"description": "Job-relevant skills the candidate PROVED in their interview — the strongest signal; lead your explanation with these. Empty if none of their proven skills overlap THIS job (not the same as no interview — check interviewScore)."
},
"verifiedUplift": {
"type": "number",
"description": "Points the verified interview skills added to the score."
},
"reliabilityValue": {
"type": "number",
"description": "The winning spine value (0-100) before corroboration."
},
"matchedNiceGroups": {
"type": "array",
"items": {
"type": "string"
},
"description": "Satisfied N-of-M nice-to-have groups, one label per coverage unit."
},
"missingNiceGroups": {
"type": "array",
"items": {
"type": "string"
},
"description": "Unsatisfied N-of-M nice-to-have groups, one label per coverage unit."
},
"reliabilitySource": {
"type": "string",
"description": "Which proof carried the reliability spine (e.g. 'interview', 'github')."
},
"interviewCompleted": {
"type": "boolean",
"description": "false = the interview score comes from a partial/abandoned (early-exit) interview, already haircut-discounted — flag it when justifying."
}
},
"description": "White-box explanation of WHY this candidate ranks here — quote it to justify your shortlist on our data, not a black box."
},
"matchedMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"missingMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"matchedNiceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"page": {
"type": "object"
},
"filters": {
"type": "object"
},
"tierCounts": {
"type": "object",
"properties": {
"best": {
"type": "number"
},
"good": {
"type": "number"
},
"weak": {
"type": "number"
},
"matched": {
"type": "number"
},
"unmatched": {
"type": "number"
}
},
"description": "Band sizes for a tier cascade: matched = jobs covering >=1 required skill, unmatched = none; best/good/weak split the matched pool (all bands 0 on a free-text q / no-interview browse). Start at tier:'best', cascade if needed."
}
},
"additionalProperties": false
}
}{
"name": "employer.search_candidates_for_job",
"title": "Search candidates for a job",
"description": "Semantically rank discoverable (interviewed) candidates against one of the employer's own jobs, with a per-candidate fit score AND a white-box explanation. WORKFLOW for finding the best hire: 1) call with tier:'best' to get the strongest candidates (cover the required skills + proven in interview), cascade to tier:'good' then tier:'weak' only if you need more (read tierCounts to decide; paginate within a band via page.hasMore, not page.total); 2) each row carries matchExplanation — the white-box 'why' (the fit score, the skills the candidate PROVED in their interview, what they're missing, and a plain-English rationale) — use it to explain your shortlist on OUR data, not a black box; 3) for the few you shortlist, call employer.get_candidate_evidence(jobId, userId) for the interview facts + Q&A to write a deeper comparative review. Omit tier for the full ranked pool (back-compat). Returns NOT_FOUND when the job is missing / owned by another employer (no existence leak), or NOT_INDEXED / NO_CATEGORIES when the job is not indexed for semantic search yet (re-save / republish, then retry).",
"inputSchema": {
"type": "object",
"required": [
"jobId"
],
"properties": {
"page": {
"type": "number"
},
"sort": {
"enum": [
"bestMatch",
"newest"
],
"type": "string"
},
"tier": {
"enum": [
"best",
"good",
"weak"
],
"type": "string",
"description": "Match-quality band (required-skill coverage + fit). Omit to get the full ranked pool. To shortlist, START with tier:\"best\" — the strongest candidates (cover the required skills, proven in interview); only cascade to \"good\" then \"weak\" if you need more. Read tierCounts to decide; paginate within a band using page.hasMore (NOT page.total, which is the full pool). Each row carries matchExplanation (the white-box \"why\"); then call employer.get_candidate_evidence for the interview evidence to explain your ranking. Ignored on sort:\"newest\" (a recency browse has no bands → tierCounts bands are 0)."
},
"jobId": {
"type": "string"
},
"apiKey": {
"type": "string"
},
"pageSize": {
"type": "number"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"page": {
"type": "object",
"properties": {
"page": {
"type": "number"
},
"total": {
"type": "number"
},
"hasMore": {
"type": "boolean"
},
"pageSize": {
"type": "number"
}
}
},
"jobId": {
"type": [
"string",
"null"
]
},
"reason": {
"enum": [
"NOT_INDEXED",
"NO_CATEGORIES"
],
"type": "string"
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"skills": {
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": [
"string",
"null"
]
},
"headline": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"avatarUrl": {
"type": [
"string",
"null"
]
},
"invitedAt": {
"type": "string",
"format": "date-time"
},
"seniority": {
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL",
null
],
"type": [
"string",
"null"
]
},
"matchScore": {
"type": "number"
},
"displayName": {
"type": "string"
},
"matchExplanation": {
"type": "object",
"properties": {
"score": {
"type": "number",
"description": "The 0-100 job-fit score (same as matchScore)."
},
"rationale": {
"type": "string",
"description": "A ready-to-quote plain-English sentence narrating the score (coverage, proof, any haircut)."
},
"web3Bonus": {
"type": "number"
},
"similarity": {
"type": "number",
"description": "Calibrated semantic similarity to the role (0-100)."
},
"matchedMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate HAS."
},
"matchedNice": {
"type": "array",
"items": {
"type": "string"
},
"description": "Nice-to-have skills the candidate has."
},
"missingMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate is MISSING — the gaps to probe."
},
"missingNice": {
"type": "array",
"items": {
"type": "string"
}
},
"reliability": {
"type": "number",
"description": "How trustworthy the evidence is (0-100): a verified interview + corroborating GitHub/LinkedIn lift it."
},
"mustCoverage": {
"type": "number",
"description": "Fraction (0-1) of the job's REQUIRED skills the candidate covers."
},
"niceCoverage": {
"type": "number"
},
"interviewScore": {
"type": [
"number",
"null"
],
"description": "Their overall interview score (0-100); null = no evaluated interview (use this, not verifiedSkills, to tell if they interviewed)."
},
"verifiedSkills": {
"type": "array",
"items": {
"type": "string"
},
"description": "Job-relevant skills the candidate PROVED in their interview — the strongest signal; lead your explanation with these. Empty if none of their proven skills overlap THIS job (not the same as no interview — check interviewScore)."
},
"verifiedUplift": {
"type": "number",
"description": "Points the verified interview skills added to the score."
},
"reliabilityValue": {
"type": "number",
"description": "The winning spine value (0-100) before corroboration."
},
"matchedNiceGroups": {
"type": "array",
"items": {
"type": "string"
},
"description": "Satisfied N-of-M nice-to-have groups, one label per coverage unit."
},
"missingNiceGroups": {
"type": "array",
"items": {
"type": "string"
},
"description": "Unsatisfied N-of-M nice-to-have groups, one label per coverage unit."
},
"reliabilitySource": {
"type": "string",
"description": "Which proof carried the reliability spine (e.g. 'interview', 'github')."
},
"interviewCompleted": {
"type": "boolean",
"description": "false = the interview score comes from a partial/abandoned (early-exit) interview, already haircut-discounted — flag it when justifying."
}
},
"description": "White-box explanation of WHY this candidate ranks here — quote it to justify your shortlist on our data, not a black box."
},
"applicationStatus": {
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
],
"type": "string"
},
"matchedMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"missingMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"advisory": {
"type": "object",
"properties": {
"code": {
"enum": [
"EMPTY_BEST_REVIEW_MUST_HAVES"
],
"type": "string"
},
"message": {
"type": "string",
"description": "Ready-to-relay plain-English advisory text."
}
},
"description": "OPTIONAL, present only when NO candidate reaches the Best tier for a constrained vacancy (best===0 but candidates exist below). A non-restrictive nudge to relay to the employer: the vacancy's must-have requirements may be strict enough that nobody is an exceptional match — consider moving the less-critical must-haves to nice-to-have to widen the pool. A SUGGESTION, never an instruction to auto-edit the job."
},
"tierCounts": {
"type": "object",
"properties": {
"best": {
"type": "number"
},
"good": {
"type": "number"
},
"weak": {
"type": "number"
},
"matched": {
"type": "number"
},
"unmatched": {
"type": "number"
}
},
"description": "Band sizes to plan a tier cascade: matched = cover >=1 required skill, unmatched = cover none; best/good/weak split the matched pool (best+good+weak === matched on a scored search; all bands 0 on a newest browse). Use to decide whether to fetch tier:'best' then 'good'/'weak'."
}
},
"additionalProperties": false
}
}