Create candidate
A new candidate record with name, contact fields and skills.
MCP tool jobdiva_write → create_candidate
write
Only first_name and last_name are required. Returns the new candidate_id. It does not check for duplicates, so run find_candidate first. It sends nothing and reaches no one, so it does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| first_name string required | string | First name. |
| last_name string required | string | Last name. |
| email string | string | Email address. |
| cell_phone string | string | Cell phone number. |
| city string | string | City. |
| state string | string | State. |
| skills string[] | string[] | Skills to put on the record. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "jobdiva_write",
"arguments": {
"operation": "create_candidate",
"arguments": {
"first_name": "Dana",
"last_name": "Whitfield",
"email": "dana.whitfield@example.com",
"cell_phone": "+1 312 555 0182",
"city": "Chicago",
"state": "IL",
"skills": [
"SQL",
"Python"
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"candidate_id": 5841230,
"name": "Dana Whitfield",
"status": "created"
},
"isError": false
}