Human resources · score_candidate_fit
Score candidate fit
Candidate fit for a role (0 to 100).
- Price
- plan AI usage
- Requirements
- No connector
- runs on platform keys
- Human approval
- No
- read or internal write
Input
| Field | Type | Description |
|---|---|---|
| candidateId | string | Candidate DB ID — fitScore is persisted to the candidate file |
| candidateEmail | string | Alternative to candidateId: the candidate email (file found in the pipeline, the most recent open one for this position) |
| resumeText | string | Raw resume/CV text. Optional when the candidate file already holds the resume text (create_candidate with resumeText). |
| appliedFor * | string | Job title or position name |
| requiredSkills | array | Required skills for the role (50% weight) |
| niceToHaveSkills | array | Nice-to-have skills (20% weight) |
| minYearsExperience | number | Minimum years of experience expected (30% weight) |
Call this tool
Through the HTTP API, or from the MCP server with the run meta-tool.
curl https://api.ezyagents.fr/gateway/v1/run \
-H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
-d '{"tool":"score_candidate_fit","input":{"candidateId":"…","candidateEmail":"…","resumeText":"…","appliedFor":"…"}}'$
run({ "tool": "score_candidate_fit", "input": {"candidateId":"…","candidateEmail":"…","resumeText":"…","appliedFor":"…"} })