workorai
WorkorAI talent marketplace MCP: candidate job search and employer hiring with explainable matching
使うべきか
品質と安全性
B
検出事項（32）
- LOWTool 'candidate.search_jobs' doesn't follow camelCase/snake_casecandidate.search_jobs 内
- LOWTool 'candidate.get_job' doesn't follow camelCase/snake_casecandidate.get_job 内
- LOWTool 'candidate.get_applications' doesn't follow camelCase/snake_casecandidate.get_applications 内
- LOWTool 'candidate.set_saved_job' doesn't follow camelCase/snake_casecandidate.set_saved_job 内
- LOWTool 'candidate.get_saved_jobs' doesn't follow camelCase/snake_casecandidate.get_saved_jobs 内
- LOWTool 'candidate.accept_invitation' doesn't follow camelCase/snake_casecandidate.accept_invitation 内
- LOWTool 'candidate.decline_invitation' doesn't follow camelCase/snake_casecandidate.decline_invitation 内
- LOWTool 'candidate.withdraw_application' doesn't follow camelCase/snake_casecandidate.withdraw_application 内
- LOWTool 'candidate.apply_to_job' doesn't follow camelCase/snake_casecandidate.apply_to_job 内
- LOWTool 'employer.list_jobs' doesn't follow camelCase/snake_caseemployer.list_jobs 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~12,797トークン数（ツール定義）
~4.6 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 10.00%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"workorai": {
"url": "https://workorai.com/mcp"
}
}
}リモートエンドポイント
https://workorai.com/mcpstreamable-httpできること
ツール一覧
ツール（29）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢request_access(role)
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.
入力スキーマ
{
"type": "object",
"properties": {
"role": {
"type": "string",
"enum": [
"CANDIDATE",
"EMPLOYER"
]
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"message": {
"type": "string"
},
"guides": {
"type": "array"
},
"capabilityManifest": {
"type": "object",
"properties": {
"transport": {
"type": "string"
},
"endpoint": {
"type": "string"
},
"auth": {
"type": "string"
},
"keyPrefix": {
"type": "string"
},
"runtimePolicy": {
"type": "string"
},
"visibleWithoutAuth": {
"type": "array"
},
"activeCapabilities": {
"type": "array"
},
"plannedCapabilities": {
"type": "array"
},
"sessionRules": {
"type": "array"
},
"referenceDocs": {
"type": "array"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}🟢candidate.search_jobs(apiKey, q, workModel, seniority, jobType, ...)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"q": {
"type": "string"
},
"workModel": {
"type": "string",
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
]
},
"seniority": {
"type": "string",
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
]
},
"jobType": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
]
},
"limit": {
"type": "number"
},
"offset": {
"type": "number"
},
"tier": {
"type": "string",
"enum": [
"best",
"good",
"weak"
],
"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)."
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"filters": {
"type": "object"
},
"page": {
"type": "object"
},
"tierCounts": {
"type": "object",
"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.",
"properties": {
"matched": {
"type": "number"
},
"unmatched": {
"type": "number"
},
"best": {
"type": "number"
},
"good": {
"type": "number"
},
"weak": {
"type": "number"
}
}
},
"jobs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"jobId": {
"type": "string"
},
"title": {
"type": "string"
},
"matchScore": {
"type": [
"number",
"null"
]
},
"matchedMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"matchedNiceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"missingMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"matchExplanation": {
"type": "object",
"description": "White-box explanation of WHY this candidate ranks here — quote it to justify your shortlist on our data, not a black box.",
"properties": {
"score": {
"type": "number",
"description": "The 0-100 job-fit score (same as matchScore)."
},
"interviewScore": {
"type": [
"number",
"null"
],
"description": "Their overall interview score (0-100); null = no evaluated interview (use this, not verifiedSkills, to tell if they interviewed)."
},
"interviewCompleted": {
"type": "boolean",
"description": "false = the interview score comes from a partial/abandoned (early-exit) interview, already haircut-discounted — flag it when justifying."
},
"reliability": {
"type": "number",
"description": "How trustworthy the evidence is (0-100): a verified interview + corroborating GitHub/LinkedIn lift it."
},
"similarity": {
"type": "number",
"description": "Calibrated semantic similarity to the role (0-100)."
},
"mustCoverage": {
"type": "number",
"description": "Fraction (0-1) of the job's REQUIRED skills the candidate covers."
},
"matchedMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate HAS."
},
"missingMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate is MISSING — the gaps to probe."
},
"niceCoverage": {
"type": "number"
},
"matchedNice": {
"type": "array",
"items": {
"type": "string"
},
"description": "Nice-to-have skills the candidate has."
},
"missingNice": {
"type": "array",
"items": {
"type": "string"
}
},
"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."
},
"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."
},
"web3Bonus": {
"type": "number"
},
"reliabilitySource": {
"type": "string",
"description": "Which proof carried the reliability spine (e.g. 'interview', 'github')."
},
"reliabilityValue": {
"type": "number",
"description": "The winning spine value (0-100) before corroboration."
},
"rationale": {
"type": "string",
"description": "A ready-to-quote plain-English sentence narrating the score (coverage, proof, any haircut)."
}
}
},
"seniorityFit": {
"type": "string"
},
"matchReasons": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
},
"additionalProperties": false
}🟢candidate.get_job(apiKey, jobId)
Fetch a single published job by id.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object"
}
},
"additionalProperties": false
}🟢candidate.get_applications(apiKey)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"applications": {
"type": "array",
"items": {
"type": "object",
"properties": {
"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"
]
},
"job": {
"type": "object"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}🟡candidate.set_saved_job(apiKey, jobId, saved)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"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."
}
},
"required": [
"jobId",
"saved"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"saved": {
"type": "boolean"
}
},
"additionalProperties": false
}🟢candidate.get_saved_jobs(apiKey)
List the candidate's saved (bookmarked) jobs, newest first. Only currently PUBLISHED jobs are returned — a job saved earlier then closed/archived is omitted.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"savedJobs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"jobId": {
"type": "string"
},
"savedAt": {
"type": "string",
"format": "date-time"
},
"title": {
"type": "string"
},
"salary": {
"type": [
"string",
"null"
]
},
"jobType": {
"type": "string"
},
"workModel": {
"type": "string"
},
"seniority": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}⚪candidate.accept_invitation(apiKey, jobId)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
}⚪candidate.decline_invitation(apiKey, jobId)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
}⚪candidate.withdraw_application(apiKey, jobId)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
}⚪candidate.apply_to_job(apiKey, jobId)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"applicationId": {
"type": "string"
},
"reused": {
"type": "boolean"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
}🟢employer.list_jobs(apiKey, status, limit, offset)
List jobs owned by the current employer account.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"status": {
"oneOf": [
{
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
]
},
{
"type": "array",
"items": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
]
}
}
]
},
"limit": {
"type": "number"
},
"offset": {
"type": "number"
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"filters": {
"type": "object",
"properties": {
"status": {
"type": "array",
"items": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
]
}
},
"limit": {
"type": "number"
},
"offset": {
"type": "number"
}
}
},
"page": {
"type": "object",
"properties": {
"total": {
"type": "number"
},
"limit": {
"type": "number"
},
"offset": {
"type": "number"
},
"hasMore": {
"type": "boolean"
}
}
},
"jobs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"employerId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
]
},
"title": {
"type": "string"
},
"seniority": {
"type": "string",
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
]
},
"salary": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"workModel": {
"type": "string",
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
]
},
"jobType": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
]
},
"description": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"dataSource": {
"type": "string",
"enum": [
"USER_EDITED",
"AI_PARSED"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"hiredCount": {
"type": "number"
},
"viewCount": {
"type": "number"
},
"applicationCount": {
"type": "number"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
}
}
}
}
},
"additionalProperties": false
}🟢employer.get_job(apiKey, jobId)
Fetch a single employer job record by id. Returns NOT_FOUND for missing jobs and for jobs owned by another employer (no existence leak).
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"employerId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
]
},
"title": {
"type": "string"
},
"seniority": {
"type": "string",
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
]
},
"salary": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"workModel": {
"type": "string",
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
]
},
"jobType": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
]
},
"description": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"dataSource": {
"type": "string",
"enum": [
"USER_EDITED",
"AI_PARSED"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"hiredCount": {
"type": "number"
},
"viewCount": {
"type": "number"
},
"applicationCount": {
"type": "number"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"additionalProperties": false
}🟡employer.create_job(apiKey, rawText)
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.
入力スキーマ
{
"type": "object",
"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."
}
},
"required": [
"rawText"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"employerId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
]
},
"title": {
"type": "string"
},
"seniority": {
"type": "string",
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
]
},
"salary": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"workModel": {
"type": "string",
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
]
},
"jobType": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
]
},
"description": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"dataSource": {
"type": "string",
"enum": [
"USER_EDITED",
"AI_PARSED"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"hiredCount": {
"type": "number"
},
"viewCount": {
"type": "number"
},
"applicationCount": {
"type": "number"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"additionalProperties": false
}🟡employer.update_job(apiKey, jobId, fields)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"jobId": {
"type": "string"
},
"fields": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"seniority": {
"type": "string",
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
]
},
"salary": {
"type": "string"
},
"location": {
"type": "string"
},
"workModel": {
"type": "string",
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
]
},
"jobType": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
]
},
"description": {
"type": "string"
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"referralBonus": {
"type": "number"
}
},
"additionalProperties": false
}
},
"required": [
"jobId",
"fields"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"employerId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
]
},
"title": {
"type": "string"
},
"seniority": {
"type": "string",
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
]
},
"salary": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"workModel": {
"type": "string",
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
]
},
"jobType": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
]
},
"description": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"dataSource": {
"type": "string",
"enum": [
"USER_EDITED",
"AI_PARSED"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"hiredCount": {
"type": "number"
},
"viewCount": {
"type": "number"
},
"applicationCount": {
"type": "number"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"additionalProperties": false
}⚪employer.publish_job(apiKey, jobId)
Transition a DRAFT job to PUBLISHED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in DRAFT.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"employerId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
]
},
"title": {
"type": "string"
},
"seniority": {
"type": "string",
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
]
},
"salary": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"workModel": {
"type": "string",
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
]
},
"jobType": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
]
},
"description": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"dataSource": {
"type": "string",
"enum": [
"USER_EDITED",
"AI_PARSED"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"hiredCount": {
"type": "number"
},
"viewCount": {
"type": "number"
},
"applicationCount": {
"type": "number"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"additionalProperties": false
}⚪employer.close_job(apiKey, jobId)
Transition a PUBLISHED job to CLOSED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in PUBLISHED.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"employerId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
]
},
"title": {
"type": "string"
},
"seniority": {
"type": "string",
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
]
},
"salary": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"workModel": {
"type": "string",
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
]
},
"jobType": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
]
},
"description": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"dataSource": {
"type": "string",
"enum": [
"USER_EDITED",
"AI_PARSED"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"hiredCount": {
"type": "number"
},
"viewCount": {
"type": "number"
},
"applicationCount": {
"type": "number"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"additionalProperties": false
}⚪employer.archive_job(apiKey, jobId)
Transition a CLOSED job to ARCHIVED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in CLOSED.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"job": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"employerId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
]
},
"title": {
"type": "string"
},
"seniority": {
"type": "string",
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL"
]
},
"salary": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"workModel": {
"type": "string",
"enum": [
"REMOTE",
"HYBRID",
"ON_SITE"
]
},
"jobType": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACT",
"FREELANCE"
]
},
"description": {
"type": [
"string",
"null"
]
},
"rawInput": {
"type": [
"string",
"null"
]
},
"dataSource": {
"type": "string",
"enum": [
"USER_EDITED",
"AI_PARSED"
]
},
"mustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"niceToHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"perks": {
"type": "array",
"items": {
"type": "string"
}
},
"responsibilities": {
"type": "array",
"items": {
"type": "string"
}
},
"qualifications": {
"type": "array",
"items": {
"type": "string"
}
},
"referralBonus": {
"type": [
"number",
"null"
]
},
"hiredCount": {
"type": "number"
},
"viewCount": {
"type": "number"
},
"applicationCount": {
"type": "number"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"publishedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"closedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"additionalProperties": false
}🔴employer.delete_job(apiKey, jobId)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional WorkorAI MCP key for in-session authentication when the MCP client was initialized anonymously."
},
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobId": {
"type": "string"
}
},
"additionalProperties": false
}🟡employer.search_candidates_for_job(apiKey, jobId, sort, page, pageSize, ...)
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).
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string"
},
"jobId": {
"type": "string"
},
"sort": {
"type": "string",
"enum": [
"bestMatch",
"newest"
]
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"tier": {
"type": "string",
"enum": [
"best",
"good",
"weak"
],
"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)."
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobId": {
"type": [
"string",
"null"
]
},
"reason": {
"type": "string",
"enum": [
"NOT_INDEXED",
"NO_CATEGORIES"
]
},
"page": {
"type": "object",
"properties": {
"total": {
"type": "number"
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"hasMore": {
"type": "boolean"
}
}
},
"tierCounts": {
"type": "object",
"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'.",
"properties": {
"matched": {
"type": "number"
},
"unmatched": {
"type": "number"
},
"best": {
"type": "number"
},
"good": {
"type": "number"
},
"weak": {
"type": "number"
}
}
},
"advisory": {
"type": "object",
"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.",
"properties": {
"code": {
"type": "string",
"enum": [
"EMPTY_BEST_REVIEW_MUST_HAVES"
]
},
"message": {
"type": "string",
"description": "Ready-to-relay plain-English advisory text."
}
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"displayName": {
"type": "string"
},
"avatarUrl": {
"type": [
"string",
"null"
]
},
"headline": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"seniority": {
"type": [
"string",
"null"
],
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL",
null
]
},
"summary": {
"type": [
"string",
"null"
]
},
"skills": {
"type": "array",
"items": {
"type": "string"
}
},
"matchScore": {
"type": "number"
},
"matchedMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"missingMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"applicationStatus": {
"type": "string",
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
]
},
"invitedAt": {
"type": "string",
"format": "date-time"
},
"matchExplanation": {
"type": "object",
"description": "White-box explanation of WHY this candidate ranks here — quote it to justify your shortlist on our data, not a black box.",
"properties": {
"score": {
"type": "number",
"description": "The 0-100 job-fit score (same as matchScore)."
},
"interviewScore": {
"type": [
"number",
"null"
],
"description": "Their overall interview score (0-100); null = no evaluated interview (use this, not verifiedSkills, to tell if they interviewed)."
},
"interviewCompleted": {
"type": "boolean",
"description": "false = the interview score comes from a partial/abandoned (early-exit) interview, already haircut-discounted — flag it when justifying."
},
"reliability": {
"type": "number",
"description": "How trustworthy the evidence is (0-100): a verified interview + corroborating GitHub/LinkedIn lift it."
},
"similarity": {
"type": "number",
"description": "Calibrated semantic similarity to the role (0-100)."
},
"mustCoverage": {
"type": "number",
"description": "Fraction (0-1) of the job's REQUIRED skills the candidate covers."
},
"matchedMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate HAS."
},
"missingMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate is MISSING — the gaps to probe."
},
"niceCoverage": {
"type": "number"
},
"matchedNice": {
"type": "array",
"items": {
"type": "string"
},
"description": "Nice-to-have skills the candidate has."
},
"missingNice": {
"type": "array",
"items": {
"type": "string"
}
},
"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."
},
"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."
},
"web3Bonus": {
"type": "number"
},
"reliabilitySource": {
"type": "string",
"description": "Which proof carried the reliability spine (e.g. 'interview', 'github')."
},
"reliabilityValue": {
"type": "number",
"description": "The winning spine value (0-100) before corroboration."
},
"rationale": {
"type": "string",
"description": "A ready-to-quote plain-English sentence narrating the score (coverage, proof, any haircut)."
}
}
}
}
}
}
},
"additionalProperties": false
}🟢employer.search_candidates_by_query(apiKey, query, page, pageSize)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string"
},
"query": {
"type": "string",
"maxLength": 512
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
}
},
"required": [
"query"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobId": {
"type": [
"string",
"null"
]
},
"query": {
"type": "string"
},
"reason": {
"type": "string",
"enum": [
"NOT_INDEXED",
"NO_CATEGORIES"
]
},
"page": {
"type": "object",
"properties": {
"total": {
"type": "number"
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
}
}
},
"tierCounts": {
"type": "object",
"properties": {
"matched": {
"type": "number"
},
"unmatched": {
"type": "number"
}
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"displayName": {
"type": "string"
},
"avatarUrl": {
"type": [
"string",
"null"
]
},
"headline": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"seniority": {
"type": [
"string",
"null"
],
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL",
null
]
},
"summary": {
"type": [
"string",
"null"
]
},
"skills": {
"type": "array",
"items": {
"type": "string"
}
},
"matchScore": {
"type": "number"
},
"matchedMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"missingMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"applicationStatus": {
"type": "string",
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
]
},
"invitedAt": {
"type": "string",
"format": "date-time"
}
}
}
}
},
"additionalProperties": false
}🟢employer.get_candidate(apiKey, userId)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string"
},
"userId": {
"type": "string"
}
},
"required": [
"userId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"candidate": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"displayName": {
"type": "string"
},
"avatarUrl": {
"type": [
"string",
"null"
]
},
"headline": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"seniority": {
"type": [
"string",
"null"
],
"enum": [
"INTERN",
"JUNIOR",
"MIDDLE",
"SENIOR",
"LEAD",
"PRINCIPAL",
null
]
},
"summary": {
"type": [
"string",
"null"
]
},
"skills": {
"type": "array",
"items": {
"type": "string"
}
},
"matchScore": {
"type": "number"
},
"matchedMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"missingMustHaveSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"applicationStatus": {
"type": "string",
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
]
},
"invitedAt": {
"type": "string",
"format": "date-time"
},
"interview": {
"type": [
"object",
"null"
],
"properties": {
"overallScore": {
"type": [
"number",
"null"
]
},
"completed": {
"type": "boolean",
"description": "false = partial/abandoned interview (early exit); the score is a haircut-discounted partial signal"
},
"summary": {
"type": [
"string",
"null"
]
},
"completedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"evaluatedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
}
}
},
"existingApplications": {
"type": "array",
"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.",
"items": {
"type": "object",
"properties": {
"applicationId": {
"type": "string"
},
"jobId": {
"type": "string"
},
"jobTitle": {
"type": "string"
},
"jobStatus": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"CLOSED",
"ARCHIVED"
]
},
"status": {
"type": "string",
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
]
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"invitedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"withdrawnAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"declinedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
}
}
}
}
}
}
},
"additionalProperties": false
}🟡employer.get_candidate_evidence(apiKey, jobId, userId)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string"
},
"jobId": {
"type": "string",
"description": "One of YOUR published vacancies — the evidence is scoped to it (must-linked facts use its required skills)."
},
"userId": {
"type": "string",
"description": "A candidate from search_candidates_for_job for THIS jobId. The interview evidence to explain your ranking."
}
},
"required": [
"jobId",
"userId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"evidence": {
"type": "object",
"properties": {
"candidateId": {
"type": "string"
},
"headline": {
"type": [
"string",
"null"
]
},
"resumeSummary": {
"type": [
"string",
"null"
]
},
"experienceYears": {
"type": [
"number",
"null"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"claim": {
"type": "string"
},
"factScore": {
"type": [
"number",
"null"
]
},
"mustLinked": {
"type": "boolean"
},
"qas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"question": {
"type": "string"
},
"answer": {
"type": "string"
}
}
}
}
}
}
},
"interview": {
"type": [
"object",
"null"
],
"properties": {
"interviewId": {
"type": "number"
},
"overallScore": {
"type": [
"number",
"null"
]
},
"completed": {
"type": "boolean",
"description": "false = partial/abandoned interview (early exit); the score is a haircut-discounted partial signal"
},
"summary": {
"type": [
"string",
"null"
]
}
}
},
"github": {
"type": [
"object",
"null"
],
"properties": {
"trustRank": {
"type": "number"
},
"web3Repos": {
"type": "number"
},
"mergedPrestigeLanguages": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"linkedin": {
"type": [
"object",
"null"
],
"properties": {
"historyCoherence": {
"type": "number"
},
"recognizedCerts": {
"type": "number"
}
}
},
"truncation": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}🟢employer.invite_candidate(apiKey, jobId, candidateUserId)
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).
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string"
},
"jobId": {
"type": "string"
},
"candidateUserId": {
"type": "string"
}
},
"required": [
"jobId",
"candidateUserId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"applicationId": {
"type": "string"
},
"status": {
"type": "string"
}
},
"additionalProperties": false
}🟢employer.list_applicants(apiKey, jobId)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string"
},
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobId": {
"type": "string"
},
"applicants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"applicationId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
]
},
"reviewStatus": {
"type": "string",
"enum": [
"NEW",
"REVIEWING",
"SHORTLISTED",
"REJECTED",
"HIRED"
]
},
"appliedAt": {
"type": "string",
"format": "date-time"
},
"source": {
"type": "string",
"enum": [
"APPLIED",
"INVITED"
],
"description": "APPLIED = candidate applied directly. INVITED = candidate accepted an invitation the employer had sent earlier (i.e. `invitedById` was set on the row)."
},
"candidate": {
"type": "object",
"properties": {
"userId": {
"type": "string"
},
"displayName": {
"type": "string"
},
"headline": {
"type": [
"string",
"null"
]
},
"avatarUrl": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"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."
},
"matchExplanation": {
"type": [
"object",
"null"
],
"description": "White-box explanation of WHY this candidate ranks here — quote it to justify your shortlist on our data, not a black box.",
"properties": {
"score": {
"type": "number",
"description": "The 0-100 job-fit score (same as matchScore)."
},
"interviewScore": {
"type": [
"number",
"null"
],
"description": "Their overall interview score (0-100); null = no evaluated interview (use this, not verifiedSkills, to tell if they interviewed)."
},
"interviewCompleted": {
"type": "boolean",
"description": "false = the interview score comes from a partial/abandoned (early-exit) interview, already haircut-discounted — flag it when justifying."
},
"reliability": {
"type": "number",
"description": "How trustworthy the evidence is (0-100): a verified interview + corroborating GitHub/LinkedIn lift it."
},
"similarity": {
"type": "number",
"description": "Calibrated semantic similarity to the role (0-100)."
},
"mustCoverage": {
"type": "number",
"description": "Fraction (0-1) of the job's REQUIRED skills the candidate covers."
},
"matchedMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate HAS."
},
"missingMust": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required skills the candidate is MISSING — the gaps to probe."
},
"niceCoverage": {
"type": "number"
},
"matchedNice": {
"type": "array",
"items": {
"type": "string"
},
"description": "Nice-to-have skills the candidate has."
},
"missingNice": {
"type": "array",
"items": {
"type": "string"
}
},
"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."
},
"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."
},
"web3Bonus": {
"type": "number"
},
"reliabilitySource": {
"type": "string",
"description": "Which proof carried the reliability spine (e.g. 'interview', 'github')."
},
"reliabilityValue": {
"type": "number",
"description": "The winning spine value (0-100) before corroboration."
},
"rationale": {
"type": "string",
"description": "A ready-to-quote plain-English sentence narrating the score (coverage, proof, any haircut)."
}
}
},
"interview": {
"type": "object",
"properties": {
"overallScore": {
"type": [
"number",
"null"
]
},
"completed": {
"type": "boolean",
"description": "false = partial/abandoned interview (early exit); the score is a haircut-discounted partial signal"
},
"summary": {
"type": [
"string",
"null"
]
}
}
},
"contact": {
"type": [
"object",
"null"
],
"description": "Non-null only when reviewStatus is SHORTLISTED or HIRED (contact gating).",
"properties": {
"email": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"linkedinUrl": {
"type": [
"string",
"null"
]
},
"githubUrl": {
"type": [
"string",
"null"
]
},
"websiteUrl": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
},
"additionalProperties": false
}🟡employer.set_review_status(apiKey, applicationId, reviewStatus)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string"
},
"applicationId": {
"type": "string"
},
"reviewStatus": {
"type": "string",
"enum": [
"NEW",
"REVIEWING",
"SHORTLISTED",
"REJECTED",
"HIRED"
]
}
},
"required": [
"applicationId",
"reviewStatus"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"applicationId": {
"type": "string"
},
"reviewStatus": {
"type": "string"
}
},
"additionalProperties": false
}⚪employer.get_applicant_detail(apiKey, applicationId)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string"
},
"applicationId": {
"type": "string"
}
},
"required": [
"applicationId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"detail": {
"type": "object",
"properties": {
"applicationId": {
"type": "string"
},
"jobId": {
"type": "string"
},
"jobTitle": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"INVITED",
"APPLIED",
"WITHDRAWN",
"DECLINED"
]
},
"reviewStatus": {
"type": "string",
"enum": [
"NEW",
"REVIEWING",
"SHORTLISTED",
"REJECTED",
"HIRED"
]
},
"appliedAt": {
"type": "string",
"format": "date-time"
},
"resumeAvailable": {
"type": "boolean"
},
"resume": {
"type": "object",
"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.",
"properties": {
"personalInfo": {
"type": "object",
"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.",
"properties": {
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"city": {
"type": "string"
},
"country": {
"type": "string"
},
"linkedinUrl": {
"type": "string"
},
"githubUrl": {
"type": "string"
},
"websiteUrl": {
"type": "string"
},
"summary": {
"type": "string"
},
"headline": {
"type": "string"
}
}
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"schoolName": {
"type": "string"
},
"degree": {
"type": "string"
},
"fieldOfStudy": {
"type": "string"
},
"startDate": {
"type": "string"
},
"endDate": {
"type": "string"
},
"grade": {
"type": "string"
}
}
}
},
"workExperience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"companyName": {
"type": "string"
},
"jobTitle": {
"type": "string"
},
"isCurrentRole": {
"type": "boolean"
},
"startDate": {
"type": "string"
},
"endDate": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
},
"projects": {
"type": "array",
"items": {
"type": "object",
"properties": {
"projectName": {
"type": "string"
},
"projectUrl": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
},
"publications": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"publisher": {
"type": "string"
},
"publicationDate": {
"type": "string"
},
"url": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
},
"certifications": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"issuingOrganization": {
"type": "string"
},
"issueDate": {
"type": "string"
},
"expirationDate": {
"type": "string"
},
"credentialUrl": {
"type": "string"
}
}
}
},
"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"
}
}
}
},
"languages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"languageName": {
"type": "string"
},
"proficiency": {
"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."
},
"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."
},
"interview": {
"type": [
"object",
"null"
],
"description": "Interview overview minus transcript. Use employer.get_applicant_transcript for the verbatim conversation.",
"properties": {
"overallScore": {
"type": [
"number",
"null"
]
},
"completed": {
"type": "boolean",
"description": "false = partial/abandoned interview (early exit); the score is a haircut-discounted partial signal"
},
"summary": {
"type": [
"string",
"null"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"summary": {
"type": "string"
},
"expectedAnswer": {
"type": "string"
},
"score": {
"type": [
"number",
"null"
]
},
"notes": {
"type": [
"string",
"null"
]
},
"qas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"question": {
"type": "string"
},
"answer": {
"type": "string"
},
"score": {
"type": [
"number",
"null"
]
},
"notes": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}
}
}
}
}
},
"additionalProperties": false
}🟢employer.get_applicant_transcript(apiKey, applicationId)
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.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string"
},
"applicationId": {
"type": "string"
}
},
"required": [
"applicationId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"applicationId": {
"type": "string"
},
"transcript": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string",
"enum": [
"assistant",
"user"
]
},
"text": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
}🟢employer.list_invitations(apiKey, jobId)
List the pending (INVITED) candidates on one of the employer's jobs — candidates who have been invited but have not yet accepted or declined.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Employer MCP API key"
},
"jobId": {
"type": "string",
"description": "The job to list invitations for"
}
},
"required": [
"jobId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobId": {
"type": "string"
},
"invitations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"applicationId": {
"type": "string"
},
"invitedAt": {
"type": "string",
"format": "date-time"
},
"candidate": {
"type": "object",
"properties": {
"userId": {
"type": "string"
},
"displayName": {
"type": "string"
},
"headline": {
"type": [
"string",
"null"
]
},
"avatarUrl": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
},
"additionalProperties": false
}🔴employer.cancel_invitation(apiKey, jobId, candidateUserId)
Cancel a pending invitation sent to a candidate. The invitation record is deleted; the employer can re-invite the same candidate later.
入力スキーマ
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Employer MCP API key"
},
"jobId": {
"type": "string",
"description": "The job the invitation belongs to"
},
"candidateUserId": {
"type": "string",
"description": "The candidate whose invitation to cancel"
}
},
"required": [
"jobId",
"candidateUserId"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"jobId": {
"type": "string"
},
"candidateUserId": {
"type": "string"
}
},
"additionalProperties": false
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 29 件
検証済みバージョンは記録されていませんツール 29 件