Tag candidate
Add a tag to a candidate, or remove one.
MCP tool comeet_write → tag_candidate
write
Adds or removes one tag from Library > Tags on a candidate. A tag that does not exist is not created here, because only Owners and Admins add new tags. Tags are shared across all the candidate's hiring processes, so a change shows in every position. It reaches nobody and is undone with one call (action remove), so it does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate from list_candidates. |
| tag string required | string | Name of an existing tag. |
| action enum | enum | add (default) or remove. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "comeet_write",
"arguments": {
"operation": "tag_candidate",
"arguments": {
"candidate_id": "candidate_8c41d2",
"tag": "tag"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"candidate_id": "cand_7d21a9",
"tags": [
"silver medalist"
],
"changed": "added"
},
"isError": false
}