Add comment
Log a comment on a candidate with an Action, such as a connected call, and notes.
MCP tool vincere_write → add_comment
write Confirm
Adds a comment to the candidate's Activities tab for one candidate. action is the name as it appears in the Action dropdown, and only Actions activated in Goal Console under Activate in Action List are accepted. Only connected calls count toward goals. Pass job_id to link the comment to a job, which works only if the candidate has an active application for it. Colleagues see the comment, and Cotlet has no tool to delete it. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate id from list_candidates. |
| action string required | string | Action name exactly as in the Action dropdown, e.g. "Phone call | Candidate | Outbound | Connected". |
| notes string required | string | The note text. |
| job_id string | string | Link the comment to this job. Needs an active application. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "vincere_write",
"arguments": {
"operation": "add_comment",
"arguments": {
"candidate_id": "88214",
"action": "Phone call | Candidate | Outbound | Connected",
"notes": "Interested in contract work, available from 1 December. Send the job description on Friday."
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"comment_id": "C-90412",
"candidate_id": "88214",
"action": "Phone call | Candidate | Outbound | Connected",
"logged_at": "2026-10-22T16:40:00"
},
"isError": false
}